签名关联类型:FocusMediaLease – GizmoHandleName
本页由当前 SDK 声明自动生成。
FocusMediaLease · FocusMediaSource · FocusTargetInput · FocusTransitionPort · FocusTransitionVersion · FocusViewport · FocusViewportTarget · FrontendLogService · GenerationKind · GenerationModelCapabilityFacts · GenerationModelCombinedReferenceLimit · GenerationModelEntry · GenerationModelLimits · GenerationModelReasoningCapability · GenerationModelReferenceLimit · GenerationModelsRemote · GenerationModelsStatusService · GenerationModelsStatusSnapshot · GenerationResult · GenerationSourceEntry · GenerationStatus · GhostRenderNode · GizmoFeedback · GizmoHandleName
FocusMediaLease
一次成功媒体位图 lease 的释放句柄。
export type FocusMediaLease = { key: string; release: () => void;};成员说明:
release:释放本 consumer 的引用;引用归零后条目才可被预算回收。
FocusMediaSource
稳定来源 identity:同一 canonical 素材的多 consumer 共享同一条目。
export type FocusMediaSource = { key: string; quality?: "card" | "focus";};成员说明:
key:素材稳定键(如 storageKey / 受控同源 URL 的规范键)。quality:期望质量命名空间(卡片/聚焦),仅用于质量请求;不参与共享键。
FocusTargetInput
聚焦目标解析输入。
export type FocusTargetInput = { capabilities?: import("@woohaa3/contracts").NodeCapabilities; canvas: ServerCanvas; nodeId: string; viewport: { x: number; y: number; zoom: number; }; surface: { width: number; height: number; }; sceneVersion: string; ops: readonly unknown[]; extent: number; aabb?: import("@woohaa3/contracts").Aabb | null; placement: { offset: { x: number; y: number; z: number; }; scale: number; yaw: number; } | null; nonCanonical?: boolean;};关联类型:NodeCapabilities · ServerCanvas · Aabb
成员说明:
sceneVersion:该节点的 Scene IR(浏览器执行 modelScript 得到)。aabb:已派生的模型局部 AABB(prepared resource 提供;缺省时按 ops 计算)。nonCanonical:该目标是否为 feature 提供的非 canonical 临时模型快照。为true时禁止 placement 编辑(只允许相机查看)。
FocusTransitionPort
唯一取景过渡时间源端口。
生产由 Canvas Runtime scope 的 FocusTransitionCoordinator 实现(单一时间源、generation、
取消/反向、reduced motion);feature 只持有该端口,MUST NOT 自带独立 rAF。测试/无 runtime
时使用 createLocalTransitionRunner() 作为最小等价实现。
export type FocusTransitionPort = { run(request: ViewportTransitionRequest): Promise<boolean>; cancel(key?: string): void; isActive(): boolean;};关联类型:ViewportTransitionRequest
成员说明:
run:运行一次过渡;返回是否正常完成(取消/被替换返回 false)。cancel:取消当前过渡(可选按 key 前缀);被取消的 previous promise 以 false 结算。
FocusTransitionVersion
export type FocusTransitionVersion = typeof FOCUS_TRANSITION_VERSION;FocusViewport
export type FocusViewport = { x: number; y: number; zoom: number;};FocusViewportTarget
画布输入当前操作的二维聚焦取景;不持有手势或 DOM 监听。
export type FocusViewportTarget = { read: () => { viewport: { x: number; y: number; zoom: number; }; rect: FocusContentRect; } | null; write: (viewport: { x: number; y: number; zoom: number; }) => void;};关联类型:FocusContentRect
FrontendLogService
export type FrontendLogService = { scope(module: string): (event: Record<string, unknown>) => void; level(): LogLevel;};关联类型:LogLevel
成员说明:
scope:带module字段的结构化日志出口。level:当前生效级别。
GenerationKind
export type GenerationKind = "text" | "image" | "video" | "audio" | "motion";GenerationModelCapabilityFacts
export type GenerationModelCapabilityFacts = { reasoning?: GenerationModelReasoningCapability; limits?: GenerationModelLimits;};关联类型:GenerationModelReasoningCapability · GenerationModelLimits
成员说明:
limits:模型级能力边界。 只放inputSchema/bindings表达不了的:跨字段的总量与下限。
GenerationModelCombinedReferenceLimit
inputSchema 表达不了的跨类合计(例如「图和视频加起来不超过 30」)。
export type GenerationModelCombinedReferenceLimit = { kinds: readonly CanvasReferenceMediaKind[]; max: number; label: string;};成员说明:
label:人读标签,用于提示文案。
GenerationModelEntry
Display identities are opaque; only the business owner resolves a selection to an execution request.
export type GenerationModelEntry = { identity: string; sourceIdentity: string; modelIdentity: string; label: string; modelId: string; sourceLabel: string; detail?: string; unavailableReason?: string; isDefault?: boolean;};GenerationModelLimits
模型卡片声明的能力边界。字段缺省 = 未声明 = 前端不展示、不做本地拦截。
数量上限本身仍由 bindings[].maxItems 承载;这里出现同名字段时必须与之一致——
maxItems 是提交契约,limits.references.max 是展示与本地校验用的同一事实。
生效值一律取 min(部署级, 模型级)。
export type GenerationModelLimits = { promptMaxChars?: number; references?: Partial<Record<CanvasReferenceMediaKind, GenerationModelReferenceLimit>>; total?: { min?: number; max: number; }; combined?: readonly GenerationModelCombinedReferenceLimit[];};关联类型:CanvasReferenceMediaKind · GenerationModelReferenceLimit · GenerationModelCombinedReferenceLimit
GenerationModelReasoningCapability
推理/思考能力:efforts 缺省或空数组表示「支持但上游未列档位」。
export type GenerationModelReasoningCapability = { supported: boolean; efforts?: readonly string[];};GenerationModelReferenceLimit
单个素材种类的数量与体积约束。
放在能力事实里而不是 inputSchema:maxItems 只表达「最多几条」,表达不了
「至少几条」「单个多大」,而这两条恰恰是用户最常在提交后才知道的。
export type GenerationModelReferenceLimit = { min: number; max: number; maxBytesPerItem: number;};成员说明:
maxBytesPerItem:单个素材的字节上限。
GenerationModelsRemote
export type GenerationModelsRemote = { fetchSnapshot: () => Promise<{ ok: true; snapshot: GenerationModelsSnapshot; } | { ok: false; error: string; }>; writeConfig: (input: GenerationModelsWriteRequest) => Promise<{ ok: true; revision: number; snapshot: GenerationModelsSnapshot; } | { ok: false; code: string; error: string; currentRevision?: number; }>;};关联类型:GenerationModelsSnapshot · GenerationModelsWriteRequest
GenerationModelsStatusService
export type GenerationModelsStatusService = { getSnapshot: () => GenerationModelsStatusSnapshot; subscribe: (listener: () => void) => () => void; refresh: () => Promise<void>; setEnabled: (modelKey: string, enabled: boolean) => Promise<{ ok: boolean; error?: string; }>; setEnabledMany: (modelKeys: readonly string[], enabled: boolean) => Promise<{ ok: boolean; error?: string; }>; setDefault: (modelKey: string, modelType: string) => Promise<{ ok: boolean; error?: string; }>; start: () => void; stop: () => void; dispose: () => void;};关联类型:GenerationModelsStatusSnapshot
成员说明:
setEnabledMany:一次启用或关闭一批模型。关闭时清掉这批里的默认标记。已删除的模型不动。
GenerationModelsStatusSnapshot
export type GenerationModelsStatusSnapshot = { revision: number; catalogRevision: number; initialized: boolean; models: GenerationModelsSnapshot["models"]; error: string | null; loading: boolean;};成员说明:
catalogRevision:当前任务目录修订。 宿主在已被轮询的模型快照里透出;Provider 注册/可用性/模型描述版本变化时单调前进。 前端据此使任务目录失效。旧宿主没有该信号时为 -1(「无此信号」)。
GenerationResult
export type GenerationResult = { kind: GenerationKind; text?: string; url?: string; posterUrl?: string; durationSeconds?: number;};关联类型:GenerationKind
GenerationSourceEntry
export type GenerationSourceEntry = { identity: string; label: string; status: "ready" | "loading" | "unloaded" | "failed"; error?: string; unavailableReason?: string;};GenerationStatus
export type GenerationStatus = "idle" | "queued" | "running" | "success" | "failed" | "draft" | "ready" | "archived";GhostRenderNode
上传中导入的「幽灵节点」渲染输入 。
只用于渲染:它不进入 ServerCanvas / Y.Doc / IndexedDB。渲染层把它当成一个普通节点,
因此 Bevy 用与真实节点完全相同的卡片外观绘制(同样的边框/图标/端口/状态/进度环)。
id 必须是将来真实节点的同一个 id:真实节点出现(working projection)后,同 id 的 ghost
会被自动跳过,实现无跳变接管。
export type GhostRenderNode = { id: string; nodeType: string; x: number; y: number; label?: string; status?: string; progress?: number; texture?: boolean;};成员说明:
nodeType:WooHaa3 节点类型(image/video/audio/text),用于映射 Bevy palette kind 与尺寸。label:节点正文(通常为文件名)。status:诊断状态文案(如「上传中」)。 只供宿主与测试观察(window.__canvasGhosts、paste-import e2e);不转发给 Bevy, 节点卡片不显示任何状态文案,上传进度只由progress驱动的进度环表达。progress:上传进度 0..100(驱动进度环)。texture:是否已有可显示纹理(本地 object URL 已上传)。
GizmoFeedback
export type GizmoFeedback = { hover?: GizmoHandleName; active?: GizmoHandleName; epoch: number;};关联类型:GizmoHandleName
GizmoHandleName
Disposable tools and feedback, transported with the instance’s accepted render scene.
export type GizmoHandleName = "x" | "y" | "z" | "center" | "yaw-ring" | "scale" | "orbit-ring" | "elevation-ring" | "distance" | "shot-origin";