akari-video 1.2.0-beta.2 → 1.2.0-beta.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.2.0-beta.2",
+  "version": "1.2.0-beta.4",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。",
   "type": "module",
   "bin": {

package/vendor/docs/contract-2026-09-02-audio-clip-fx-v1.md

@@ -29,8 +29,8 @@ lint warning として無視する。legacy と v2 の投影は上表の値を
 lowcut は同一の 2 次 highpass を 2 段カスケードし、24 dB/oct の減衰特性で L1 ゲート
 （1 oct 下で 15 dB 以上の減衰）を満たすための裁定逸脱とする。
 
-denoise は `fft` なら `afftdn=nr=<12+strength*76>:nf=-30`、`nlm` なら
-`anlmdn=s=<0.00001+strength*0.0002>` とする。rubberband は `speed != 1` または
+denoise は `fft` なら `afftdn=nr=<6+strength*18>:nf=-50:tn=1`、`nlm` なら
+`anlmdn=s=<10^(-5+4*strength)>` とする。rubberband は `speed != 1` または
 `pitch_semitones != 0` のときだけ作る。全キーが既定なら入力もフィルタも追加せず、従来の
 filtergraph をバイト単位で維持する。
 
@@ -54,3 +54,21 @@ mtime・in/out・pad・recipe に加え、`atrim` を含む完全なフィルタ
 receipt の `provenance.audio.clip_fx` は `processed_items` と `filters` の件数を持つ。
 プレビューと書き出しで意図的に残す近似は、サイドカー FLAC の再圧縮とデコーダ／サンプル境界の
 差だけとする。
+
+## 2026-10-08 改訂 — ノイズ除去の対応式
+
+- `fft`: 旧 `afftdn=nr=<12+strength*76>:nf=-30` から、ノイズ床を追従する
+  `afftdn=nr=<6+strength*18>:nf=-50:tn=1` へ変更した。旧式の固定ノイズ床は声の
+  4〜8 kHz を 14〜18 dB、8〜16 kHz を 37〜50 dB 削ってこもらせていた。新式の声の
+  4〜8 kHz の減少は実測 0.7〜1.7 dB。騒がしい録音の 8〜16 kHz は `nr=12` で最大
+  5.9 dB、`nr=24` で最大 15.9 dB 減るため、`nr` の上限を 24 に抑える。
+- `nlm`: 旧 `anlmdn=s=<0.00001+strength*0.0002>` から、強さを広く使える対数式
+  `anlmdn=s=<10^(-5+4*strength)>`（`s` は 0.00001〜0.1）へ変更した。実測では声の
+  各帯域の変化は 0.4 dB 以内、弱い声の 8〜16 kHz の減少も 2.1 dB 以内。無音部の
+  ノイズは strength 0.5・SNR 38 dB で 21〜54 dB、strength 0.75・SNR 26 dB で
+  10〜36 dB、strength 1・SNR 19 dB で 5〜20 dB 減少した。処理時間は `fft` の約
+  10 倍だが、実時間の約 12 倍速で処理できた。
+- 宣言済みの denoise を持つプロジェクトは、プレビューと書き出しの音が変わる。`fft` は
+  こもりが消え、効きは控えめになる。`nlm` は同じ strength で効きが強くなる。
+  サイドカーの cache key にはフィルタ文字列が入るため、自動で作り直される。
+  おすすめは `nlm`・`0.75`。

package/vendor/docs/contract-2026-10-07-material-ranges-v0.md

@@ -6,8 +6,10 @@ The project stores non-destructive source selections in `.akari/material-ranges.
 { "version": 1, "ranges": { "assets/example.mp4": { "in": 2.5, "out": 8 } } }
 ```
 
-Keys are project-relative media paths. `in` and `out` are seconds in the original media; `out` is greater than `in`. Removing a selection deletes its key. A missing or malformed file means no selections. Updates preserve unrelated top-level keys and other material entries and replace the file by writing a temporary file and renaming it.
+Keys are project-relative media paths. `in` and `out` are seconds in the original media; `out` is greater than `in`. Handle changes round both values to 0.01 seconds before saving. Removing a selection deletes its key. A missing or malformed file means no selections. Updates preserve unrelated top-level keys and other material entries and replace the file by writing a temporary file and renaming it.
 
-The selected list strip exposes two handles. Its minimum width is the larger of one second and 24 pixels expressed in source seconds, capped by the media duration. Dragging one handle keeps the other fixed. Double-clicking the strip or pressing × clears the selection. Changes are saved after 150 ms.
+The selected list strip exposes two handles. Its minimum width is the larger of one second and 24 pixels expressed in source seconds, capped by the media duration. Dragging one handle keeps the other fixed. Pressing × clears the selection and announces the change; double-clicking the strip leaves the selection intact. An unselected strip shows an orange line at the saved range. Changes are saved after 150 ms.
 
-Material drag payloads and `akari.timeline.addMaterialAtPlayhead` requests may carry `in` and `out`. Drag placement uses the payload; playhead placement reads the saved range. Video and audio placement cap `out` at the media duration and use the full source when no valid range is present. `akari.materials.range.get` and `.set` expose the stored range to other views; changes emit `akari.materials.range.changed` with `{ relativePath, range }` on `window`. Range setters may include `source`; the event preserves it so a view can ignore echoes of its own changes.
+Material drag payloads and placement requests may carry `in` and `out`. The range applies when a person places material through panel drag and drop, the panel's Add to Timeline action, a drop on the central output preview, or placement from the material preview. Other callers of `akari.timeline.addMaterialAtPlayhead` and `akari.timeline.addMaterialAtOutputPoint` use the full source unless their request explicitly supplies a valid pair. Video and audio placement cap `out` at the media duration; if `in` reaches or exceeds the media duration, placement uses the full source. `akari.materials.range.get` and `.set` expose the stored range to other views. Changes emit `akari.materials.range.changed` on `window` with `{ relativePath, range, source }` when the setter supplies `source`; views can use it to ignore echoes of their own changes.
+
+Ranged audio is placed as an audio-track item by both playhead placement and output-preview drop, because the legacy `audio.sfx` form cannot store `in` and `out`.

package/vendor/packages/akari-launcher/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akari-video",
-  "version": "1.2.0-beta.2",
+  "version": "1.2.0-beta.4",
   "description": "AKARI Video launcher CLI — start an AI-edited video project from any directory: scaffold, connection check, then hand over to Claude Code (or opencode). AKARI Video を opencode や Claude Code で、どのディレクトリからでも始めるための `akari` ランチャー CLI。接続確認（doctor）→ 未セットアップならプロジェクト雛形を作成 → AI エージェントを起動する。外部 npm 依存ゼロ（Node.js 組み込みモジュールのみ）。 [akari-video npm vendor: bin/akari.mjs is reference-only. These CLI entrypoints are not included in the akari-video npm package. Use `akari doctor --json` and run the path reported in `render_cut.path`. Full installations provide it in a monorepo checkout, ~/.akari/app, /Applications/AKARI Video.app/Contents/Resources/packages, or %LOCALAPPDATA%\\Programs\\@akari-videoshell\\resources\\packages.]",
   "type": "module",
   "files": [

package/vendor/packages/edit-store/lib/edit-v2-item-write.d.ts

@@ -33,6 +33,11 @@ export type PreviewItemWriteCommand = ({
                 y: number;
             };
         }[];
+        element?: {
+            ref: string;
+            tag: string;
+            style: Record<string, string | null>;
+        };
     };
 } | {
     kind: 'layer';

package/vendor/packages/edit-store/lib/edit-v2-item-write.js

@@ -51,7 +51,7 @@ function resolvePreviewItemWriteBatch(editText, commands) {
     }
     let candidateText = editText;
     for (const command of commands) {
-        if (command.kind === 'overlay' && 'html' in command.patch) {
+        if (command.kind === 'overlay' && ('html' in command.patch || 'element' in command.patch)) {
             throw new Error('バッチでは外部 HTML 本文を書き込めません');
         }
         const resolved = resolvePreviewItemWrite(candidateText, command);
@@ -142,6 +142,40 @@ function resolveV2Write(parsed, command) {
         }
     };
     if (command.kind === 'overlay') {
+        if (command.patch.element) {
+            const { ref, tag, style } = command.patch.element;
+            if (item.source.kind !== 'html' || item.source.part) {
+                throw new Error(`要素の書き戻し対象ではありません: ${itemId}`);
+            }
+            if (['transform', 'html', 'text', 'duplicate', 'params', 'vars', 'xyKeyframes']
+                .some(key => key in command.patch)
+                || !/^[#.][^\s\[\]]+\[(0|[1-9]\d*)\]$/u.test(ref)
+                || !/^[a-z][a-z0-9-]*$/u.test(tag)
+                || !isRecord(style) || Object.keys(style).length === 0) {
+                throw new Error('要素の書き戻し指定が不正です');
+            }
+            const source = item.source;
+            const elements = { ...source.elements };
+            const current = { ...elements[ref]?.style };
+            for (const [key, value] of Object.entries(style)) {
+                if (!/^[a-z][a-z0-9-]*$/u.test(key) || (value !== null && typeof value !== 'string')) {
+                    throw new Error('要素の style が不正です');
+                }
+                if (value === null || value === '')
+                    delete current[key];
+                else
+                    current[key] = value;
+            }
+            if (Object.keys(current).length)
+                elements[ref] = { style: current };
+            else
+                delete elements[ref];
+            if (Object.keys(elements).length)
+                source.elements = elements;
+            else
+                delete source.elements;
+            return { candidateText: stringifyEdit(edit) };
+        }
         if ('text' in command.patch) {
             if (typeof command.patch.text !== 'string') {
                 throw new Error('部品の text は文字列である必要があります');

package/vendor/packages/edit-store/lib/tasks-store.js

@@ -16,7 +16,7 @@ const TASKS_VERSION = 0;
 const PATCH_FIELDS = new Set([
     'state', 'via', 'priority', 'rank', 'outcome', 'title', 'body', 'target', 'anchor',
     'ref', 'attachments', 'gate', 'undo', 'batchId', 'sentAt', 'sentTo', 'response',
-    'needsConfirm', 'updatedAt', 'orphaned', 'kind', 'targetDetail', 'evidence',
+    'needsConfirm', 'confirmedAt', 'updatedAt', 'orphaned', 'kind', 'targetDetail', 'evidence',
     'confidence', 'question', 'risk', 'route', 'dependsOn', 'origin', 'mergedFrom'
 ]);
 const isObject = (value) => value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -132,6 +132,10 @@ function applyTaskPatch(task, patch, actor) {
     for (const key of Object.keys(patch))
         if (!PATCH_FIELDS.has(key))
             throw new Error(`${key} は変更できません。`);
+    if (patch.needsConfirm === false && actor !== 'human')
+        throw new Error('案の承認は人が行ってください。');
+    if (task.needsConfirm === true && patch.needsConfirm === false && !patch.confirmedAt)
+        throw new Error('承認時刻が必要です。');
     if (isObject(task.ref) && task.ref.kind === 'annotation') {
         for (const key of ['title', 'body', 'target', 'anchor', 'via', 'ref']) {
             if (key in patch)
@@ -202,8 +206,9 @@ function deriveTasks(reviewJsonText, overlayDoc) {
         if (!found)
             used.push({ id: virtualId, source: 'annotation', state: 'unsent', createdAt: String(annotation.createdAt ?? '') });
         const status = annotation.status;
-        const state = status === 'addressed' ? 'review' : status === 'resolved' ? 'done'
-            : found?.state === 'sent' ? 'sent' : found?.state === 'done' && found.outcome === 'dismissed' ? 'done' : 'unsent';
+        const dismissed = found?.state === 'done' && found.outcome === 'dismissed';
+        const state = dismissed ? 'done' : status === 'addressed' ? 'review' : status === 'resolved' ? 'done'
+            : found?.state === 'sent' ? 'sent' : 'unsent';
         const text = typeof annotation.text === 'string' ? annotation.text : '';
         const derived = {
             ...found, id: virtualId, source: 'annotation', state,
@@ -217,9 +222,11 @@ function deriveTasks(reviewJsonText, overlayDoc) {
         };
         if (text.startsWith('[要確認]'))
             derived.gate = 'ask';
-        if (status === 'addressed')
+        if (dismissed)
+            derived.outcome = 'dismissed';
+        else if (status === 'addressed')
             derived.outcome = isObject(annotation.response) ? annotation.response.action ?? null : null;
-        if (status !== 'addressed' && found?.outcome !== 'dismissed')
+        else
             delete derived.outcome;
         if (isObject(annotation.response))
             derived.response = annotation.response;

package/vendor/packages/media-bin/src/preview-audio-sidecar.mjs

@@ -323,6 +323,9 @@ export function hasAudioClipFx(value = {}) {
 }
 
 // Single canonical clip-FX chain shared by render-cut and preview sidecars.
+// A fixed nf=-30 treated the voice's high frequencies as noise and muffled them.
+// Track the noise floor (tn=1) with a restrained nr instead.
+// NLM preserves the voice, so its strength spans a wider range logarithmically.
 export function buildAudioClipFxFilters(value = {}) {
   const normalized = normalizeAudioClipFx(value);
   const filters = [];
@@ -331,9 +334,9 @@ export function buildAudioClipFxFilters(value = {}) {
     filters.push(highpass, highpass);
   }
   if (normalized.denoise?.method === 'fft') {
-    filters.push(`afftdn=nr=${formatNumber(12 + normalized.denoise.strength * 76)}:nf=-30`);
+    filters.push(`afftdn=nr=${formatNumber(6 + normalized.denoise.strength * 18)}:nf=-50:tn=1`);
   } else if (normalized.denoise?.method === 'nlm') {
-    filters.push(`anlmdn=s=${formatNumber(0.00001 + normalized.denoise.strength * 0.0002)}`);
+    filters.push(`anlmdn=s=${formatNumber(10 ** (-5 + 4 * normalized.denoise.strength))}`);
   }
   if (normalized.speed !== 1 || normalized.pitchSemitones !== 0) {
     filters.push([

package/vendor/packages/media-bin/test/audio-clip-fx.test.mjs

@@ -1,7 +1,8 @@
 import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync, mkdtempSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { tmpdir } from 'node:os';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import test from 'node:test';
 
 import {
@@ -33,21 +34,56 @@ test('clip FX chain orders trim, two-stage lowcut, denoise, then rubberband', ()
     'asetpts=PTS-STARTPTS',
     'highpass=f=120:p=2',
     'highpass=f=120:p=2',
-    'afftdn=nr=57.6:nf=-30',
+    'afftdn=nr=16.8:nf=-50:tn=1',
     'rubberband=tempo=2:pitch=2:formant=preserved:pitchq=quality',
   ]);
 });
 
-test('fft denoise coefficient follows 12 + strength * 76', () => {
-  assert.deepEqual(buildAudioClipFxFilters({ denoise: { method: 'fft', strength: 0.25 } }), [
-    'afftdn=nr=31:nf=-30',
-  ]);
+test('fft denoise coefficient follows 6 + strength * 18 with a tracked noise floor', () => {
+  for (const [strength, nr] of [[0, '6'], [0.25, '10.5'], [0.6, '16.8'], [1, '24']]) {
+    assert.deepEqual(buildAudioClipFxFilters({ denoise: { method: 'fft', strength } }), [
+      `afftdn=nr=${nr}:nf=-50:tn=1`,
+    ]);
+  }
 });
 
-test('nlm denoise coefficient follows 0.00001 + strength * 0.0002', () => {
-  assert.deepEqual(buildAudioClipFxFilters({ denoise: { method: 'nlm', strength: 1 } }), [
-    'anlmdn=s=0.00021',
-  ]);
+test('nlm denoise coefficient follows 10^(-5 + 4 * strength) in decimal notation', () => {
+  for (const [strength, s] of [[0, '0.00001'], [0.5, '0.001'], [0.75, '0.01'], [1, '0.1']]) {
+    assert.deepEqual(buildAudioClipFxFilters({ denoise: { method: 'nlm', strength } }), [
+      `anlmdn=s=${s}`,
+    ]);
+  }
+});
+
+test('fft nr and nlm s increase monotonically with strength', () => {
+  for (const method of ['fft', 'nlm']) {
+    const coefficients = [0, 0.25, 0.5, 0.75, 1].map(strength => {
+      const filter = buildAudioClipFxFilters({ denoise: { method, strength } })[0];
+      return Number(filter.match(/(?:nr|s)=([\d.]+)/u)[1]);
+    });
+    for (let index = 1; index < coefficients.length; index += 1) {
+      assert.ok(coefficients[index] > coefficients[index - 1], `${method} at index ${index}`);
+    }
+  }
+});
+
+test('each new denoise filter differs from the old filter and produces a fresh sidecar key', () => {
+  const sourcePath = resolve(baseKeyInput.sourcePath);
+  const oldKey = oldFilter => createHash('sha1').update([
+    sourcePath, baseKeyInput.size, baseKeyInput.mtimeMs,
+    baseKeyInput.inSec, baseKeyInput.outSec, baseKeyInput.speed,
+    baseKeyInput.padBeforeSec, baseKeyInput.padAfterSec,
+    'atrim=start=1:end=5', 'asetpts=PTS-STARTPTS', oldFilter, PREVIEW_AUDIO_RECIPE,
+  ].join('|')).digest('hex');
+  for (const [method, strength, oldFilter] of [
+    ['fft', 0.6, 'afftdn=nr=57.6:nf=-30'],
+    ['nlm', 0.5, 'anlmdn=s=0.00011'],
+  ]) {
+    const clipFx = { denoise: { method, strength } };
+    const newFilter = buildAudioClipFxFilters(clipFx)[0];
+    assert.notEqual(newFilter, oldFilter);
+    assert.notEqual(previewAudioSidecarKey({ ...baseKeyInput, clipFx }), oldKey(oldFilter));
+  }
 });
 
 test('rubberband pitch uses 2^(semitones/12)', () => {

package/vendor/packages/overlay-runtime/src/element-geometry.d.ts

@@ -0,0 +1,8 @@
+export declare function elementAxes(center: {x:number;y:number}, xProbe:{x:number;y:number}, yProbe:{x:number;y:number}): {x:{x:number;y:number};y:{x:number;y:number}};
+export declare function elementPoint(geometry: any, horizontal:number, vertical:number): {x:number;y:number};
+export declare function elementHandlePoints(geometry:any, name:string): {dragged:{x:number;y:number};anchor:{x:number;y:number};signs:number[]} | null;
+export declare function elementBoxSize(width:number, height:number, name:string, delta:{x:number;y:number}, shift:boolean): {width:number;height:number};
+export declare function elementLocalDelta(screen:{x:number;y:number}, axes:any): {x:number;y:number};
+export declare function elementAngle(value:number, shift:boolean): number;
+export declare function elementHandleLayout(width:number, height:number): {hideHorizontalEdges:boolean;hideVerticalEdges:boolean;outsideX:boolean;outsideY:boolean;cornerOffsetX:number;cornerOffsetY:number;rotateTop:number};
+export declare function elementBoxCompanions(style:CSSStyleDeclaration, parentStyle:CSSStyleDeclaration | null, width:number | null, height:number | null): Record<string,string>;

package/vendor/packages/overlay-runtime/src/element-geometry.mjs

@@ -0,0 +1,75 @@
+// Geometry shared with the marked copy in interaction.js. Coordinates are client pixels.
+// BEGIN element-geometry
+function elementAxes(center, xProbe, yProbe) {
+  return { x: { x: xProbe.x - center.x, y: xProbe.y - center.y },
+    y: { x: yProbe.x - center.x, y: yProbe.y - center.y } };
+}
+
+function elementPoint(geometry, horizontal, vertical) {
+  return { x: geometry.center.x + horizontal * geometry.width * geometry.axes.x.x / 2
+      + vertical * geometry.height * geometry.axes.y.x / 2,
+    y: geometry.center.y + horizontal * geometry.width * geometry.axes.x.y / 2
+      + vertical * geometry.height * geometry.axes.y.y / 2 };
+}
+
+function elementHandlePoints(geometry, name) {
+  const signs = { n: [0, -1], e: [1, 0], s: [0, 1], w: [-1, 0],
+    nw: [-1, -1], ne: [1, -1], se: [1, 1], sw: [-1, 1] }[name];
+  if (!signs) return null;
+  return { dragged: elementPoint(geometry, ...signs),
+    anchor: elementPoint(geometry, -signs[0], -signs[1]), signs };
+}
+
+function elementBoxSize(width, height, name, delta, shift) {
+  const signs = elementHandlePoints({ center: { x: 0, y: 0 }, width, height,
+    axes: { x: { x: 1, y: 0 }, y: { x: 0, y: 1 } } }, name)?.signs;
+  if (!signs) return { width, height };
+  let nextWidth = signs[0] ? Math.max(4, width + signs[0] * delta.x) : width;
+  let nextHeight = signs[1] ? Math.max(4, height + signs[1] * delta.y) : height;
+  if (signs[0] && signs[1] && !shift) {
+    const ratio = Math.max(4 / width, 4 / height,
+      (width * nextWidth + height * nextHeight) / (width * width + height * height));
+    nextWidth = width * ratio;
+    nextHeight = height * ratio;
+  }
+  return { width: Math.round(nextWidth * 100) / 100,
+    height: Math.round(nextHeight * 100) / 100 };
+}
+
+function elementLocalDelta(screen, axes) {
+  const determinant = axes.x.x * axes.y.y - axes.y.x * axes.x.y;
+  if (Math.abs(determinant) < 1e-6) return { x: 0, y: 0 };
+  return { x: (screen.x * axes.y.y - screen.y * axes.y.x) / determinant,
+    y: (screen.y * axes.x.x - screen.x * axes.x.y) / determinant };
+}
+
+function elementAngle(value, shift) {
+  const angle = ((value + 180) % 360 + 360) % 360 - 180;
+  return Math.round((shift ? Math.round(angle / 15) * 15 : angle) * 100) / 100;
+}
+
+function elementHandleLayout(width, height) {
+  return { hideHorizontalEdges: width < 30, hideVerticalEdges: height < 30,
+    outsideX: width < 36, outsideY: height < 36,
+    cornerOffsetX: width < 36 ? 14 : 0, cornerOffsetY: height < 36 ? 14 : 0,
+    rotateTop: -32 };
+}
+
+function elementBoxCompanions(style, parentStyle, width, height) {
+  const result = {};
+  if (style.boxSizing !== 'border-box') result['box-sizing'] = 'border-box';
+  if (style.display === 'inline') result.display = 'inline-block';
+  if (['flex', 'inline-flex'].includes(parentStyle?.display) && style.flex !== '0 0 auto') result.flex = '0 0 auto';
+  if (width !== null) {
+    if (Number.parseFloat(style.minWidth) > width) result['min-width'] = '0px';
+    if (Number.parseFloat(style.maxWidth) < width) result['max-width'] = 'none';
+  }
+  if (height !== null) {
+    if (Number.parseFloat(style.minHeight) > height) result['min-height'] = '0px';
+    if (Number.parseFloat(style.maxHeight) < height) result['max-height'] = 'none';
+  }
+  return result;
+}
+// END element-geometry
+export { elementAxes, elementPoint, elementHandlePoints, elementBoxSize,
+  elementLocalDelta, elementAngle, elementHandleLayout, elementBoxCompanions };

package/vendor/packages/overlay-runtime/src/element-selection.d.ts

@@ -0,0 +1,6 @@
+export declare function elementAddress(root: Element, element: Element): string | null;
+export declare function selectableElement(root: Element, element: Element, outputRect?: DOMRect): boolean;
+export declare function nearestSelectableElement(root: Element, hit: Element, outputRect?: DOMRect): Element | null;
+export declare function firstSelectableElement(root: Element, outputRect?: DOMRect): Element | null;
+export declare function elementByAddress(root: Element, ref: string): Element | null;
+export declare function elementLabel(root: Element, element: Element): string;

package/vendor/packages/overlay-runtime/src/element-selection.mjs

@@ -0,0 +1,61 @@
+// Pure DOM selection rules. interaction.js carries this marked body verbatim.
+// BEGIN element-selection
+function isRuntimeElement(element) {
+  return element?.matches?.('script, style, template, [data-akari-hit-proxy], [data-akari-interaction], [data-akari-part-mask], .akari-u')
+    || Boolean(element?.closest?.('[data-akari-hit-proxy], [data-akari-interaction], [data-akari-part-mask]'));
+}
+
+function elementAddress(root, element) {
+  if (!root || !element || isRuntimeElement(element) || !root.contains(element)) return null;
+  const id = element.getAttribute('id');
+  const token = element.getAttribute('class')?.trim().split(/\s+/u).find(value => value && value !== 'akari-u');
+  if (!id && !token) return null;
+  const candidates = [root, ...root.querySelectorAll('*')].filter(candidate => !isRuntimeElement(candidate)
+    && (id ? candidate.getAttribute('id') === id
+      : candidate.getAttribute('class')?.split(/\s+/u).includes(token)));
+  const index = candidates.indexOf(element);
+  return index < 0 ? null : `${id ? '#' : '.'}${id || token}[${index}]`;
+}
+
+function selectableElement(root, element, outputRect) {
+  if (!root || !element || element === root || !root.contains(element) || isRuntimeElement(element)
+    || element.closest('svg') !== (element.tagName.toLowerCase() === 'svg' ? element : null)
+    || !elementAddress(root, element)) return false;
+  const rect = element.getBoundingClientRect();
+  if (!(rect.width > 1 && rect.height > 1)) return false;
+  for (let ancestor = element; ancestor && root.contains(ancestor); ancestor = ancestor.parentElement) {
+    const style = getComputedStyle(ancestor);
+    if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity) === 0) return false;
+  }
+  const replaced = ['img', 'video', 'canvas', 'svg'].includes(element.tagName.toLowerCase());
+  return replaced || !outputRect || rect.width < outputRect.width * 0.95
+    || rect.height < outputRect.height * 0.95;
+}
+
+function nearestSelectableElement(root, hit, outputRect) {
+  for (let element = hit; element && element !== root; element = element.parentElement) {
+    if (selectableElement(root, element, outputRect)) return element;
+  }
+  return null;
+}
+
+function firstSelectableElement(root, outputRect) {
+  return [root, ...root.querySelectorAll('*')].find(element => selectableElement(root, element, outputRect)) ?? null;
+}
+
+function elementByAddress(root, ref) {
+  if (!root || typeof ref !== 'string') return null;
+  return [root, ...root.querySelectorAll('*')].find(element => elementAddress(root, element) === ref) ?? null;
+}
+
+function elementLabel(root, element) {
+  const ref = elementAddress(root, element);
+  if (!ref) return '';
+  if (ref.startsWith('#')) return ref.slice(0, ref.lastIndexOf('['));
+  const name = ref.slice(1, ref.lastIndexOf('['));
+  const siblings = [...element.parentElement.children].filter(sibling => sibling.getAttribute('class')?.split(/\s+/u).includes(name));
+  return siblings.length > 1 ? `${name} ${siblings.indexOf(element) + 1}` : name;
+}
+// END element-selection
+export { isRuntimeElement, elementAddress, selectableElement, nearestSelectableElement,
+  firstSelectableElement, elementByAddress, elementLabel };

package/vendor/packages/overlay-runtime/src/interaction.css

@@ -117,6 +117,7 @@
 .akari-interaction-handle.is-w { top: 50%; left: 0; transform: translate(-50%, -50%); cursor: ew-resize; }
 .akari-interaction-selection-frame:not([data-akari-selection-kind="leaf"]) .is-edge { display: none; }
 .akari-interaction-selection-frame.is-telop .is-edge { display: none; }
+.akari-interaction-selection-frame.is-element-focus.is-telop .is-edge { display: block; }
 .akari-interaction-selection-frame.is-line .akari-interaction-handle:not(.is-line-start):not(.is-line-end):not(.akari-interaction-action) { display: none; }
 .akari-interaction-selection-frame:not(.is-line) .is-line-start,
 .akari-interaction-selection-frame:not(.is-line) .is-line-end { display: none; }