deciphony-renderer 0.0.29 → 0.0.34

package/dist/standardStaff/enums/standardStaffSkinKeyEnum.d.ts

@@ -0,0 +1,154 @@
+/** 五线谱皮肤 key：一谱一套，仅用于 standardStaff */
+export declare enum StandardStaffSkinKeyEnum {
+    Measure = "measure",
+    Treble = "treble",
+    Alto = "alto",
+    Bass = "bass",
+    Tenor = "Tenor",
+    Treble_f = "treble_f",
+    Alto_f = "alto_f",
+    Bass_f = "bass_f",
+    Tenor_f = "tenor_f",
+    Sharp = "sharp",
+    Flat = "flat",
+    Double_sharp = "double_sharp",
+    Double_flat = "double_flat",
+    Natural = "natural",
+    Close_line = "close_line",
+    linked_close_line = "linked_close_line",
+    Single_barline = "single_barline",
+    Double_barline = "double_barline",
+    StartRepeat_barline = "startRepeat_barline",
+    EndRepeat_barline = "endRepeat_barline",
+    Dashed_barline = "dashed_barline",
+    Final_barline = "final_barline",
+    Start_end_repeat_barline = "start_end_repeat_barline",
+    Dotted_barline = "dotted_barline",
+    Reverse_barline = "reverse_barline",
+    Heavy_barline = "heavy_barline",
+    Heavy_double_barline = "heavy_double_barline",
+    linked_single_barline = "linked_single_barline",
+    linked_double_barline = "linked_double_barline",
+    linked_startRepeat_barline = "linked_startRepeat_barline",
+    linked_endRepeat_barline = "linked_endRepeat_barline",
+    linked_dashed_barline = "linked_dashed_barline",
+    linked_final_barline = "linked_final_barline",
+    linked_start_end_repeat_barline = "linked_start_end_repeat_barline",
+    linked_dotted_barline = "linked_dotted_barline",
+    linked_reverse_barline = "linked_reverse_barline",
+    linked_heavy_barline = "linked_heavy_barline",
+    linked_heavy_double_barline = "linked_heavy_double_barline",
+    C = "C",
+    C_sharp = "C_sharp",
+    D_flat = "D_flat",
+    D = "D",
+    E_flat = "E_flat",
+    E = "E",
+    F = "F",
+    F_sharp = "F_sharp",
+    G_flat = "G_flat",
+    G = "G",
+    A_flat = "A_flat",
+    A = "A",
+    B_flat = "B_flat",
+    B = "B",
+    C_flat = "C_flat",
+    '1_1' = "1_1",
+    '1_4' = "1_4",
+    '2_4' = "2_4",
+    '3_4' = "3_4",
+    '4_4' = "4_4",
+    '3_8' = "3_8",
+    '6_8' = "6_8",
+    NoteHead_1 = "noteHead_1",
+    NoteHead_2 = "noteHead_2",
+    NoteHead_3 = "noteHead_3",
+    NoteStem = "notestem",
+    NoteTail_1 = "noteTail_1",
+    NoteTail_2 = "noteTail_2",
+    NoteTail_3 = "noteTail_3",
+    NoteTail_4 = "noteTail_4",
+    NoteTail_5 = "noteTail_5",
+    NoteTail_6 = "noteTail_6",
+    NoteTail_1_r = "noteTail_1_r",
+    NoteTail_2_r = "noteTail_2_r",
+    NoteTail_3_r = "noteTail_3_r",
+    NoteTail_4_r = "noteTail_4_r",
+    NoteTail_5_r = "noteTail_5_r",
+    NoteTail_6_r = "noteTail_6_r",
+    Rest_1 = "rest_1",
+    Rest_2 = "rest_2",
+    Rest_3 = "rest_3",
+    Rest_4 = "rest_4",
+    Rest_5 = "rest_5",
+    Rest_6 = "rest_6",
+    Rest_7 = "rest_7",
+    Rest_8 = "rest_8",
+    Rest_9 = "rest_9",
+    AugmentationDot_1 = "augmentationDot_1",
+    AugmentationDot_2 = "augmentationDot_2",
+    AugmentationDot_3 = "augmentationDot_3",
+    AddLine_u = "addLine_u",// 上方的加线
+    AddLine_d = "addLine_d",// 下方的加线
+    Bracket = "bracket",// 标准连谱号
+    Brace = "brace",// 大括号
+    Square = "square",// 中括号
+    Repeat_coda = "repeat_coda",
+    Repeat_to_coda = "repeat_to_coda",
+    Repeat_segno = "repeat_segno",
+    Repeat_dc = "repeat_dc",
+    Repeat_ds = "repeat_ds",
+    Repeat_fine = "repeat_fine",
+    Repeat_dc_al_fine = "repeat_dc_al_fine",
+    Repeat_dc_al_coda = "repeat_dc_al_coda",
+    Repeat_ds_al_fine = "repeat_ds_al_fine",
+    Repeat_ds_al_coda = "repeat_ds_al_coda",
+    Accent_above = "acccent_above",
+    Staccato_above = "staccato_above",
+    Staccatissimo_above = "staccato_above",
+    Tenuto_above = "tenuto_above",
+    Loure_above = "loure_above",
+    Marcato_above = "marcato_above",
+    Accent_staccato_above = "accent_staccato_above",
+    Marcato_staccato_above = "marcato_staccato_above",
+    Marcato_tenuto_above = "marcato_tenuto_above",
+    Staccatissimo_stroke_above = "staccatissimo_stroke_above",
+    Staccatissimo_wedge_above = "staccatissimo_wedge_above",
+    Stress_above = "stress_above",
+    Tenuto_accent_above = "tenuto_accent_above",
+    Unstress_above = "unstress_above",
+    Open = "open",
+    Muted = "muted",
+    Harmonic = "harmonic",
+    Up_bow = "up_bow",
+    Down_bow = "down_bow",
+    Turn = "turn",
+    InvertedTurn = "invertedTurn",
+    Trill = "trill",
+    ShortTrill = "shortTrill",
+    Mordent = "mordent",
+    Arpeggio = "arpeggio",
+    Up_arpeggio = "up_arpeggio",
+    Down_arpeggio = "down_arpeggio",
+    Bracket_arpeggio = "bracket_arpeggio",
+    Up_arpeggio_straight = "up_arpeggio_straight",
+    Down_arpeggio_straight = "down_arpeggio_straight",
+    Dyn_PPP = "dyn_ppp",
+    Dyn_PP = "dyn_pp",
+    Dyn_P = "dyn_p",
+    Dyn_MP = "dyn_mp",
+    Dyn_MF = "dyn_mf",
+    Dyn_F = "dyn_f",
+    Dyn_FF = "dyn_ff",
+    Dyn_FFF = "dyn_fff",
+    Dyn_FP = "dyn_fp",
+    Dyn_PF = "dyn_pf",
+    Dyn_SF = "dyn_sf",
+    Dyn_SFZ = "dyn_sfz",
+    Dyn_SFF = "dyn_sff",
+    Dyn_SFFZ = "dyn_sffz",
+    Dyn_SFP = "dyn_sfp",
+    Dyn_RFZ = "dyn_rfz",
+    Dyn_RF = "dyn_rf",
+    Dyn_FZ = "dyn_fz"
+}

package/dist/standardStaff/render/affiliated/renderDoubleAffiliatedSymbol.d.ts

@@ -0,0 +1,3 @@
+import { RenderDoubleAffiliatedSymbolParams } from '../types';
+/** @deprecated 使用 render/affiliated 规则引擎 */
+export declare function renderDoubleAffiliatedSymbol(params: RenderDoubleAffiliatedSymbolParams): void;

package/dist/standardStaff/render/beam/beamSlope.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 计算一组连杠音符的符杠斜率。
+ *
+ * @param stemEnds 每个符干与符杠的接点，顺序为视觉左→右。
+ *                 up 方向取 stem.y（符干顶端），down 方向取 stem.y + stem.h（符干底端）。
+ * @param direction 符干方向，与符杠绘制方向一致。
+ *
+ * 算法分三步（按优先级）：
+ * 1. **水平符杠**：若中间某个符干的接点 y 与组内首/尾一样「极端」
+ *    （up：不高于首尾最低点；down：不低于首尾最高点），
+ *    则符杠强制水平（inclination = 0），锚点取该极端 y。
+ * 2. **首尾连线斜率**：用首尾接点算初始斜率，再逐个中间符干收紧斜率，
+ *    保证符杠不会从中间符干「穿出去」：
+ *    - 正斜率：以首符干为锚，斜率取 min，使中间符干接点不低于符杠；
+ *    - 负斜率：以尾符干为锚，斜率取 max，使中间符干接点不高于符杠。
+ * 3. **斜率上限**：将斜率限制在 ±BEAM_MAX_SLOPE_DEG 以内，
+ *    锚点用 pickExtremeStemEndForAnchor 取组内最靠外的一端。
+ */
+export declare function computeBeamSlope(stemEnds: Array<{
+    x: number;
+    y: number;
+}>, direction: 'up' | 'down'): {
+    inclination: number;
+    anchor: {
+        x: number;
+        y: number;
+    };
+};

package/dist/standardStaff/render/beam/processBeam.d.ts

@@ -0,0 +1,15 @@
+import { StandardStaffSkinPack, VDom } from '../../../types/common';
+import { NoteSymbol } from '../../../types/MusicScoreType';
+import { NodeIdMap } from '../types';
+export declare function processBeam(params: {
+    measure: {
+        notes: NoteSymbol[];
+    };
+    nodeIdMap: NodeIdMap;
+    vDoms: VDom[];
+    symbolVDomsLength: number;
+    skin: StandardStaffSkinPack;
+    measureHeight: number;
+    measureLineWidth: number;
+    skinName?: string;
+}): void;

package/dist/standardStaff/render/beam/processGraceBeam.d.ts

@@ -0,0 +1,15 @@
+import { StandardStaffSkinPack, VDom } from '../../../types/common';
+import { NoteSymbol } from '../../../types/MusicScoreType';
+import { NodeIdMap } from '../types';
+export declare function processGraceBeam(params: {
+    measure: {
+        notes: NoteSymbol[];
+    };
+    nodeIdMap: NodeIdMap;
+    vDoms: VDom[];
+    symbolVDomsLength: number;
+    skin: StandardStaffSkinPack;
+    measureHeight: number;
+    measureLineWidth: number;
+    skinName?: string;
+}): void;

package/dist/standardStaff/render/constants.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 渲染相关常量
+ */
+/** 变音符号与音符头之间的默认间距（与 measureHeight 的比值） */
+export declare const ACCIDENTAL_NOTE_GAP: number;
+/** 音符前谱号与音符头的间距（与 measureHeight 的比值） */
+export declare const CLEF_NOTE_GAP_RATIO: number;
+/** 附点符号与音符头之间的默认间距（与 measureHeight 的比值） */
+export declare const AUGMENTATION_DOT_GAP: number;
+/** 一节高度（一线或一间的距离）比例 */
+export declare const LINE_SPACING_RATIO: number;
+/** 符杠最大倾斜角度（度） */
+export declare const BEAM_MAX_SLOPE_DEG = 15;
+/** 最小符干高度相对小节高度的比例 */
+export declare const MIN_STEM_HEIGHT_RATIO: number;
+/** 符杠单线粗细比例 */
+export declare const BEAM_THICKNESS: number;
+/** 符杠多条线之间的空隙比例 */
+export declare const BEAM_LINE_SPACING: number;
+/** 符杠非全连时从 centerX 向两侧的缩放值，0.5 表示左右各收缩一半 */
+export declare const BEAM_PARTIAL_SCALE = 0.5;
+/** 符干 y 值偏移量 */
+export declare const STEM_Y_OFFSET = 0.05;

package/dist/standardStaff/render/grace/renderGraceStaff.d.ts

@@ -0,0 +1,25 @@
+import { VDom, StandardStaffSkinPack } from '../../../types/common';
+import { NoteSymbol, NotesInfo } from '../../../types/MusicScoreType';
+import { NodeIdMap } from '../types';
+/** 估算单条倚音 NotesInfo 占位宽度（视觉缩放后） */
+export declare function estimateGraceNotesInfoWidth(ni: NotesInfo, skin: StandardStaffSkinPack, measureHeight: number): number;
+export declare function graceBeforeWidth(graceNotes: NotesInfo[] | undefined, skin: StandardStaffSkinPack, measureHeight: number): number;
+export declare function graceAfterWidth(graceNotesAfter: NotesInfo[] | undefined, skin: StandardStaffSkinPack, measureHeight: number): number;
+export type RenderGraceStaffParams = {
+    ni: NotesInfo;
+    headAnchorX: number;
+    noteCenterY: (region: number) => number;
+    measureY: number;
+    measureHeight: number;
+    measureLineWidth: number;
+    measureWidth: number;
+    skin: StandardStaffSkinPack;
+    skinName: string;
+    zIndex: number;
+    note: NoteSymbol;
+    idMap: NodeIdMap;
+    out: VDom[];
+};
+export declare function renderGraceNotesInfo(params: RenderGraceStaffParams): void;
+export declare function renderGraceNotesBefore(graceNotes: NotesInfo[] | undefined, mainHeadX: number, ctx: Omit<RenderGraceStaffParams, 'ni' | 'headAnchorX'>): void;
+export declare function renderGraceNotesAfter(graceNotesAfter: NotesInfo[] | undefined, mainHeadX: number, mainHeadW: number, ctx: Omit<RenderGraceStaffParams, 'ni' | 'headAnchorX'>): void;

package/dist/standardStaff/render/musicScoreToVDom.d.ts

@@ -0,0 +1,2 @@
+export type { NodeIdMap } from './types';
+export { musicScoreToVDom } from './musicScoreToVDomImpl';

package/dist/standardStaff/render/musicScoreToVDomImpl.d.ts

@@ -0,0 +1,6 @@
+import { Skin, SlotConfig, VDom } from '../../types/common';
+import { MusicScore } from '../../types/MusicScoreType';
+export declare function musicScoreToVDom(musicScore: MusicScore, slotConfig?: SlotConfig, options?: {
+    skin?: Skin;
+    skinName?: string;
+}): VDom[];

package/dist/standardStaff/render/note/renderStemAndTail.d.ts

@@ -0,0 +1,29 @@
+import { StandardStaffSkinPack, VDom } from '../../../types/common';
+import { NoteSymbol } from '../../../types/MusicScoreType';
+import { NodeIdMap } from '../types';
+export type RenderStemAndTailParams = {
+    note: NoteSymbol;
+    headX: number;
+    headY: number;
+    headW: number;
+    headH: number;
+    measureY: number;
+    measureHeight: number;
+    measureWidth: number;
+    skin: StandardStaffSkinPack;
+    zIndex: number;
+    idMap: NodeIdMap;
+    chronaxie?: number;
+    direction?: 'up' | 'down';
+    stemTargetId?: string;
+    headCenterYOther?: number;
+    skinName?: string;
+    /** 倚音：符干在布局阶段调整 y/h；符尾用 VDom.scale 并做中心缩放 x/y 补偿 */
+    isGrace?: boolean;
+};
+/**
+ * 符干与符尾：chronaxie < 256 出符干，≤32 出符尾
+ */
+export declare function renderStemAndTail(params: RenderStemAndTailParams): VDom[];
+/** 倚音符干（布局 y/h）+ 符尾（VDom.scale + 中心缩放 x/y 补偿） */
+export declare function renderGraceStemAndTail(params: Omit<RenderStemAndTailParams, 'isGrace'>): VDom[];

package/dist/standardStaff/render/symbol/renderSymbol.d.ts

@@ -0,0 +1,7 @@
+import { VDom } from '../../../types/common';
+import { RenderSymbolParams } from '../types';
+export declare function renderSymbol(params: RenderSymbolParams): VDom[];
+/** 计算前置小节线在小节内的左边缘 x（clef_f + keySig_f + timeSig_f 之后，供连谱小节线 barline_f 定位） */
+export declare function getBarlineFXInMeasure(measure: import('../../../types/MusicScoreType').Measure, measureX: number, skin: import('../../../types/common').StandardStaffSkinPack): number;
+/** 计算后置小节线在小节内的左边缘 x（与 renderSymbol 中 rightParts 摆放一致，供连谱小节线 barline_b 定位） */
+export declare function getBarlineXInMeasure(measure: import('../../../types/MusicScoreType').Measure, measureX: number, measureWidth: number, skin: import('../../../types/common').StandardStaffSkinPack): number;

package/dist/standardStaff/render/types.d.ts

@@ -0,0 +1,23 @@
+import { VDom, VDomTagType } from '../../types/common';
+import { Measure, MusicScore } from '../../types/MusicScoreType';
+/** id -> 以 vDom.tag 为键的 VDom 对象，便于按 tag 查找同一 id 下的音符头/符干/符尾等 */
+export type NodeIdMap = Map<string, Partial<Record<VDomTagType, VDom>>>;
+export type RenderSymbolParams = {
+    measure: Measure;
+    measures: Measure[];
+    measureIndex: number;
+    measureX: number;
+    measureY: number;
+    measureWidth: number;
+    measureHeight: number;
+    measureLineWidth: number;
+    skin: import('../../types/common').StandardStaffSkinPack;
+    idMap: NodeIdMap;
+    skinName?: string;
+};
+export type RenderDoubleAffiliatedSymbolParams = {
+    musicScore: MusicScore;
+    VDoms: VDom[];
+    idMap: NodeIdMap;
+    skinName?: string;
+};

package/dist/standardStaff/render/utils/addLine.d.ts

@@ -0,0 +1,10 @@
+/** 加线 VDom 布局：横线画在皮肤垂直中心，与 center 缩放配合 */
+export declare function addLineBoxAt(lineY: number, centerX: number, skin: {
+    w: number;
+    h: number;
+}): {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};

package/dist/standardStaff/render/utils/note.d.ts

@@ -0,0 +1,26 @@
+import { Measure, NoteSymbol, NotesInfo } from '../../../types/MusicScoreType';
+import { StandardStaffSkinPack, Chronaxie } from '../../../types/common';
+import { BeamTypeEnum } from '../../../enums/musicScoreEnum';
+export type VoiceGroup = {
+    direction: 'up' | 'down';
+    notesInfo: NotesInfo[];
+    chronaxie: Chronaxie;
+    beamType: BeamTypeEnum;
+};
+/** 按符干方向分组：同方向多条 notesInfo 视为和弦 */
+export declare function getVoiceGroups(note: NoteSymbol): VoiceGroup[];
+export declare function getVoiceGroupForDirection(note: NoteSymbol, direction: 'up' | 'down'): VoiceGroup | undefined;
+/** 音符位取各声部方向中最大时值用于宽度系数 */
+export declare function getSlotChronaxie(note: NoteSymbol): number;
+/** 是否为休止符位 */
+export declare function isSlotRest(note: NoteSymbol): boolean;
+/** 休止符位时值 */
+export declare function getSlotRestChronaxie(note: NoteSymbol): number;
+/** widthRatio/widthRatioForMeasure 以四分音符(64)为 1；时值换算系数 */
+export declare function getChronaxieWidthCoefficient(chronaxie: number): number;
+/** 音符在小节内的宽度占比 */
+export declare function getNoteWidthRatio(note: NoteSymbol, skin: StandardStaffSkinPack, measureHeight?: number): number;
+/** 音符对小节在单谱表内宽度占比的系数 */
+export declare function getNoteWidthRatioForMeasure(note: NoteSymbol, skin: StandardStaffSkinPack, measureHeight?: number): number;
+/** 小节的宽度系数 */
+export declare function getMeasureWidthRatio(measure: Measure, skin: StandardStaffSkinPack): number;

package/dist/standardStaff/render/utils/skinKey.d.ts

@@ -0,0 +1,25 @@
+import { BarlineTypeEnum, BracketTypeEnum, ClefTypeEnum, KeySignatureTypeEnum, TimeSignatureTypeEnum, AccidentalTypeEnum } from '../../../enums/musicScoreEnum';
+import { StandardStaffSkinKeyEnum } from '../../enums/standardStaffSkinKeyEnum';
+import { AugmentationDot } from '../../../types/MusicScoreType';
+export declare function getBarlineSkinKey(barlineType: BarlineTypeEnum): StandardStaffSkinKeyEnum;
+/** 连谱小节线皮肤 key（BarlineTypeEnum → linked_*） */
+export declare function getLinkedBarlineSkinKey(barlineType: BarlineTypeEnum): StandardStaffSkinKeyEnum;
+/** 谱号类型 + 是否前置 */
+export declare function getClefSkinKey(clefType: ClefTypeEnum, isFront: boolean): StandardStaffSkinKeyEnum;
+/** 小节生效谱号：可传 noteIndex 表示该音符位前生效的谱号 */
+export declare function getClefForMeasure(measures: import('../../../types/MusicScoreType').Measure[], measureIndex: number, noteIndex?: number): ClefTypeEnum;
+/** 调号 y 偏移：皮肤按 treble 布局，中音/次中音 +5.5，低音 +11 */
+export declare function getKeySignatureYOffset(clefType: ClefTypeEnum, measureHeight: number, measureLineWidth: number): number;
+export declare function getKeySignatureSkinKey(type: KeySignatureTypeEnum): StandardStaffSkinKeyEnum;
+export declare function getTimeSignatureSkinKey(type?: TimeSignatureTypeEnum): StandardStaffSkinKeyEnum;
+/** 时值 chronaxie → 音符头皮肤 */
+export declare function getNoteHeadSkinKey(chronaxie: number): StandardStaffSkinKeyEnum;
+/** 时值 chronaxie → 休止符皮肤 */
+export declare function getRestSkinKey(chronaxie: number): StandardStaffSkinKeyEnum;
+/** 时值 chronaxie ≤32 → 符尾皮肤；direction 为 down 时用符尾倒（_r） */
+export declare function getNoteTailSkinKey(chronaxie: number, direction?: 'up' | 'down'): StandardStaffSkinKeyEnum;
+export declare function chronaxieToBeamLineCount(chronaxie: number): number;
+export declare function getAccidentalSkinKey(type: AccidentalTypeEnum): StandardStaffSkinKeyEnum;
+/** 连谱号类型 → 皮肤 key */
+export declare function getBracketSkinKey(type: BracketTypeEnum): StandardStaffSkinKeyEnum;
+export declare function getAugmentationDotSkinKey(augmentationDot: AugmentationDot): StandardStaffSkinKeyEnum;

package/dist/standardStaff/render/utils/slot.d.ts

@@ -0,0 +1,4 @@
+import { SlotConfig, SlotName } from '../../../types/common';
+export declare function getSlotH(config: SlotConfig | undefined, name: SlotName): number;
+export declare function getSlotW(config: SlotConfig | undefined, name: SlotName): number;
+export declare function getSlotZIndex(config: SlotConfig | undefined, name: SlotName): number;

package/dist/types/MusicScoreType.d.ts

@@ -0,0 +1,191 @@
+import { AccidentalTypeEnum, BarlineTypeEnum, BeamTypeEnum, BracketTypeEnum, ClefTypeEnum, DoubleMeasureAffiliatedSymbolNameEnum, DoubleNoteAffiliatedSymbolNameEnum, KeySignatureTypeEnum, MeasureEndRepeatEnum, MeasureStartRepeatEnum, MusicScoreTypeEnum, NoteSymbolTypeEnum, SingleMeasureAffiliatedSymbolNameEnum, SingleNoteAffiliatedSymbolNameEnum, TimeSignatureTypeEnum } from '../enums/musicScoreEnum';
+import { Chronaxie, Frame } from './common';
+export type MusicScore = {
+    id: string;
+    type: MusicScoreTypeEnum;
+    grandStaffs: GrandStaff[];
+    affiliatedSymbols: (DoubleNoteAffiliatedSymbol | DoubleMeasureAffiliatedSymbol)[];
+    width: number;
+    height: number;
+    topSpaceHeight: number;
+    title: string;
+    bpm: number;
+};
+export type GrandStaff = {
+    id: string;
+    staves: SingleStaff[];
+    uSpace: number;
+    dSpace: number;
+    /** 连谱模式：单谱表小节宽度一致，widthRatioForMeasure 按相同索引累加；小节数少的谱表与多者按列对齐 */
+    linkedStaff?: boolean;
+    bracket?: Bracket;
+} & Frame;
+export type Bracket = {
+    id: string;
+    type: BracketTypeEnum;
+    startSingleStaffIndex: number;
+} & Frame;
+export type SingleStaff = {
+    id: string;
+    measures: Measure[];
+    uSpaceO: number;
+    uSpaceI: number;
+    dSpaceI: number;
+    dSpaceO: number;
+} & Frame;
+export type Measure = {
+    id: string;
+    notes: NoteSymbol[] | NoteNumber[];
+    barline_f?: Barline;
+    barline_b?: Barline;
+    clef_f?: Clef;
+    clef_b?: Clef;
+    keySignature_f?: KeySignature;
+    keySignature_b?: KeySignature;
+    timeSignature_f?: TimeSignature;
+    timeSignature_b?: TimeSignature;
+    /** 小节前反复符号（Coda / Segno，最多一个） */
+    startRepeat?: MeasureStartRepeat;
+    /** 小节末反复符号（DC / DS / Fine 等，最多一个） */
+    endRepeat?: MeasureEndRepeat;
+    widthRatioForMeasure?: number;
+    affiliatedSymbols: (SingleMeasureAffiliatedSymbol)[];
+} & Frame;
+export type AugmentationDot = {
+    id: string;
+    count: 1 | 2 | 3;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;
+export type DoubleNoteAffiliatedSymbol = {
+    id: string;
+    name: DoubleNoteAffiliatedSymbolNameEnum;
+    startId: string;
+    endId: string;
+    data: {
+        slur?: {
+            relativeStartPoint: {
+                x: number;
+                y: number;
+            };
+            relativeEndPoint: {
+                x: number;
+                y: number;
+            };
+            relativeControlPoint: {
+                x: number;
+                y: number;
+            };
+            thickness: number;
+        };
+    };
+} & Frame;
+export type DoubleMeasureAffiliatedSymbol = {
+    id: string;
+    name: DoubleMeasureAffiliatedSymbolNameEnum;
+    startId: string;
+    endId: string;
+    data: {
+        volta?: {
+            text: string;
+            /** 盒子高度（× measureHeight），默认 0.5 */
+            heightRatio?: number;
+        };
+    };
+} & Frame;
+export type SingleNoteAffiliatedSymbol = {
+    id: string;
+    name: SingleNoteAffiliatedSymbolNameEnum;
+    data: Record<string, never>;
+} & Frame;
+export type SingleMeasureAffiliatedSymbol = {
+    id: string;
+    name: SingleMeasureAffiliatedSymbolNameEnum;
+    data: Record<string, never>;
+} & Frame;
+/** 小节前反复符号 */
+export type MeasureStartRepeat = {
+    id: string;
+    type: MeasureStartRepeatEnum;
+} & Frame;
+/** 小节末反复符号 */
+export type MeasureEndRepeat = {
+    id: string;
+    type: MeasureEndRepeatEnum;
+} & Frame;
+export type Barline = {
+    id: string;
+    barlineType: BarlineTypeEnum;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;
+export type Clef = {
+    id: string;
+    clefType: ClefTypeEnum;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;
+export type KeySignature = {
+    id: string;
+    type: KeySignatureTypeEnum;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;
+export type TimeSignature = {
+    id: string;
+    type: TimeSignatureTypeEnum;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;
+export type Accidental = {
+    id: string;
+    type: AccidentalTypeEnum;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;
+export type NoteSymbol = ({
+    id: string;
+    type: NoteSymbolTypeEnum;
+    notesInfo: NotesInfo[];
+    /** 时值 */
+    chronaxie?: Chronaxie;
+    /** 附点 */
+    augmentationDot?: AugmentationDot;
+    /** 单音符附属 */
+    affiliatedSymbols?: SingleNoteAffiliatedSymbol[];
+    clef?: Clef;
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame);
+export type NotesInfo = {
+    id: string;
+    direction: 'up' | 'down';
+    region: number;
+    chronaxie: Chronaxie;
+    beamType: BeamTypeEnum;
+    augmentationDot?: AugmentationDot;
+    graceNotes?: NotesInfo[];
+    graceNotesAfter?: NotesInfo[];
+    affiliatedSymbols: SingleNoteAffiliatedSymbol[];
+    accidental?: Accidental;
+} & Frame;
+export type NotesNumberInfo = {
+    id: string;
+    /** 0=休止符, 1-7=do re mi fa sol la si, 'X'=节奏音符（无音高，仅节奏） */
+    syllable: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 'X';
+    accidental?: Accidental;
+    /** 正数=音符上方的八度点（高八度），负数=下方的八度点（低八度），0=无 */
+    octaveDot: -5 | -4 | -3 | -2 | -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6;
+};
+export type NoteNumber = {
+    id: string;
+    chronaxie: Chronaxie;
+    notesInfo: NotesNumberInfo[];
+    augmentationDot?: AugmentationDot;
+    affiliatedSymbols: SingleNoteAffiliatedSymbol[];
+    beamType: BeamTypeEnum;
+    graceNotes?: NoteNumber[];
+    graceNotesAfter?: NoteNumber[];
+    widthRatio?: number;
+    widthRatioForMeasure?: number;
+} & Frame;