跳转到内容

签名关联类型: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;
};

关联类型:CanvasReferenceMediaKind

成员说明:

  • 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;
};

关联类型:GenerationModelsSnapshot

成员说明:

  • 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";