@world-engines/view-sdk 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,46 @@
+WorldEngine 官方作者工具许可证
+
+版权所有 (c) 2026 Nixdorfer。保留所有权利。
+
+本仓库的源代码、构建材料及附带资源（统称“本作品”）不是开源软件，
+不适用任何 OSI 认证的开源许可证。
+
+一、官方作者工具分发许可
+
+版权所有者可以通过其官方网站、npm registry、签名安装包或其他官方渠道，
+复制并分发由本作品构建的 WorldEngine 作者工具及其必要运行资源
+（统称“官方作者工具”）。仅版权所有者或其书面指定的发布者享有此分发权。
+
+二、作者用户许可
+
+从官方渠道取得官方作者工具的作者用户，可以：
+
+1. 安装和运行官方作者工具；
+2. 使用官方作者工具创作、编辑、预览、导入、导出和提交其有权处理的内容；
+3. 为上述使用目的制作合理必要的本地备份副本。
+
+三、未授予的权利
+
+除第二条明确允许的行为外，本许可证不授予作者用户或其他第三方以下权利：
+
+1. 修改、改编、反编译、反汇编或制作官方作者工具的派生作品；
+2. 复制、镜像、转发、再上传、出售、出租、再分发或再许可官方作者工具；
+3. 使用本作品的源代码、构建材料或任何部分开发、提供或训练其他产品或服务；
+4. 删除或规避版权、许可、签名、访问控制或其他权利管理信息。
+
+法律强制允许且合同不得排除的权利不受上述限制影响。
+
+四、源代码查看
+
+第三方可以在已获合法访问权限的范围内查看本作品，用于审查、安全研究或学习参考；
+查看不授予运行、复制、修改、分发、再许可或用于其他产品与服务的权利。
+
+五、无担保与责任限制
+
+本作品与官方作者工具均按“现状”提供，不附带任何明示或暗示的担保。
+在适用法律允许的最大范围内，版权所有者不对因访问或使用本作品或官方作者工具
+造成的任何损失承担责任。
+
+六、终止
+
+违反本许可证将立即终止相应的访问与使用权；终止不影响版权所有者已经产生的权利和救济。

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+export type { ChatPlayApi, TmwInteractionResult } from "@world-engines/chatplay-vite-plugin/runtime/chatplay-sdk.d.ts";
+export { CHATPLAY_DEBUG_CAPABILITIES, CHATPLAY_RUNTIME_COMPATIBILITY, chatPlay, } from "@world-engines/chatplay-vite-plugin";
+export type { ChatPlayDangerousLanOptions, ChatPlayDebugCapability, ChatPlayDebugCapabilityMatrix, ChatPlayDebugClient, ChatPlayDebugCurrency, ChatPlayPluginOptions, ChatPlayRuntimeCompatibility, } from "@world-engines/chatplay-vite-plugin";
+import { CHATPLAY_RUNTIME_COMPATIBILITY as chatPlayRuntimeCompatibility, type ChatPlayPluginOptions } from "@world-engines/chatplay-vite-plugin";
+import type { Plugin } from "vite";
+/** 可重复注入到本地 Preview 的最小 ChatPlay 调试语境；它不模拟远端 runtime。 */
+export interface ChatPlayFixture {
+    readonly schema_version: 1;
+    readonly fixture_id: string;
+    readonly scenario_id: string;
+    readonly initial_messages: readonly ChatPlayFixtureMessage[];
+    readonly runtime: typeof chatPlayRuntimeCompatibility;
+}
+export interface ChatPlayFixtureMessage {
+    readonly role: "system" | "assistant" | "user";
+    readonly content: string;
+}
+export interface ChatPlayViteIntegration {
+    readonly fixture: ChatPlayFixture;
+    readonly plugin: Plugin;
+    /** 供 View 的 Vite config 合并到 define；不注入凭据或远端响应。 */
+    readonly define: Readonly<Record<"__CHATPLAY_FIXTURE__", string>>;
+}
+export declare function createChatPlayFixture(input: {
+    readonly fixture_id: string;
+    readonly scenario_id: string;
+    readonly initial_messages?: readonly ChatPlayFixtureMessage[];
+}): ChatPlayFixture;
+/**
+ * 返回真实 ChatPlay Vite plugin 与可序列化 fixture define。
+ * fixture 只负责可重复的 Preview 输入；请求仍由 plugin 的显式 apiBase/apiKeyEnv/model 配置处理。
+ */
+export declare function integrateChatPlayVite(options: ChatPlayPluginOptions, fixture: ChatPlayFixture): ChatPlayViteIntegration;

package/dist/index.js

@@ -0,0 +1,30 @@
+export { CHATPLAY_DEBUG_CAPABILITIES, CHATPLAY_RUNTIME_COMPATIBILITY, chatPlay, } from "@world-engines/chatplay-vite-plugin";
+import { CHATPLAY_RUNTIME_COMPATIBILITY as chatPlayRuntimeCompatibility, chatPlay as createChatPlayPlugin, } from "@world-engines/chatplay-vite-plugin";
+export function createChatPlayFixture(input) {
+    if (input.fixture_id.trim() === "" || input.scenario_id.trim() === "") {
+        throw new TypeError("ChatPlay fixture 必须包含 fixture_id 与 scenario_id");
+    }
+    for (const message of input.initial_messages ?? []) {
+        if (message.content.trim() === "") {
+            throw new TypeError("ChatPlay fixture message 不得为空");
+        }
+    }
+    return Object.freeze({
+        schema_version: 1,
+        fixture_id: input.fixture_id,
+        scenario_id: input.scenario_id,
+        initial_messages: Object.freeze([...(input.initial_messages ?? [])]),
+        runtime: chatPlayRuntimeCompatibility,
+    });
+}
+/**
+ * 返回真实 ChatPlay Vite plugin 与可序列化 fixture define。
+ * fixture 只负责可重复的 Preview 输入；请求仍由 plugin 的显式 apiBase/apiKeyEnv/model 配置处理。
+ */
+export function integrateChatPlayVite(options, fixture) {
+    return Object.freeze({
+        fixture,
+        plugin: createChatPlayPlugin(options),
+        define: Object.freeze({ __CHATPLAY_FIXTURE__: JSON.stringify(fixture) }),
+    });
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@world-engines/view-sdk",
+  "version": "0.1.0-alpha.0",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@world-engines/chatplay-vite-plugin": "0.1.2"
+  },
+  "peerDependencies": {
+    "vite": ">=5.4.0 <8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "worldengine_source_sha256": "07fef124af40a871e999b380b35baae432cdc87dac84456e1bb570ac26090b69",
+  "worldengine_release_metadata_provenance": {
+    "schema": "worldengine-release-metadata-v1",
+    "base_archive_sha256": "991e4d5674eb86e808ab4d81fc2cec3c215eb3a5120814924dee7f6715ff3390",
+    "change": "dependency:@world-engines/chatplay-vite-plugin@0.1.2",
+    "source_recompiled": false,
+    "source_sha256_retained": "ac0bad0149bf60902b3d07ffdf4307fbf7454bb8a8c1fd0aa8343aa92f006c68"
+  },
+  "worldengine_source_identity_provenance": {
+    "schema": "worldengine-public-namespace-projection/v1",
+    "kind": "composite-source-identity; namespace projection; not-full-source-recompile",
+    "original_name": "@worldengine/view-sdk",
+    "original_archive_sha256": "30abde8692d34f774a2a825522a435586117dd0972373890d379802a986332df",
+    "original_source_sha256": "ac0bad0149bf60902b3d07ffdf4307fbf7454bb8a8c1fd0aa8343aa92f006c68",
+    "projected_name": "@world-engines/view-sdk",
+    "package_name_mapping": {
+      "@chat/blocks-editor": "@world-engines/blocks-editor",
+      "@chat/ladybug-bridge": "@world-engines/ladybug-bridge",
+      "@chat/monaco-host": "@world-engines/monaco-host",
+      "@chat/protocol-ts": "@world-engines/protocol-ts",
+      "@chat/scenario-author-source": "@world-engines/scenario-author-source",
+      "@chat/scenario-review-snapshot": "@world-engines/scenario-review-snapshot",
+      "@chat/tmw": "@world-engines/tmw",
+      "@chat/view-exposure": "@world-engines/view-exposure",
+      "@world-engines/chatplay-vite-plugin": "@world-engines/chatplay-vite-plugin",
+      "@worldengine/agent-kit": "@world-engines/agent-kit",
+      "@worldengine/authoring-bridge": "@world-engines/authoring-bridge",
+      "@worldengine/authoring-ui": "@world-engines/authoring-ui",
+      "@worldengine/create-project": "@world-engines/create-project",
+      "@worldengine/project-format": "@world-engines/project-format",
+      "@worldengine/project-host": "@world-engines/project-host",
+      "@worldengine/project-setup": "@world-engines/project-setup",
+      "@worldengine/spatial-authoring": "@world-engines/spatial-authoring",
+      "@worldengine/view-sdk": "@world-engines/view-sdk"
+    }
+  }
+}