cozyclay 2.1.1 → 3.0.0

package/src/motion/generation.js

@@ -1,105 +0,0 @@
-// Pure request construction. The caller supplies one rolled seed and sampled
-// poses; no rig, store, random source, notification or network is touched here.
-import { StudioProtocolError, compileStudioBeats } from '../studio-agent-protocol.js';
-import { TIMELINE_FRAME_FPS as FPS } from '../timeline-fps.js';
-import { judgeAuthoredPath, alignArdyPath } from '../ardy/waypoints.js';
-import { planPosePin, PIN_BLOCKED } from '../ardy/pose-pin.js';
-import { blocksFromRequest, replayPayload, replayTruncated } from '../take-recipe.js';
-
-// Same half-open timeline schedule used by the editor: gaps carry the base
-// prompt, and spans shorter than three frames cannot carry a generation.
-function promptSchedule(clips, clipFrames, prompt) {
-  const segments = [];
-  let cursor = 0;
-  for (const clip of clips) {
-    const startFrame = Math.max(cursor, Math.min(clipFrames, clip.startFrame));
-    const endFrame = Math.max(startFrame, Math.min(clipFrames, clip.endFrame));
-    if (startFrame > cursor) segments.push({ startFrame: cursor, endFrame: startFrame, prompt });
-    if (endFrame - startFrame >= 3) segments.push({ startFrame, endFrame, prompt: clip.text.trim() || prompt });
-    cursor = Math.max(cursor, endFrame);
-    if (cursor >= clipFrames) break;
-  }
-  if (cursor < clipFrames) segments.push({ startFrame: cursor, endFrame: clipFrames, prompt });
-  if (!segments.length) segments.push({ startFrame: 0, endFrame: clipFrames, prompt });
-  return segments;
-}
-
-export function generationArgs({ characterId, source }) {
-  if (source.kind !== 'generate') throw generationRefusal('CAPABILITY_MISSING', 'Artifact reuse is handled by the retained artifact runtime.');
-  const schedule = compileStudioBeats(source);
-  return { characterId, durationSeconds: schedule.durationSeconds,
-    blocks: schedule.blocks.map((block, index) => ({ id: `generation-block-${index}`, text: block.text, startFrame: block.startFrame, endFrame: block.endFrameExclusive })),
-    ...(source.seed === undefined ? {} : { seed: source.seed }) };
-}
-
-export function generationRefusal(code, message, uiMessage = message) {
-  return Object.assign(new StudioProtocolError(code, message), { uiMessage });
-}
-
-export function buildGenerationRequest({ character, prompt, durationSeconds, seed,
-  waypoints = [], waypointMode = waypoints.length > 0, blocks = [], motion = null,
-  ikKeys = new Map(), startFromPose = false, posePlacement = 'start', frame = 0, poses = [],
-  preserveStrength = 0.5, recipe = null, fresh = false,
-}) {
-  const text = String(prompt ?? '').trim();
-  if (!text) throw generationRefusal('INVALID_ARGUMENT', 'Motion prompt is required - describe what the subject should do before generating');
-  if (text.length > 500) throw generationRefusal('INVALID_ARGUMENT', `Motion prompt is capped at 500 characters (currently ${text.length}) - shorten it before generating`);
-  const ikFrames = [...ikKeys.keys()].sort((a, b) => a - b);
-  const duration = motion && ikFrames.length ? motion.frames / motion.fps : Number(durationSeconds);
-  const clipFrames = Math.round(duration * FPS);
-  if (!Number.isFinite(duration) || duration < 1 || duration > 1200) throw generationRefusal('INVALID_RANGE', 'Duration must be between 1 and 1200 seconds');
-  if (!Number.isInteger(seed) || seed < 0 || seed > 2 ** 31 - 1) throw generationRefusal('INVALID_ARGUMENT', 'Seed must be an integer in 0..2147483647');
-  const warnings = [];
-  const clips = blocks.filter(clip => clip.text.trim()).sort((a, b) => a.startFrame - b.startFrame);
-  const segments = promptSchedule(clips, clipFrames, text), hasPromptSchedule = segments.length > 1;
-  const rootPath = waypointMode ? [{ frame: 0, x: character.x, z: character.z, heading: null }, ...waypoints] : [];
-  if (waypointMode) {
-    if (!waypoints.length) throw generationRefusal('INVALID_RANGE', 'Add at least one root destination before generating');
-    if (rootPath.length > 32) throw generationRefusal('INVALID_RANGE', 'The root path is capped at 32 sparse waypoints');
-    if (waypoints.some(point => point.frame <= 0 || point.frame >= clipFrames)) throw generationRefusal('INVALID_RANGE', `Root waypoint frames must stay inside 1..${clipFrames - 1}`);
-    const verdict = judgeAuthoredPath(rootPath, FPS, clipFrames, { chained: hasPromptSchedule });
-    if (verdict.errors.length) throw generationRefusal('INVALID_RANGE', `Not generated - ${verdict.errors[0]}`);
-    warnings.push(...verdict.warnings);
-  }
-  const longBlock = clips.length && segments.find(segment => segment.endFrame - segment.startFrame > 5 * FPS);
-  if (longBlock) throw generationRefusal('INVALID_RANGE', `Not generated - prompt blocks are capped at 5 s; split the ${((longBlock.endFrame - longBlock.startFrame) / FPS).toFixed(1)} s block`);
-  if (segments.some(segment => segment.prompt.length > 500)) throw generationRefusal('INVALID_ARGUMENT', 'Each motion prompt block is capped at 500 characters');
-  const aligned = waypointMode ? alignArdyPath(rootPath, character.rot, 32) : null;
-  const editedSegments = motion?.url && hasPromptSchedule
-    ? segments.filter(segment => ikFrames.some(at => at >= segment.startFrame && at < segment.endFrame)) : [];
-  const hasBlockEdits = editedSegments.length > 0;
-  const last = clipFrames - 1;
-  const poseFrame = posePlacement === 'end' ? last : posePlacement === 'middle' ? Math.round(last / 2)
-    : posePlacement === 'playhead' ? Math.max(0, Math.min(last, frame)) : 0;
-  const plan = planPosePin({ startFromPose, poseFrame, hasPromptSchedule, hasBlockEdits, waypointMode, ikFrames, clipFrames, segments, editedSegments });
-  if (plan.blockedBy === PIN_BLOCKED.SCHEDULE) warnings.push('Prompt blocks and a pose start cannot be combined - generating from the prompt alone.');
-  const body = { prompt: text, duration, posePin: plan.pin, seed };
-  let committedEditKeys = [];
-  if (plan.pin && !hasBlockEdits) body.poses = poses.map(entry => ({ ...entry }));
-  if (aligned) {
-    Object.assign(body, { waypoints: aligned.waypoints, rootMargin: 0.08, historyFrames: 4 * FPS });
-    if (hasPromptSchedule && !hasBlockEdits) body.segments = segments;
-  } else if (hasBlockEdits) {
-    const entries = plan.frames.map(at => ({ frame: at, tracks: [...(ikKeys.get(at)?.keys() ?? [])], pose: poses.find(entry => entry.frame === at)?.pose }));
-    committedEditKeys = entries.map(({ frame, tracks }) => ({ frame, tracks }));
-    body.motionEdit = { sourceMotion: motion.url, startFrame: Math.min(...editedSegments.map(segment => segment.startFrame)),
-      endFrame: Math.max(...editedSegments.map(segment => segment.endFrame)), contextBefore: 40, contextAfter: 20, edits: entries };
-  } else if (hasPromptSchedule) body.segments = segments;
-  const requestBlocks = blocksFromRequest(body, FPS), recipeBlocks = recipe?.blocks;
-  const durationFits = motion?.frames > 0 && Math.abs(motion.frames / FPS - duration) <= 1 / FPS + 1e-9;
-  const promptMatches = body.motionEdit !== undefined || (recipeBlocks?.length === requestBlocks.length && recipeBlocks.every((block, i) => block.prompt.trim() === requestBlocks[i].prompt.trim()));
-  if (!fresh && motion?.url && preserveStrength > 0 && durationFits && promptMatches && !body.segments) {
-    body.preserve = { sourceMotion: motion.url, strength: preserveStrength,
-      editRanges: editedSegments.map(({ startFrame, endFrame }) => {
-        const tracks = [...new Set(ikFrames.filter(at => at >= startFrame && at < endFrame).flatMap(at => [...ikKeys.get(at).keys()]))];
-        return { startFrame, endFrame, ...(tracks.length ? { tracks } : {}) };
-      }).filter(range => range.endFrame > range.startFrame) };
-  }
-  const replay = fresh || hasBlockEdits || !Number.isInteger(recipe?.seed) ? [] : replayPayload(recipe);
-  if (replay.length) {
-    body.replay = replay;
-    if (replayTruncated(recipe)) warnings.push(`Only ${replay.length} refinements can be replayed at once - the first ${replay.length} carry over`);
-  }
-  return { body, rootRotationDeg: aligned?.rotationDeg ?? character.rot, warnings,
-    constraintFrames: plan.frames, hasBlockEdits, hasPromptSchedule, committedEditKeys };
-}

package/src/motion-readiness-ui.jsx

@@ -1,67 +0,0 @@
-import { ko } from "./locale.js";
-
-export function motionReadinessMessage(state) {
-	switch (state) {
-		case "loading": return ko("Checking motion generation…", "모션 생성 연결 확인 중…");
-		case "ready": return ko("Ready for this motion request", "이 모션 요청을 실행할 수 있어요");
-		case "not_configured": return ko("No motion backend configured", "모션 백엔드가 설정되지 않았어요");
-		case "unsupported_route": return ko("This route cannot run the selected motion request", "현재 경로는 이 모션 요청을 지원하지 않아요");
-		default: return ko("The motion backend is unavailable", "모션 백엔드를 사용할 수 없어요");
-	}
-}
-
-export function MotionReadiness({ state, checking, onSetup, onRetry }) {
-	const unavailable = state === "unavailable";
-	return (
-		<div className="motion-readiness" data-state={state} aria-busy={checking || state === "loading"}>
-			<span role="status">{motionReadinessMessage(state)}</span>
-			{state !== "ready" && state !== "loading" && (
-				<button
-					type="button"
-					className="btn ghost"
-					data-testid="motion-readiness-action"
-					disabled={checking}
-					onClick={unavailable ? onRetry : () => onSetup()}
-				>
-					{checking ? ko("Checking…", "확인 중…")
-						: unavailable ? ko("Retry connection", "연결 다시 확인")
-							: state === "unsupported_route" ? ko("Switch route in Settings", "설정에서 경로 변경")
-								: ko("Open Settings", "설정 열기")}
-				</button>
-			)}
-		</div>
-	);
-}
-
-export function MotionSetup({ state, checking, onRetry }) {
-	const localStudio = ["localhost", "127.0.0.1", "[::1]"].includes(window.location.hostname);
-	const port = localStudio ? window.location.port || "5180" : "5180";
-	return (
-		<section className="motion-setup" data-testid="motion-setup" data-state={state} aria-label={ko("Motion generation setup", "모션 생성 설정")}>
-			<p role="status">{motionReadinessMessage(state)}</p>
-			<p>{ko(
-				"Motion generation is optional. Sample motion, camera editing and exports work without it. Your scene and prompt blocks stay here while you set it up.",
-				"모션 생성은 선택 사항이에요. 연결 없이도 샘플 모션, 카메라 편집, 내보내기를 쓸 수 있어요. 설정하는 동안 씬과 프롬프트 블록은 그대로 유지됩니다.",
-			)}</p>
-			<p>{ko("Use an existing motion generation host, then restart your local launcher with:", "기존 모션 생성 호스트를 사용하려면 로컬 실행기에 다음 환경변수를 설정하세요:")}</p>
-			<code>{`CCLAY_KIMODO_HOST=user@your-gpu-box npx cozyclay --port ${port} --no-open`}</code>
-			<p>{localStudio ? ko(
-				"Keep this tab open. After restarting the bridge on the same port, retry the connection below.",
-				"이 탭은 열어 두세요. 같은 포트에서 브리지를 다시 시작한 뒤 아래에서 연결을 확인하세요.",
-			) : ko(
-				"New generation runs in the local Studio. Save your project here, then open that file in the local Studio to carry over your edits.",
-				"새 모션 생성은 로컬 Studio에서 실행해요. 여기서 프로젝트를 저장하고 로컬 Studio에서 그 파일을 열면 편집 내용을 이어갈 수 있어요.",
-			)}</p>
-			<p>{ko(
-				"Local MLX/cpp supports one unconstrained prompt. Sequencing, pinned poses, paths and preserve need the CUDA/SSH route. Line editing needs a configured line-edit route.",
-				"로컬 MLX/cpp는 제약 없는 단일 프롬프트를 지원해요. 블록 연결, 포즈 고정, 경로, 테이크 보존에는 CUDA/SSH가 필요하고, 라인 편집에는 라인 편집 경로 설정이 필요해요.",
-			)}</p>
-			<a href="https://github.com/NomaDamas/CozyClay/blob/main/docs/kimodo-setup.md" target="_blank" rel="noreferrer">
-				{ko("Motion generation setup and route guide", "모션 생성 설정 및 경로 안내")}
-			</a>
-			<button type="button" className="btn" data-testid="motion-health-retry" disabled={checking} onClick={onRetry}>
-				{checking ? ko("Checking…", "확인 중…") : ko("Recheck connection", "연결 다시 확인")}
-			</button>
-		</section>
-	);
-}

package/src/motion-readiness.js

@@ -1,40 +0,0 @@
-import { motionPreflightReason } from "./analytics.js";
-
-/** Return the line-edit capability advertised by the structured health payload. */
-export function hasLineEditCapability(health) {
-	if (health?.ok !== true) return false;
-	const capabilities = health.capabilities ?? health.features;
-	return Array.isArray(capabilities) ? capabilities.includes("lineEdit") : capabilities?.lineEdit === true;
-}
-
-/**
- * Decide whether the hosted demo take may be seeded onto the stage. The seed
- * is for a session with no bridge (the hosted demo). The first healthy probe
- * latches `bridgeSeenOk`: after it, a failed probe is a blip, not "no bridge",
- * and must never load the demo take onto the character.
- */
-export function demoSeedGate(health, bridgeSeenOk = false) {
-	const seenOk = bridgeSeenOk || Boolean(health?.ok);
-	return { bridgeSeenOk: seenOk, seed: Boolean(health) && !health.ok && !seenOk };
-}
-
-/**
- * Derive the generation affordance state from bridge health and request shape.
- * Health is deliberately interpreted through the analytics preflight contract;
- * error prose is never used to classify a route.
- */
-export function motionReadiness(health, options = {}) {
-	if (health === null || health === undefined) return "loading";
-	const lineEditSupported = Object.prototype.hasOwnProperty.call(options, "lineEditSupported")
-		? options.lineEditSupported === true
-		: hasLineEditCapability(health);
-	const reason = motionPreflightReason(health, {
-		body: options.body ?? {},
-		lineEditSupported,
-	});
-	if (reason === null) return "ready";
-	if (reason === "unconfigured") return "not_configured";
-	if (reason === "unreachable") return "unavailable";
-	if (reason === "unsupported_route") return "unsupported_route";
-	return "unavailable";
-}

package/src/motion-resources.js

@@ -1,177 +0,0 @@
-/**
- * Motion resources: a validated ARDY npz archive packaged so a `.cclayproject`
- * can carry the take itself instead of a bridge URL that dies with the run.
- *
- * A record is content-addressed: `motionId` is the SHA-256 of the raw archive
- * bytes, so a scene's `character.motionRef.motionId` names the exact bytes it
- * was authored against. Decoding re-derives the hash and re-runs the full npz
- * validation, so a tampered or truncated record is rejected before playback
- * ever sees it. Every rejection is an NpzError carrying a machine-readable
- * `code` (bad-base64 | length-mismatch | hash-mismatch | bad-npz | too-large).
- *
- * No React, no three.js, no fetch: this module runs identically in the
- * browser and under Node (Web Crypto + atob/btoa are available in both).
- */
-
-import { decodeMotionNpz, NpzError } from "./ardy/npz.js";
-
-/** Per-motion raw archive cap; matches the npz reader's download cap. */
-export const MOTION_MAX_BYTES = 192 * 1024 * 1024;
-
-const MOTION_ID_RE = /^[0-9a-f]{64}$/i;
-const BASE64_RE = /^[A-Za-z0-9+/]*={0,2}$/;
-
-function codedError(code, message) {
-	const error = new NpzError(message);
-	error.code = code;
-	return error;
-}
-
-function asBytes(value) {
-	if (value instanceof Uint8Array) return value;
-	if (value instanceof ArrayBuffer) return new Uint8Array(value);
-	if (ArrayBuffer.isView(value)) return new Uint8Array(value.buffer, value.byteOffset, value.byteLength);
-	throw new TypeError("motion bytes must be a Uint8Array or ArrayBuffer");
-}
-
-/** Lowercase hex SHA-256 of raw bytes — the motionId of an archive. */
-export async function sha256Hex(value) {
-	const bytes = asBytes(value);
-	const subtle = globalThis.crypto?.subtle;
-	if (!subtle) throw new Error("Web Crypto SHA-256 is unavailable");
-	const digest = await subtle.digest("SHA-256", bytes);
-	let hex = "";
-	for (const byte of new Uint8Array(digest)) hex += byte.toString(16).padStart(2, "0");
-	return hex;
-}
-
-function bytesToBase64(bytes) {
-	let binary = "";
-	for (let offset = 0; offset < bytes.length; offset += 0x8000) {
-		binary += String.fromCharCode(...bytes.subarray(offset, offset + 0x8000));
-	}
-	return btoa(binary);
-}
-
-function base64ToBytes(text) {
-	if (typeof text !== "string" || text.length % 4 !== 0 || !BASE64_RE.test(text)) {
-		throw codedError("bad-base64", "motion resource data is not valid base64");
-	}
-	let binary;
-	try {
-		binary = atob(text);
-	} catch {
-		throw codedError("bad-base64", "motion resource data is not valid base64");
-	}
-	const bytes = new Uint8Array(binary.length);
-	for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
-	return bytes;
-}
-
-/** Decoded byte count of a base64 string, without decoding it. */
-function base64DecodedLength(text) {
-	let padding = 0;
-	if (text.endsWith("==")) padding = 2;
-	else if (text.endsWith("=")) padding = 1;
-	return (text.length / 4) * 3 - padding;
-}
-
-const META_KEYS = ["prompt", "sourceUrl", "personScale", "createdAt"];
-
-/**
- * Validate an npz archive and package it as a project motion record:
- * { motionId, encoding: "base64", data, bytes, frames, fps, name?, meta? }.
- *
- * `meta` may carry `name` (kept top-level) and prompt / sourceUrl /
- * personScale / createdAt (kept under `meta`). personScale defaults to the
- * value the archive itself carries so the record is self-describing.
- */
-export async function encodeMotionResource(value, meta = {}) {
-	const bytes = asBytes(value);
-	if (bytes.byteLength > MOTION_MAX_BYTES) {
-		throw codedError("too-large", `motion resource is ${bytes.byteLength} bytes, over the ${MOTION_MAX_BYTES} byte cap`);
-	}
-	let motion;
-	try {
-		motion = await decodeMotionNpz(bytes);
-	} catch (error) {
-		if (error instanceof NpzError && !error.code) error.code = "bad-npz";
-		throw error;
-	}
-	const motionId = await sha256Hex(bytes);
-	const record = {
-		motionId,
-		encoding: "base64",
-		data: bytesToBase64(bytes),
-		bytes: bytes.byteLength,
-		frames: motion.frames,
-		fps: motion.fps,
-	};
-	const source = meta && typeof meta === "object" ? meta : {};
-	if (typeof source.name === "string" && source.name) record.name = source.name;
-	const extra = { personScale: motion.personScale };
-	for (const key of META_KEYS) {
-		if (source[key] !== undefined && source[key] !== null) extra[key] = source[key];
-	}
-	record.meta = extra;
-	return record;
-}
-
-/**
- * Unpack a motion record back into a decoded motion. Checks, in order: size
- * cap, base64 syntax, declared byte length, SHA-256 against motionId, then
- * the full npz validation. Returns the decodeMotionNpz result plus
- * { motionId, sourceBytes } — exactly what loadMotionFromUrl returns, so the
- * restore path treats an embedded take and a downloaded one the same way.
- */
-export async function decodeMotionResource(record) {
-	if (!record || typeof record !== "object") {
-		throw codedError("bad-base64", "motion resource must be an object with base64 data");
-	}
-	if (Number.isFinite(record.bytes) && record.bytes > MOTION_MAX_BYTES) {
-		throw codedError("too-large", `motion resource declares ${record.bytes} bytes, over the ${MOTION_MAX_BYTES} byte cap`);
-	}
-	if (record.encoding !== "base64" || typeof record.data !== "string") {
-		throw codedError("bad-base64", "motion resource must contain base64 data");
-	}
-	if (base64DecodedLength(record.data) > MOTION_MAX_BYTES) {
-		throw codedError("too-large", `motion resource data decodes past the ${MOTION_MAX_BYTES} byte cap`);
-	}
-	const bytes = base64ToBytes(record.data);
-	if (bytes.byteLength > MOTION_MAX_BYTES) {
-		throw codedError("too-large", `motion resource is ${bytes.byteLength} bytes, over the ${MOTION_MAX_BYTES} byte cap`);
-	}
-	if (!Number.isInteger(record.bytes) || record.bytes !== bytes.byteLength) {
-		throw codedError("length-mismatch", `motion resource declares ${record.bytes} bytes but carries ${bytes.byteLength}`);
-	}
-	const declaredId = typeof record.motionId === "string" && MOTION_ID_RE.test(record.motionId) ? record.motionId.toLowerCase() : null;
-	const motionId = await sha256Hex(bytes);
-	if (declaredId !== motionId) {
-		throw codedError("hash-mismatch", "motion resource bytes do not match its motionId");
-	}
-	let motion;
-	try {
-		motion = await decodeMotionNpz(bytes);
-	} catch (error) {
-		if (error instanceof NpzError && !error.code) error.code = "bad-npz";
-		throw error;
-	}
-	return { ...motion, motionId, sourceBytes: bytes };
-}
-
-/**
- * Where a character's motion should come from on restore. Embedded bytes win
- * over a URL: the URL is a bridge run that may be gone, the bytes are here.
- *   { kind: "embedded", record } | { kind: "url", url } | { kind: "missing" }
- */
-export function resolveMotionSource(motionRef, motionsById) {
-	if (!motionRef || typeof motionRef !== "object") return { kind: "missing" };
-	if (typeof motionRef.motionId === "string" && motionsById && typeof motionsById.get === "function") {
-		const record = motionsById.get(motionRef.motionId.toLowerCase());
-		if (record) return { kind: "embedded", record };
-	}
-	if (typeof motionRef.url === "string" && motionRef.url) return { kind: "url", url: motionRef.url };
-	return { kind: "missing" };
-}
-
-export { loadMotionFromUrl } from "./ardy/npz.js";

package/src/motion-store.js

@@ -1,65 +0,0 @@
-const MOTION_DB_NAME = "cozyclay.motions";
-const MOTION_DB_VERSION = 1;
-const MOTION_STORE_NAME = "motions";
-
-const validId = (id) => typeof id === "string" && /^[0-9a-f]{64}$/i.test(id);
-
-function normalizeMotion(record) {
-	if (!record || typeof record !== "object" || !validId(record.motionId)) return null;
-	if (record.encoding !== "base64" || typeof record.data !== "string") return null;
-	return { ...record, motionId: record.motionId.toLowerCase(), stored: true };
-}
-
-export function openMotionDb(factory = globalThis.indexedDB) {
-	if (!factory) return Promise.reject(new Error("IndexedDB is unavailable"));
-	return new Promise((resolve, reject) => {
-		const req = factory.open(MOTION_DB_NAME, MOTION_DB_VERSION);
-		req.onupgradeneeded = () => {
-			if (!req.result.objectStoreNames.contains(MOTION_STORE_NAME)) req.result.createObjectStore(MOTION_STORE_NAME, { keyPath: "motionId" });
-		};
-		req.onsuccess = () => resolve(req.result);
-		req.onerror = () => reject(req.error);
-		req.onblocked = () => reject(new Error("the motion database is blocked by another tab"));
-	});
-}
-
-const request = (req) => new Promise((resolve, reject) => {
-	req.onsuccess = () => resolve(req.result);
-	req.onerror = () => reject(req.error);
-});
-const complete = (tx) => new Promise((resolve, reject) => {
-	tx.oncomplete = resolve;
-	tx.onerror = () => reject(tx.error);
-	tx.onabort = () => reject(tx.error);
-});
-
-export async function putMotion(db, record) {
-	const value = normalizeMotion(record);
-	if (!value) throw new TypeError("putMotion needs a valid motion record");
-	const tx = db.transaction(MOTION_STORE_NAME, "readwrite");
-	tx.objectStore(MOTION_STORE_NAME).put(value);
-	await complete(tx);
-	return value;
-}
-export async function getMotion(db, id) {
-	if (!validId(id)) return null;
-	const tx = db.transaction(MOTION_STORE_NAME, "readonly");
-	return normalizeMotion(await request(tx.objectStore(MOTION_STORE_NAME).get(id.toLowerCase())));
-}
-export async function listMotionIds(db) {
-	const tx = db.transaction(MOTION_STORE_NAME, "readonly");
-	return (await request(tx.objectStore(MOTION_STORE_NAME).getAllKeys()) ?? []).filter(validId).map((id) => id.toLowerCase());
-}
-export async function deleteMotion(db, id) {
-	if (!validId(id)) return false;
-	const tx = db.transaction(MOTION_STORE_NAME, "readwrite");
-	tx.objectStore(MOTION_STORE_NAME).delete(id.toLowerCase());
-	await complete(tx);
-	return true;
-}
-export async function sweepMotions(db, referencedIds) {
-	const keep = new Set([...referencedIds ?? []].map((id) => String(id).toLowerCase()));
-	const ids = await listMotionIds(db);
-	await Promise.all(ids.filter((id) => !keep.has(id)).map((id) => deleteMotion(db, id)));
-	return ids.filter((id) => !keep.has(id));
-}