deciphony-renderer 0.0.29 → 0.0.34

package/dist/numberNotation/enums/numberNotationSkinKeyEnum.d.ts

@@ -0,0 +1,137 @@
+/** 简谱皮肤 key：一谱一套，仅用于 numberNotation */
+export declare enum NumberNotationSkinKeyEnum {
+    Measure = "measure",
+    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",
+    AugmentationDot_1 = "augmentationDot_1",
+    AugmentationDot_2 = "augmentationDot_2",
+    AugmentationDot_3 = "augmentationDot_3",
+    Number_0 = "number_0",
+    Number_1 = "number_1",
+    Number_2 = "number_2",
+    Number_3 = "number_3",
+    Number_4 = "number_4",
+    Number_5 = "number_5",
+    Number_6 = "number_6",
+    Number_7 = "number_7",
+    Number_X = "number_X",// 节奏音符（无音高）
+    ReduceLine_1 = "reduceLine_1",
+    ReduceLine_2 = "reduceLine_2",
+    ReduceLine_3 = "reduceLine_3",
+    ReduceLine_4 = "reduceLine_4",
+    ReduceLine_5 = "reduceLine_5",
+    ReduceLine_6 = "reduceLine_6",
+    addLine = "addLine",// 简谱高/低音点下方的横线
+    /** 八度点：音符上方=高八度，下方=低八度，每点表示一个八度 */
+    OctaveDot = "octaveDot",
+    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/numberNotation/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/numberNotation/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/numberNotation/render/beam/processBeam.d.ts

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

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

@@ -0,0 +1,41 @@
+/**
+ * 渲染相关常量
+ */
+/** 变音符号与音符头之间的默认间距（与 measureHeight 的比值） */
+export declare const ACCIDENTAL_NOTE_X_GAP = 0;
+/** 变音符号与小节顶部的默认间距（与 measureHeight 的比值） */
+export declare const ACCIDENTAL_NOTE_Y_OFFSET: number;
+/** 音符前谱号与音符头的间距（与 measureHeight 的比值） */
+export declare const CLEF_NOTE_GAP_RATIO: number;
+/** 附点符号与音符头之间的默认间距（与 measureHeight 的比值） */
+export declare const AUGMENTATION_DOT_X_GAP = 0;
+/** 减时线偏移y值（与 measureHeight 的比值） */
+export declare const REDUCE_LINE_Y_OFFSET = 0;
+/** 八度点：第一个点与音符（或减时线，当下方有减时线时）的距离（与 measureHeight 的比值） */
+export declare const OCTAVE_DOT_FIRST_OFFSET = 0;
+/** 八度点：相邻点之间的垂直间距（与 measureHeight 的比值） */
+export declare const OCTAVE_DOT_SPACING: number;
+/** 八度点：最后一粒点与相邻反向八度点的边距（防止下八度点与上八度点贴合） */
+export declare const OCTAVE_DOT_LAST_EDGE_MARGIN: number;
+/** 附点符号y值与音符中心点y值偏移（与 measureHeight 的比值） */
+export declare const AUGMENTATION_DOT_Y_OFFSET: 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;
+/** 符干 y 值偏移量 */
+export declare const STEM_Y_OFFSET = 0.05;
+/** 前置调号x偏移（与 measureHeight 的比值）*/
+export declare const KEY_SIGNATURE_F_X_OFFSET = 0;
+/** 前置调号y偏移（与 measureHeight 的比值）*/
+export declare const KEY_SIGNATURE_F_Y_OFFSET = 0;
+/** 后置调号x偏移（与 measureHeight 的比值）*/
+export declare const KEY_SIGNATURE_B_X_OFFSET = 0;
+/** 后置调号y偏移（与 measureHeight 的比值）*/
+export declare const KEY_SIGNATURE_B_Y_OFFSET = 0;

package/dist/numberNotation/render/grace/renderGraceNumber.d.ts

@@ -0,0 +1,22 @@
+import { VDom, NumberNotationSkinPack } from '../../../types/common';
+import { NoteNumber } from '../../../types/MusicScoreType';
+import { NodeIdMap } from '../types';
+/** 单条倚音 NoteNumber 占位宽度（视觉缩放后） */
+export declare function estimateGraceNoteNumberWidth(note: NoteNumber, skin: NumberNotationSkinPack, measureHeight: number): number;
+export declare function graceNoteNumberBeforeWidth(graceNotes: NoteNumber[] | undefined, skin: NumberNotationSkinPack, measureHeight: number): number;
+export declare function graceNoteNumberAfterWidth(graceNotesAfter: NoteNumber[] | undefined, skin: NumberNotationSkinPack, measureHeight: number): number;
+export type RenderGraceNumberCtx = {
+    measureY: number;
+    measureHeight: number;
+    skin: NumberNotationSkinPack;
+    skinName: string;
+    zIndex: number;
+    idMap: NodeIdMap;
+    out: VDom[];
+};
+/** 在 headX 渲染一条倚音（不含减时线；减时线由 processGraceReduceLines 第二遍连接） */
+export declare function renderGraceNoteNumberAt(note: NoteNumber, headX: number, ctx: RenderGraceNumberCtx): void;
+/** 前置倚音：index0 靠主音，整体向左扩散 */
+export declare function renderGraceNotesNumberBefore(graceNotes: NoteNumber[] | undefined, mainHeadX: number, ctx: RenderGraceNumberCtx): void;
+/** 后置倚音：向右扩散 */
+export declare function renderGraceNotesNumberAfter(graceNotesAfter: NoteNumber[] | undefined, mainHeadX: number, mainRefW: number, ctx: RenderGraceNumberCtx): void;

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

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

package/dist/numberNotation/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/numberNotation/render/note/renderStemAndTail.d.ts

@@ -0,0 +1,3 @@
+/**
+ * 简谱没有stem和tail
+ */

package/dist/numberNotation/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').NumberNotationSkinPack): number;
+/** 计算后置小节线在小节内的左边缘 x（与 renderSymbol 中 rightParts 摆放一致，简谱 suffixW 不含 keySignature_b） */
+export declare function getBarlineXInMeasure(measure: import('../../../types/MusicScoreType').Measure, measureX: number, measureWidth: number, skin: import('../../../types/common').NumberNotationSkinPack): number;

package/dist/numberNotation/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').NumberNotationSkinPack;
+    idMap: NodeIdMap;
+    skinName?: string;
+};
+export type RenderDoubleAffiliatedSymbolParams = {
+    musicScore: MusicScore;
+    VDoms: VDom[];
+    idMap: NodeIdMap;
+    skinName?: string;
+};

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

@@ -0,0 +1,16 @@
+import { Measure, NoteNumber } from '../../../types/MusicScoreType';
+import { NumberNotationSkinPack } from '../../../types/common';
+/** 简谱音符位时值 */
+export declare function getSlotChronaxie(note: NoteNumber): number;
+/** 是否为休止符位：syllable===0 */
+export declare function isSlotRest(note: NoteNumber): boolean;
+/** 休止符位时值 */
+export declare function getSlotRestChronaxie(note: NoteNumber): number;
+/** widthRatio/widthRatioForMeasure 以四分音符(64)为 1；时值换算系数 */
+export declare function getChronaxieWidthCoefficient(chronaxie: number): number;
+/** 音符在小节内的宽度占比 */
+export declare function getNoteWidthRatio(note: NoteNumber, skin: NumberNotationSkinPack, measureHeight?: number): number;
+/** 音符对小节在单谱表内宽度占比的系数 */
+export declare function getNoteWidthRatioForMeasure(note: NoteNumber, skin: NumberNotationSkinPack, measureHeight?: number): number;
+/** 小节的宽度系数 */
+export declare function getMeasureWidthRatio(measure: Measure, skin: NumberNotationSkinPack): number;

package/dist/numberNotation/render/utils/noteLayout.d.ts

@@ -0,0 +1,7 @@
+/** 简谱音符垂直布局（主音与倚音共用） */
+export declare function noteCenterY(measureY: number, measureHeight: number, stackIndex: number, noteH?: number, yOffset?: number): number;
+/** 和弦各声部八度点累加 y 偏移 */
+export declare function computeOctaveDotYOffsets(allNotes: {
+    syllable: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 'X';
+    octaveDot?: number;
+}[], dotH: number, fOff: number, spacing: number, lastEdgeMargin: number): number[];

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

@@ -0,0 +1,20 @@
+import { AccidentalTypeEnum, BarlineTypeEnum, BracketTypeEnum, ClefTypeEnum, KeySignatureTypeEnum, TimeSignatureTypeEnum } from '../../../enums/musicScoreEnum';
+import { NumberNotationSkinKeyEnum } from '../../enums/numberNotationSkinKeyEnum';
+import { AugmentationDot } from '../../../types/MusicScoreType';
+export declare function getBarlineSkinKey(barlineType: BarlineTypeEnum): NumberNotationSkinKeyEnum;
+/** 连谱小节线皮肤 key（BarlineTypeEnum → linked_*） */
+export declare function getLinkedBarlineSkinKey(barlineType: BarlineTypeEnum): NumberNotationSkinKeyEnum;
+/** 谱号类型 + 是否前置 简谱没有谱号*/
+/** 小节生效谱号：可传 noteIndex 表示该音符位前生效的谱号 */
+export declare function getClefForMeasure(measures: import('../../../types/MusicScoreType').Measure[], measureIndex: number, noteIndex?: number): ClefTypeEnum;
+export declare function getKeySignatureSkinKey(type: KeySignatureTypeEnum): NumberNotationSkinKeyEnum;
+export declare function getTimeSignatureSkinKey(type?: TimeSignatureTypeEnum): NumberNotationSkinKeyEnum;
+export declare function chronaxieToBeamLineCount(chronaxie: number): number;
+export declare function getAccidentalSkinKey(type: AccidentalTypeEnum): NumberNotationSkinKeyEnum;
+/** 连谱号类型 → 皮肤 key */
+export declare function getBracketSkinKey(type: BracketTypeEnum): NumberNotationSkinKeyEnum;
+export declare function getAugmentationDotSkinKey(augmentationDot: AugmentationDot): NumberNotationSkinKeyEnum;
+/** 简谱 syllable → 数字皮肤 key。0=休止符(Number_0)，1-7=音高，'X'=节奏音符(Number_X) */
+export declare function getSyllableSkinKey(syllable: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 'X'): NumberNotationSkinKeyEnum;
+/** 时值 chronaxie → 简谱减时线皮肤 key（32→1条线，16→2条…） */
+export declare function getReduceLineSkinKey(chronaxie: number): NumberNotationSkinKeyEnum;

package/dist/numberNotation/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/render/affiliated/engine.d.ts

@@ -0,0 +1,20 @@
+import { VDom } from '../../types/common';
+import { Measure, MusicScore, SingleNoteAffiliatedSymbol } from '../../types/MusicScoreType';
+import { NodeIdMap } from '../../standardStaff/render/types';
+export type RenderAffiliatedContext = {
+    VDoms: VDom[];
+    idMap: NodeIdMap;
+    skinName?: string;
+    /** 当前谱面的皮肤包（五线谱或简谱其一） */
+    skin?: Record<string, {
+        w: number;
+        h: number;
+    }>;
+    measureHeight?: number;
+};
+/** musicScore.affiliatedSymbols：双音符 / 双小节 */
+export declare function renderMusicScoreAffiliatedSymbols(musicScore: MusicScore, ctx: RenderAffiliatedContext): void;
+/** 单音符附属：在音符头渲染完成后调用 */
+export declare function renderSingleNoteAffiliatedSymbols(symbols: SingleNoteAffiliatedSymbol[] | undefined, noteHead: VDom, ctx: RenderAffiliatedContext): void;
+/** 单小节附属：measure.affiliatedSymbols */
+export declare function renderSingleMeasureAffiliatedSymbols(measure: Measure, measureX: number, measureY: number, measureWidth: number, measureHeight: number, ctx: RenderAffiliatedContext): void;

package/dist/render/affiliated/index.d.ts

@@ -0,0 +1 @@
+export { renderMusicScoreAffiliatedSymbols, renderSingleMeasureAffiliatedSymbols, renderSingleNoteAffiliatedSymbols, type RenderAffiliatedContext, } from './engine';

package/dist/render/graceNote.d.ts

@@ -0,0 +1,28 @@
+import { VDom } from '../types/common';
+/** 倚音相对主音符的缩放比例 */
+export declare const GRACE_NOTE_SCALE = 0.5;
+/** 为倚音 VDom 附加 scale，由 group.vue 以盒子中心缩放 skin 内容 */
+export declare function withGraceScale(v: VDom): VDom;
+/** 倚音间距：相对小节高度 measureHeight 的比例（主音与最近倚音、倚音之间） */
+export declare const GRACE_NOTE_SPACING_RATIO: number;
+/** 倚音减时线相对音符视觉底边的 y 偏移（与 measureHeight 的比值） */
+export declare const GRACE_REDUCE_LINE_Y_OFFSET = 0;
+/** 倚音八度点：第一个点与音符（或减时线）的距离（与 measureHeight 的比值） */
+export declare const GRACE_OCTAVE_DOT_FIRST_OFFSET = 0;
+/** 倚音八度点：相邻点垂直间距（约为普通音符一半，匹配 0.5 缩放） */
+export declare const GRACE_OCTAVE_DOT_SPACING: number;
+/** 倚音八度点：最后一粒点与相邻反向八度点的边距 */
+export declare const GRACE_OCTAVE_DOT_LAST_EDGE_MARGIN: number;
+export declare function graceNoteSpacing(measureHeight: number): number;
+/** 中心锚点缩放后 x 方向补偿，须写 (1-scale)，勿将 1-scale 化简为常数 */
+export declare function graceScaleCenterOffsetX(boxW: number, scale?: number): number;
+/** 中心锚点缩放后 y 方向补偿，须写 (1-scale) */
+export declare function graceScaleCenterOffsetY(boxH: number, scale?: number): number;
+/** 倚音符尾中心缩放补偿：符干向上→右/上偏移，符干向下→左/下偏移 */
+export declare function graceTailCenterOffset(tailW: number, tailH: number, stemDirection: 'up' | 'down', scale?: number): {
+    dx: number;
+    dy: number;
+};
+/** @deprecated 布局占位请用 scaledSpan；倚音 VDom 请设 scale 由 group.vue 缩放 */
+export declare function scaleSize(value: number, scale?: number): number;
+export { scaledSpan, visualTopFromBox, boxYForVisualBottom } from './vdomScale';

package/dist/render/repeat/renderMeasureRepeat.d.ts

@@ -0,0 +1,16 @@
+import { NumberNotationSkinPack, StandardStaffSkinPack, VDom } from '../../types/common';
+import { Measure } from '../../types/MusicScoreType';
+import { NodeIdMap } from '../../standardStaff/render/types';
+/** 反复符号默认贴齐小节顶边上方（相对 measureHeight 的比例） */
+export declare const REPEAT_MARK_ABOVE_RATIO: number;
+export type RenderMeasureRepeatParams = {
+    measure: Measure;
+    measureX: number;
+    measureY: number;
+    measureWidth: number;
+    measureHeight: number;
+    skin: StandardStaffSkinPack | NumberNotationSkinPack;
+    idMap: NodeIdMap;
+    skinName?: string;
+};
+export declare function renderMeasureRepeat(params: RenderMeasureRepeatParams): VDom[];

package/dist/render/repeat/repeatSkinKey.d.ts

@@ -0,0 +1,7 @@
+import { MeasureEndRepeatEnum, MeasureStartRepeatEnum } from '../../enums/musicScoreEnum';
+import { NumberNotationSkinKeyEnum } from '../../numberNotation/enums/numberNotationSkinKeyEnum';
+import { StandardStaffSkinKeyEnum } from '../../standardStaff/enums/standardStaffSkinKeyEnum';
+type RepeatSkinKey = StandardStaffSkinKeyEnum | NumberNotationSkinKeyEnum;
+export declare function getStartRepeatSkinKey(type: MeasureStartRepeatEnum): RepeatSkinKey;
+export declare function getEndRepeatSkinKey(type: MeasureEndRepeatEnum): RepeatSkinKey;
+export {};

package/dist/render/skinContent.d.ts

@@ -0,0 +1,12 @@
+import { VDom } from '../types/common';
+/** 皮肤 content 中 node.* 占位符 → 数值字符串 */
+export declare function replaceSkinNodeVars(content: string, node: Pick<VDom, 'w' | 'h'>): string;
+/**
+ * scaleAt(s, cx, cy) → translate(cx,cy) scale(s) translate(-cx,-cy)
+ * 锚点坐标支持 calc(...)，与 node.* 一样先替换再求值
+ */
+export declare function expandSkinScaleAt(content: string): string;
+/** 将 content 中 calc(公式) 替换为求值结果；支持一层括号，如 calc((node.h-1.8)) */
+export declare function evaluateSkinCalc(content: string): string;
+/** 皮肤 content 模板：node.* 替换 → calc(...) 求值 → scaleAt(...) 展开 */
+export declare function applySkinContentTemplate(content: string, node: Pick<VDom, 'w' | 'h'>): string;

package/dist/render/update.d.ts

@@ -0,0 +1,14 @@
+import { VDom } from '../types/common';
+/** 用于匹配同一渲染节点的稳定键 */
+export declare function vdomNodeKey(node: VDom): string;
+/** 比较影响 Group / 附属组件绘制的字段 */
+export declare function isVDomRenderEqual(a: VDom, b: VDom): boolean;
+/**
+ * 将新一轮 musicScoreToVDom 结果与当前 vDom 合并：未变化的节点保留原对象引用，
+ * 以便 Vue 跳过对应 Group 的更新。
+ */
+export declare function diffAndMergeVDom(current: VDom[], next: VDom[]): VDom[];
+/**
+ * 通过 updater 修改 vDom 后做 diff 合并（暴露给外部的 updateVDom API）
+ */
+export declare function applyVDomUpdate(current: VDom[], updater: (vDom: VDom[]) => VDom[]): VDom[];

package/dist/render/vdomScale.d.ts

@@ -0,0 +1,14 @@
+import { VDom } from '../types/common';
+/** 在 translate(x,y) 内的局部缩放 transform（scale 为 1 或未设置时返回空串）；锚点为盒子中心 */
+export declare function vdomScaleTransform(node: VDom): string;
+export declare function vdomOuterTransform(node: VDom): string;
+/** 布局占位：视觉缩放后的宽/高跨度 */
+export declare function scaledSpan(size: number, scale?: number): number;
+/** center 缩放：布局盒 (y,h) 的视觉顶边 y */
+export declare function visualTopFromBox(y: number, h: number, scale?: number): number;
+/** center 缩放：使视觉顶边落在 targetTop 时的布局盒 y */
+export declare function boxYForVisualTop(targetTop: number, h: number, scale?: number): number;
+/** center 缩放：布局盒 (y,h) 的视觉底边 y */
+export declare function visualBottomFromBox(y: number, h: number, scale?: number): number;
+/** center 缩放：使视觉底边落在 targetBottom 时的布局盒 y */
+export declare function boxYForVisualBottom(targetBottom: number, h: number, scale?: number): number;

package/dist/skins/defaultSkin.d.ts

@@ -0,0 +1,4 @@
+import { SkinPack } from '../types/common';
+export declare const defaultSkin: SkinPack;
+export declare const defaultSkinRed: SkinPack;
+export declare const defaultSkinBlue: SkinPack;