签名关联类型:NotificationServiceHandle – PrincipalContext
本页由当前 SDK 声明自动生成。
NotificationServiceHandle · OscillateMode · PageCapturePendingEntry · PageCapturePendingResult · ParameterJournalEntry · ParameterPatch · ParameterPresentation · ParameterPreviewEntry · PayloadValidator · PluginIconAsset · PluginIconName · Point · PointHit · PopoverCommonProps · PptaskParameterControl · PreparationPhase · PreparationState · PreparedAgentRoleTurn · PreparedModelMetadata · PreparedModelResource · PreparedModelResourceVersion · PreparedSomaMotion · PresentableParameter · PrincipalContext
NotificationServiceHandle
export type NotificationServiceHandle = TaskNotificationService & { start(): Promise<void>; handleScopeChange(): Promise<void>;};成员说明:
deliveries:最近投递(诊断/回归;有界)。start:启动观察(App scope 装配后调用一次)。handleScopeChange:数据范围变化(账号切换):重读偏好并为新范围重建基线。
OscillateMode
export type OscillateMode = "position" | "rotation" | "scale";PageCapturePendingEntry
页面驱动取景:宿主登记的待渲染镜头项。
export type PageCapturePendingEntry = { attemptId?: string; canvasId: string; cameraId: string; key: import("@woohaa3/contracts").WorldCaptureVersionKey; width: number; height: number; kind?: "static" | "dynamic"; dynamicKey?: import("@woohaa3/contracts").WorldCaptureDynamicVersionKey; fps?: number; timeRange?: import("@woohaa3/contracts").WorldCaptureTimeRange; animationNodeId?: string;};关联类型:WorldCaptureVersionKey · WorldCaptureDynamicVersionKey · WorldCaptureTimeRange
PageCapturePendingResult
export type PageCapturePendingResult = { ok: true; captures: PageCapturePendingEntry[];} | { ok: false; code: string; error: string;};ParameterJournalEntry
export type ParameterJournalEntry = { kind: "parameter"; id: string; label: string; nodeId: string; modelKey: string; before: Record<string, unknown>; after: Record<string, unknown>; revision?: number; undoRevision?: number; state: JournalEntryState;};关联类型:JournalEntryState
成员说明:
nodeId:参数分区身份。
ParameterPatch
参数面板产生的一次瞬时/提交 patch。
export type ParameterPatch = { modelPlacement?: ModelPlacementDraft;};关联类型:ModelPlacementDraft
ParameterPresentation
export type ParameterPresentation = { section?: "common" | "advanced"; order?: number; summaryOrder?: number; semanticId?: string; control?: "segmented" | "search-select" | "slider" | "number" | "switch" | "textarea";};ParameterPreviewEntry
export type ParameterPreviewEntry = { patch: ParameterPatch; deadline: number;};关联类型:ParameterPatch
PayloadValidator
类型化 payload 校验:返回规范化 payload 或错误信息。
export type PayloadValidator<T = unknown> = (payload: unknown) => { ok: true; payload: T;} | { ok: false; error: string;};PluginIconAsset
品牌图形路径(固定前缀下的站点内路径,如 /plugin-icons/litellm.png)。
export type PluginIconAsset = `${typeof PLUGIN_ICON_ASSET_PREFIX}${string}`;PluginIconName
export type PluginIconName = (typeof PLUGIN_ICON_NAMES)[number];Point
export type Point = { x: number; y: number;};PointHit
2D 点命中语义结果;与 Rust PointHit 的 serde 输出同构
。
export type PointHit = { kind: "scene-area-playback"; nodeId: string; control: "play" | "loop" | "track" | "body"; track: [ number, number, number, number ];} | { kind: "node"; nodeId: string;} | { kind: "history"; nodeId: string;} | { kind: "port"; nodeId: string; side: "input" | "output";} | { kind: "resize"; nodeId: string; handle?: "nw" | "ne" | "sw" | "se";} | { kind: "edge"; edgeId: string;} | { kind: "edge-delete"; edgeId: string;} | { kind: "aggregate-handle"; direction: "input" | "output";} | { kind: "node-action"; nodeId: string; actionId: string; menu: boolean;};PopoverCommonProps
type PopoverCommonProps = { open: boolean; onOpenChange: (open: boolean) => void; children: ReactNode; side?: "top" | "right" | "bottom" | "left"; align?: "start" | "center" | "end"; sideOffset?: number; className?: string; label?: string; dismissOnOutside?: boolean; dismissOnEscape?: boolean; restoreFocus?: boolean; autoFocus?: boolean; keepMounted?: boolean; testId?: string;};成员说明:
open:受控 open。className:popup 追加 class。label:popup 可访问名(role="dialog"的 aria-label)。dismissOnOutside:是否在 outside pointerdown 时请求关闭(默认 true)。dismissOnEscape:Escape 请求关闭(默认 true)。restoreFocus:关闭后焦点是否回到 trigger(默认 true)。autoFocus:Hover previews must not move keyboard focus into the popup.keepMounted:Keep child state and ongoing operations alive while the popup is closed.testId:测试标识。
PptaskParameterControl
语义控件种类。
export type PptaskParameterControl = "aspect-ratio" | "resolution" | "quality" | "background" | "voice";PreparationPhase
export type PreparationPhase = (typeof PREPARATION_PHASES)[number];PreparationState
稳定的准备状态;失败携带稳定 code 与 retryable。
export type PreparationState = { state: "ready"; canvasId: string; revision: number;} | { state: "preparing"; jobId: string; phase: PreparationPhase; completedMedia: number; totalMedia: number; pollAfterMs: number;} | { state: "failed"; code: string; retryable: boolean; message: string;} | { state: "deleted"; code: "DELETED";};关联类型:PreparationPhase
PreparedAgentRoleTurn
宿主准备完成、可重放的角色回合。
可序列化部分不含秘密:工具授权(grant token)、MCP 地址与凭据仍由执行通道的既有时序签发, 浏览器请求不得构造或改写本对象。
export type PreparedAgentRoleTurn = { readonly workspace?: CanvasWorkspaceHandle; readonly schemaVersion: 1; readonly roleRef: AgentRoleRef; readonly messages: readonly AgentPromptMessage[]; readonly tools: readonly string[]; readonly nativeCapabilities: readonly AgentNativeCapability[]; readonly output: AgentRoleOutput; readonly inputDigest: string; readonly contextDigest: string; readonly attachmentDigests: readonly string[]; readonly target: AgentRoleTargetRef; readonly preparedHash: string;};关联类型:CanvasWorkspaceHandle · AgentRoleRef · AgentPromptMessage · AgentNativeCapability · AgentRoleOutput · AgentRoleTargetRef
成员说明:
workspace:Trusted desktop auxiliary capability, frozen by the host after role preparation.messages:已合成的规范消息(definition.instructions 在最前)。tools:求交后的工具集合(角色允许 ∩ prepare 收窄 ∩ 授权 ∩ 通道能力 ∩ 实际目录)。attachmentDigests:宿主准备的附件身份摘要;字节沿原附件通道传递。
PreparedModelMetadata
Rust prepare_and_register_model_resource 返回的轻量 metadata。
export type PreparedModelMetadata = { resourceVersion: string; resourceKey: string; sceneVersion: string; signature: string; extent: number; aabb: Aabb | null;};关联类型:Aabb
PreparedModelResource
不可变 prepared model resource。
resourceKey=sceneVersion:signature,不含节点 ID:内容相同的多个节点共享资源; placement / instance 生命周期仍按节点独立。signature:只覆盖模型内容(Scene IR/version/材质/动画),不含 placement / viewport。aabb/extent:与 signature 同一份规范化结果派生,供相机取景与渲染复用。payload:注册到 Bevy 的完整 descriptor(含 ops),避免注册时再次序列化。
export type PreparedModelResource = { resourceVersion: PreparedModelResourceVersion; sceneVersion: string; signature: string; resourceKey: string; ops: readonly SceneV2Op[]; aabb: Aabb | null; extent: number; payload: string;};关联类型:PreparedModelResourceVersion · SceneV2Op · Aabb
成员说明:
payload:注册 payload(与modelResourcePayload一致);只用于跨 WASM 传输。
PreparedModelResourceVersion
export type PreparedModelResourceVersion = typeof PREPARED_MODEL_RESOURCE_VERSION;PreparedSomaMotion
export interface PreparedSomaMotion { fps: number; frameCount: number; durationSeconds: number; jointNames: string[]; faces: Uint32Array; bindVertices: Float32Array; globalRotations: Float32Array; posedJoints: Float32Array; bindTransforms: Float64Array; localRotations: Float64Array; rootPositions: Float64Array; parents: Int32Array; order: number[]; indices: Uint32Array; weights: Float32Array; restOffsets: Float64Array;}成员说明:
globalRotations:Internal validated row-major buffers; callers must treat prepared data as immutable.
PresentableParameter
export type PresentableParameter = { key: string; label: string; type?: string; unit?: string; defaultValue?: unknown; schema?: Record<string, unknown>; presentation?: ParameterPresentation; options?: readonly { value: string; label: string; }[]; minimum?: number; maximum?: number; step?: number; integer?: boolean; hiddenWhen?: readonly { field: string; equals: unknown; }[]; requiresByValue?: Readonly<Record<string, Readonly<Record<string, unknown>>>>;};成员说明:
schema:Original property schema, used for constraints beyond the basic control.
PrincipalContext
宿主体内的可信、冻结principal 上下文 。
只由 identity provider 建立;包含有效期与会话绑定。刻意不含 isAdmin/管理员角色:管理权
是 site-access 的授权结果,不是认证结果。核心 MUST NOT 依据角色判定管理权。
export type PrincipalContext = { subject: string; displayName?: string; identityProvider: string; sessionId?: string; validUntil?: number; attributes?: Readonly<Record<string, string>>;};成员说明:
subject:应用用户 owner 依据(已验证的稳定主体;不是显示名或客户端自报字段)。displayName:已验证可得名称(展示用;不参与 owner 选择)。identityProvider:建立该 principal 的 identity provider identity(extensionId/providerId)。sessionId:会话绑定(OAuth 事务与撤权隔离用)。validUntil:身份有效期(epoch ms);到期后受保护连接停止。attributes:已验证的附加属性(有界字符串;由 provider 决定语义)。