Files
short-drama-agent-front/src/features/storyboard/useShotSelection.ts
T

68 lines
2.9 KiB
TypeScript

import { computed, inject, ref, watch } from 'vue'
import { routeLocationKey, routerKey } from 'vue-router'
import type { LocationQueryRaw } from 'vue-router'
import { queryText } from '../production/asset-links'
/**
* 镜头选择与地址同步;初次读取及浏览器导航恢复正式 ID,切集清除上集镜头。
* @param currentEpisode 当前有效剧集,选择镜头时用于补全深链接
* @returns 可写的剧集和镜头选择状态
*/
export function useShotSelection(currentEpisode: () => number) {
/** 当前页面地址,非路由环境保留本地选择。 */
const route = inject(routeLocationKey, undefined)
/** 当前路由导航器,替换选择参数不产生逐镜头历史。 */
const router = inject(routerKey, undefined)
/** 当前选择的剧集,缺省时由页面决定首次有效剧集。 */
const episode = ref<number>()
/** 当前选择的正式镜头 ID。 */
const shotId = ref('')
/** 地址变化只读取选择,不触发反向写入或重置其它参数。 */
watch(
() => [route?.query.episodeNo, route?.query.shotId],
() => {
const number = Number(queryText(route?.query.episodeNo))
episode.value = Number.isSafeInteger(number) && number > 0 ? number : undefined
shotId.value = queryText(route?.query.shotId)
},
{ immediate: true, flush: 'sync' }
)
/**
* 仅替换当前页面的选择参数,保留来源动作、筛选参数与 hash。
* @param query 更新后的地址参数
*/
function replaceSelection(query: LocationQueryRaw) {
if (router && route) void router.replace({ path: route.path, query, hash: route.hash })
}
/** 切换剧集立即清除旧镜头,避免把上集 ID 带到下集。 */
const selectedEpisode = computed({
get: () => episode.value,
set: (number: number | undefined) => {
episode.value = number
shotId.value = ''
const query: LocationQueryRaw = { ...route?.query }
delete query.shotId
if (number && Number.isSafeInteger(number) && number > 0) query.episodeNo = String(number)
else delete query.episodeNo
replaceSelection(query)
}
})
/** 选择镜头同时写入有效剧集和正式 ID,刷新后按地址恢复。 */
const selectedShot = computed({
get: () => shotId.value,
set: (value: string) => {
shotId.value = value.trim()
const query: LocationQueryRaw = { ...route?.query }
const number = currentEpisode()
if (Number.isSafeInteger(number) && number > 0) query.episodeNo = String(number)
if (shotId.value) query.shotId = shotId.value
else delete query.shotId
replaceSelection(query)
}
})
return { selectedEpisode, selectedShot }
}