Skip to content

MAPPING.md

Latest commit

 

History

History
108 lines (97 loc) · 13 KB

MAPPING.md

File metadata and controls

108 lines (97 loc) · 13 KB

Kotlin -> TypeScript 対応表（MAPPING）

このファイルは、上流 Kotlin 実装と TypeScript 実装の 1:1 対応を管理するための台帳です。
目的は「再設計」ではなく「写経的移植」の追跡可能性を担保することです。

ルール

  • 上流の正本は upstream/utaformatix とする。
  • 上流ファイルの移動/rename が発生した場合、TS 側もまず同じ移動/rename を行う。
  • 実装改善や整理は、対応関係を壊さない範囲でのみ行う。
  • 本表は「追加・移動・削除」の都度更新する。
  • 本表に未登録の TS ファイルを増やさない。
  • 判別キー名は upstream 語彙を優先する。upstream に既存の判別語彙がない場合のみ kind を使う。
  • 命名（ファイル名・型名・関数名）は upstream 語彙を優先する。
  • TS 都合で命名を変更する場合は、対応表の notes に理由を必ず記録する。

上流固定情報

  • Upstream repository: https://github.com/sdercolin/utaformatix3.git
  • Pinned commit: f3c83354f57894492410bbc5ba03f7e97169c92c
  • Sync command: ./scripts/sync-upstream.sh <ref>

ディレクトリ対応（初期）

upstream path ts path scope status notes
upstream/utaformatix/core/src/main/kotlin/core/model src/core/model Core model in_progress Phase 1 着手済み
upstream/utaformatix/core/src/main/kotlin/core/util src/core/util Core utility planned Phase 1 で最小導入
upstream/utaformatix/core/src/main/kotlin/core/process src/core/process Format process in_progress 基礎 process + lyrics (mapping/japanese/chinese) を追加
upstream/utaformatix/core/src/main/kotlin/core/io src/core/io I/O, parser/writer in_progress Phase 2 着手済み
upstream/utaformatix/core/src/main/kotlin/core/exception src/core/exception Error model planned diagnostics 方針に合わせる
upstream/utaformatix/core/src/main/kotlin/core/external src/core/external External bindings planned 必要最小限で移植
upstream/utaformatix/core/src/main/resources/format_templates src/resources/format_templates Templates planned 実装進捗に応じて追加
upstream/utaformatix/core/src/main/resources/texts src/resources/texts Text resources planned 必要時のみ導入
upstream/utaformatix/src/jsMain/kotlin/ui (excluded) UI excluded 本リポジトリのスコープ外
upstream/utaformatix/src/jsMain/resources/images (excluded) UI assets excluded 本リポジトリのスコープ外
upstream/utaformatix/src/jsTest/kotlin tests/upstream-parity Parity tests in_progress process 系4本（pitch/lyrics/phonemes）は parity 済み

ファイル対応（着手時に追記）

upstream file ts file status notes
upstream/utaformatix/core/src/main/kotlin/core/model/Project.kt src/core/model/Project.ts in_progress MVP 版を追加
upstream/utaformatix/core/src/main/kotlin/core/model/Track.kt src/core/model/Track.ts in_progress MVP 版を追加
upstream/utaformatix/core/src/main/kotlin/core/model/Note.kt src/core/model/Note.ts in_progress MVP 版を追加
upstream/utaformatix/core/src/main/kotlin/core/model/Tempo.kt src/core/model/Tempo.ts in_progress default helper 追加
upstream/utaformatix/core/src/main/kotlin/core/model/TimeSignature.kt src/core/model/TimeSignature.ts in_progress display/ticks helper 追加
upstream/utaformatix/core/src/main/kotlin/core/model/Constants.kt src/core/model/Constants.ts in_progress 定数を写経
upstream/utaformatix/core/src/main/kotlin/core/model/ConversionParams.kt src/core/model/ConversionParams.ts in_progress default helper 追加
upstream/utaformatix/core/src/main/kotlin/core/model/ExportNotification.kt src/core/model/ExportNotification.ts in_progress sealed class を union 化
upstream/utaformatix/core/src/main/kotlin/core/model/ExportResult.kt src/core/model/ExportResult.ts in_progress Blob は暫定で unknown
upstream/utaformatix/core/src/main/kotlin/core/model/Feature.kt src/core/model/Feature.ts in_progress Feature/FeatureConfig を写経
upstream/utaformatix/core/src/main/kotlin/core/model/Pitch.kt src/core/model/Pitch.ts in_progress data 型を写経
upstream/utaformatix/core/src/main/kotlin/core/model/Format.kt src/core/model/Format.ts in_progress 初期は最小 enum のみ
upstream/utaformatix/core/src/main/kotlin/core/model/ImportParams.kt src/core/model/ImportParams.ts in_progress default helper 追加
upstream/utaformatix/core/src/main/kotlin/core/model/ImportWarning.kt src/core/model/ImportWarning.ts in_progress discriminated union（kind）
upstream/utaformatix/core/src/main/kotlin/core/model/JapaneseLyricsType.kt src/core/model/JapaneseLyricsType.ts in_progress enum を写経
upstream/utaformatix/core/src/main/kotlin/core/model/PhonemesMappingPreset.kt src/core/model/PhonemesMappingPreset.ts in_progress request 型を process 側に追加
upstream/utaformatix/core/src/main/kotlin/core/model/ProjectContainer.kt src/core/model/ProjectContainer.ts in_progress container 型を追加
upstream/utaformatix/core/src/main/kotlin/core/model/TickCounter.kt src/core/model/TickCounter.ts in_progress class を写経
upstream/utaformatix/core/src/main/kotlin/core/model/ValueTree.kt src/core/model/ValueTree.ts in_progress variant helper を写経
upstream/utaformatix/core/src/main/kotlin/core/external/ValueTree.kt src/core/external/ValueTree.ts in_progress external 型を最小導入
upstream/utaformatix/core/src/main/kotlin/core/util/Result.kt src/core/util/Result.ts in_progress runCatchingCancellable を追加
upstream/utaformatix/core/src/main/kotlin/core/util/ChainCall.kt src/core/util/ChainCall.ts in_progress runIf/runIfAllNotNull を追加
upstream/utaformatix/core/src/main/kotlin/core/util/TextUtil.kt src/core/util/TextUtil.ts in_progress 文字列 helper を写経
upstream/utaformatix/core/src/main/kotlin/core/util/EncodingUtil.kt src/core/util/EncodingUtil.ts in_progress encode/decode helper を写経
upstream/utaformatix/core/src/main/kotlin/core/util/XmlExtension.kt src/core/util/XmlExtension.ts in_progress DOM helper 群を写経（Error 例外化）
upstream/utaformatix/core/src/main/kotlin/core/util/MidiUtil.kt src/core/util/MidiUtil.ts in_progress MIDI 補助関数を写経
upstream/utaformatix/core/src/main/kotlin/core/external/Encoding.kt src/core/external/Encoding.ts in_progress external wrapper を最小導入
upstream/utaformatix/core/src/main/kotlin/core/io/UfData.kt src/core/io/UfData.ts in_progress parse/write + version warning + diagnostics + 欠落フィールド正規化を実装（tests/upstream-parity/ufdataRoundTrip.test.ts）
upstream/utaformatix/core/src/main/kotlin/core/io/Vsqx.kt src/core/io/Vsqx.ts in_progress VSQX parse/write + PIT/PBS control 対応 + round-trip/semantic テスト追加
upstream/utaformatix/core/src/main/kotlin/core/io/MusicXml.kt src/core/io/MusicXml.ts in_progress generate/preserve(no-op diff 0) + tie 結合/notations/direction 出力の parity 強化
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/VocaloidPartPitchData.kt src/core/process/pitch/VocaloidPitchConversion.ts in_progress VSQX PIT/PBS <-> internal pitch 変換を導入
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/CevioPitchConversion.kt src/core/process/pitch/CevioPitchConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/DeepVocalPitchConversion.kt src/core/process/pitch/DeepVocalPitchConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/OpenUtauPitchConversion.kt src/core/process/pitch/OpenUtauPitchConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/SynthVPitchConversion.kt src/core/process/pitch/SynthVPitchConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/UtauMode1PitchConversion.kt src/core/process/pitch/UtauMode1PitchConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/UtauMode2PitchConversion.kt src/core/process/pitch/UtauMode2PitchConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/UtauVibratoConversion.kt src/core/process/pitch/UtauVibratoConversion.ts verified tests/upstream-parity/pitchConversionsSmoke.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/lyrics/LyricsMapping.kt src/core/process/lyrics/LyricsMapping.ts verified tests/upstream-parity/lyricsMappingAndJapanese.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/lyrics/chinese/Conversion.kt src/core/process/lyrics/chinese/Conversion.ts verified tests/upstream-parity/lyricsMappingAndJapanese.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/lyrics/japanese/Analysis.kt src/core/process/lyrics/japanese/Analysis.ts verified tests/upstream-parity/lyricsMappingAndJapanese.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/lyrics/japanese/Cleanup.kt src/core/process/lyrics/japanese/Cleanup.ts verified tests/upstream-parity/lyricsMappingAndJapanese.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/lyrics/japanese/Conversion.kt src/core/process/lyrics/japanese/Conversion.ts verified tests/upstream-parity/lyricsMappingAndJapanese.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/lyrics/japanese/Words.kt src/core/process/lyrics/japanese/Words.ts verified tests/upstream-parity/lyricsMappingAndJapanese.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/Eval.kt src/core/process/Eval.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/Interpolation.kt src/core/process/Interpolation.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/LengthLimit.kt src/core/process/LengthLimit.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/ProjectZooming.kt src/core/process/ProjectZooming.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/Resampling.kt src/core/process/Resampling.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/RdpSimplification.kt src/core/process/RdpSimplification.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/core/src/main/kotlin/core/process/pitch/TimeUnitConversion.kt src/core/process/pitch/TimeUnitConversion.ts verified tests/upstream-parity/processCoreFixtureCases.test.ts で検証
upstream/utaformatix/src/jsTest/kotlin/process/pitch/TickTimeTransformerTest.kt tests/upstream-parity/tickTimeTransformer.test.ts verified upstream jsTest parity 済み
upstream/utaformatix/src/jsTest/kotlin/process/pitch/PitchCalculationTest.kt tests/upstream-parity/pitchCalculation.test.ts verified upstream jsTest parity 済み
upstream/utaformatix/src/jsTest/kotlin/process/lyrics/LyricsReplacementTest.kt tests/upstream-parity/lyricsReplacement.test.ts verified upstream jsTest parity 済み
upstream/utaformatix/src/jsTest/kotlin/process/phonemes/PhonemesMappingTest.kt tests/upstream-parity/phonemesMapping.test.ts verified upstream jsTest parity 済み
(derived) src/core/util/XmlComparison.ts in_progress XML 最小正規化比較（空白/属性順）
(derived) src/core/util/VsqxArchiveComparison.ts in_progress ZIP展開後エントリ比較ユーティリティ
(derived) src/core/model/assertProjectInvariants.ts in_progress Phase 1 不変条件チェック

ステータス定義

  • planned: まだ未着手
  • in_progress: 実装中
  • ported: 写経実装済み
  • verified: テストで上流同等を確認済み
  • excluded: スコープ外