# IDX Editor モックの所感(画面仕様の入力)

モックを触った所感と、それを受けた議論の整理。**仕様ではない。**
画面仕様を一から作るときの入力にし、仕様へ反映したら消す。

## 方向が合意できたもの

### 並べ替え

- リストを主な操作の場にしない。並べ替えはキャンバス上のキーをドラッグ&ドロップして行う。
- ドロップで「挿入」と「入れ替え」を区別できるようにする。
    - 挿入: 位置nのキーを、位置iとi+1の間にドロップする。
        - n > i+1 のとき、キーは位置i+1に入り、元のi+1〜n-1は1つずつ後ろへずれる。
        - n < i のとき、キーは位置iに入り、元のn+1〜iは1つずつ前へずれる(通常のリストの移動と同じ)。
    - 入れ替え: 位置iのキーを位置nのキーの上にドロップすると、2つを入れ替える。他のキーは動かない。

### プリセット(一括の並べ替え)

- 種類ごとに個別のプリセットを作らず、3つの軸の組み合わせで表す。
    - 対象: 全体 / 選択範囲
    - 走査: 行優先 / 列優先 / 半身ごと(左手側を先に並べる) / 行ごとに左右交互 / マトリクス順(ELCのrow → col)
    - 向き: 通常 / 左右逆。半身ごとに指定できる(右手側だけ逆、など)
- 既存の定義(QMK `keyboard.json` の `layout[]`、VIA定義、KLEのキー順)からの取り込みは、上の組み合わせとは別の操作にする。
    既存基板の番号を変えずに引き継ぐためのもの。
- 行と列の判定: そろっている軸は座標でまとめ、ずれている軸は隣とのつながりでたどる。
    行と列の両方をつながりでたどろうとすると、互いが互いを必要として循環するため。
    - カラムスタッガード: 列はx座標でまとめる。行は、隣の列のキーのうちy座標が最も近いキーを同じ行とする。
        ロウスタッガードは縦横を入れ替える。格子配列はどちらでもよい。どちらの軸がそろっているかは座標から判定する。
    - 上から何番目かで数える方式は、端の列だけ行数が違う配列でずれる。
    - 隣り合う列の間の対応は1対1にする。行は対応のつながりで決まるため、1か所の誤りで2つの行が1つに合体する
        (同じ列の2キーが、隣の列の同じキーに対応した場合)。
    - 縦長のキー(縦2U、ISO Enter)は上端の行、横長のキー(スペースバーなど)は左端の列に属させる。外れたら手で直す。
    - 左右の半身の間の隙間も、隣り合う列の1組として対応付ける。左右対称の配置なら内側の列同士のy座標がそろうので、これで行が対応する。
    - 判定は完全でなくてよい。プリセットは `order` に一度書き込むだけで、外れても直せばよい。
        強いスタッガードで列ごと1行ずれる、回転した親指クラスター、左右非対称の配置などは、下のプレビューで直す。
- 適用前のプレビュー: 判定した行(列)をキャンバス上に表示し(同じ行を線で結ぶ、色分けする、など)、外れに気づけるようにする。
    列を選んで↑/↓で行の割り当てを1行ずらせる。割り当てはこの操作中だけの状態で、保存しない。
    - 適用後に `order` 上でずらす方式は取らない。`order` はどこからどこまでが1行分かを持たないため。
    - 残りの細かい修正は、選択範囲への適用とドラッグでの並べ替えで行う。

### なぞって連番を振る操作

- 後回しにする。プリセット・選択範囲への適用・ドラッグで足りないのは、行がはっきりしない配置(放射状など)に限られる見込み。
- 入り口として、「キーの列を受け取り、先頭キーの位置から連番で並べ直す」を共通の基本操作にする。
    プリセットは走査でキーの列を作って渡す。なぞる操作や「順にクリックして番号を振る」は、後から同じ操作に乗せる。
- 排他キー: `order` では既に別々の要素であり(`IDXレイヤー.md`「レイアウトバリアント」)、選択後に同時には残らない。
    そのため排他キー同士の前後はどの出力番号にも影響せず、決め方は任意でよい(保存データの差分が安定すれば足りる)。
    出力番号に効くのは、複数行にまたがるキー(縦2U、ISO Enter)を共通キーに対してどの行に置くか。下の「欠番」の項目と同じ問題として扱う。

## 要検討

- バリアント選択のドロップダウンの位置。左上に置く案。
- 欠番(番号の飛び)を作れないこと。現行仕様では、出力番号は `order` 内の位置で表し、飛ばない(`IDXレイヤー.md`「保存形式」)。
    - 場面: 4x4の右下(11, 15)をoption A、縦2UキーをBにする。2Uを `order` の末尾に置くと、Bでは12〜14が1つずつ前へずれる。
        「2Uを末尾にする」と「バリアント外のキーの番号をずらさない」を両立するには、11を欠番にするしかない。
    - 番号を詰める方式は2026-09-22に決めた(`journal/2026-09-22-idx-variant-output.md`)。番号の互換性はバリアントを選んだ構成ごとに扱い、
        別の構成で同じ番号が同じキーを指すことは保証しない。ただし、そのときの例は1対1の排他キー(ANSI/ISO)だけだった。
    - 今の仕様のままなら、2Uを11の位置に置けば12〜14はずれない(QMKのテンキーの+キーも上端の位置に置く慣習)。
    - 構成をまたいで番号が揃っていてほしい利用場面(手書きのkeymap.cを共有する、など)があるかを確認してから扱いを決める。

## モックの実装上の問題

作り直しで解消する前提で、原因の記録だけ残す。

- バリアント選択が見つけにくい: 右ペインの「出力構成」見出しの下、キーボード表示の上にあり、並びを編集するリストから離れている。