@world-engines/create-project 0.1.0-alpha.0

package/dist/npm-environment.d.ts

@@ -0,0 +1,2 @@
+/** npm 生命周期脚本也必须能找到与 npm CLI 相同的 Node，不依赖系统安装。 */
+export declare function npmChildEnvironment(nodeExecutable: string, inherited?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;

package/dist/npm-environment.js

@@ -0,0 +1,11 @@
+import { delimiter, dirname, resolve } from "node:path";
+/** npm 生命周期脚本也必须能找到与 npm CLI 相同的 Node，不依赖系统安装。 */
+export function npmChildEnvironment(nodeExecutable, inherited = process.env) {
+    const environment = { ...inherited };
+    const pathKeys = Object.keys(environment).filter((key) => process.platform === "win32" ? key.toLowerCase() === "path" : key === "PATH");
+    const paths = pathKeys.map((key) => environment[key]).filter((value) => Boolean(value));
+    for (const key of pathKeys)
+        delete environment[key];
+    environment.PATH = [dirname(resolve(nodeExecutable)), ...paths].join(delimiter);
+    return environment;
+}

package/dist/template.d.ts

@@ -0,0 +1,8 @@
+export interface TemplateFile {
+    readonly path: string;
+    readonly content: string;
+}
+/** 独立作者工具链版本，不改变主站 workspace 的构建工具。 */
+export declare const AUTHOR_PROJECT_VITE_VERSION = "6.4.3";
+export declare const AUTHOR_PROJECT_WORKER_FORMAT = "es";
+export declare const PROJECT_TEMPLATE_FILES: readonly TemplateFile[];

package/dist/template.js

@@ -0,0 +1,128 @@
+import { DEFAULT_CHAT_APP_V3 } from "./default-view/app-v3.js";
+import { DEFAULT_CHAT_PLAYER_PANEL } from "./default-view/panel.js";
+import { DEFAULT_CHAT_BRIDGE } from "./default-view/bridge.js";
+import { DEFAULT_CHAT_VIEW_CONFIG } from "./default-view/config.js";
+import { DEFAULT_CHAT_STYLES } from "./default-view/styles.js";
+import { INTERACTION_DEMO_CONFIG, INTERACTION_DEMO_INSTALLER, INTERACTION_DEMO_README } from "./default-view/interaction-demo.js";
+/** 独立作者工具链版本，不改变主站 workspace 的构建工具。 */
+export const AUTHOR_PROJECT_VITE_VERSION = "6.4.3";
+export const AUTHOR_PROJECT_WORKER_FORMAT = "es";
+const ROOT_PACKAGE = {
+    name: "worldengine-local-author-project",
+    version: "0.0.0",
+    private: true,
+    scripts: {
+        dev: "worldengine gui",
+        build: "npm --prefix view run build",
+        typecheck: "npm --prefix view run typecheck",
+        test: "npm --prefix view run test",
+        "smoke:view": "npm --prefix view run smoke:chatplay",
+        doctor: "worldengine doctor",
+        snapshot: "worldengine snapshot",
+        "sync:status": "worldengine sync status",
+        gui: "worldengine gui",
+        "gui:check": "worldengine gui --check",
+    },
+    dependencies: {
+        "@world-engines/project-host": "0.1.0-alpha.0",
+        "@world-engines/authoring-bridge": "0.1.0-alpha.0",
+        "@world-engines/project-format": "0.1.0-alpha.0",
+        "@world-engines/agent-kit": "0.1.0-alpha.0",
+    },
+    overrides: {
+        dompurify: "3.4.13",
+    },
+};
+const VIEW_PACKAGE = {
+    name: "worldengine-local-view",
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    scripts: {
+        dev: "vite --host 127.0.0.1",
+        build: "tsc --noEmit && vite build",
+        typecheck: "tsc --noEmit",
+        test: "vitest run --passWithNoTests",
+        "smoke:chatplay": "vitest run src/chatplay.smoke.test.ts",
+    },
+    dependencies: {
+        "@world-engines/view-sdk": "0.1.0-alpha.0",
+        react: "^18.3.1",
+        "react-dom": "^18.3.1",
+        three: "^0.180.0",
+    },
+    devDependencies: {
+        "@types/react": "^18.3.12",
+        "@types/react-dom": "^18.3.1",
+        "@types/three": "^0.180.0",
+        "@vitejs/plugin-react": "^4.3.3",
+        autoprefixer: "^10.4.20",
+        postcss: "^8.4.49",
+        tailwindcss: "^3.4.17",
+        typescript: "^5.6.3",
+        vite: AUTHOR_PROJECT_VITE_VERSION,
+        vitest: "^3.2.4",
+    },
+};
+export const PROJECT_TEMPLATE_FILES = [
+    { path: "package.json", content: `${JSON.stringify(ROOT_PACKAGE, null, 2)}\n` },
+    {
+        path: "view/package.json",
+        content: `${JSON.stringify(VIEW_PACKAGE, null, 2)}\n`,
+    },
+    {
+        path: "view/index.html",
+        content: '<!doctype html>\n<html><head><meta charset="UTF-8" /><meta name="viewport" content="width=device-width,initial-scale=1" /><title>WorldEngine View</title></head><body><div id="root"></div><script type="module" src="/src/main.tsx"></script></body></html>\n',
+    },
+    {
+        path: "view/tsconfig.json",
+        content: `${JSON.stringify({ compilerOptions: { target: "ES2022", useDefineForClassFields: true, lib: ["ES2022", "DOM", "DOM.Iterable"], allowJs: false, skipLibCheck: true, esModuleInterop: true, allowSyntheticDefaultImports: true, strict: true, forceConsistentCasingInFileNames: true, module: "ESNext", moduleResolution: "Bundler", resolveJsonModule: true, isolatedModules: true, noEmit: true, jsx: "react-jsx" }, include: ["src"], references: [] }, null, 2)}\n`,
+    },
+    {
+        path: "view/vite.config.ts",
+        content: 'import { chatPlay } from "@world-engines/view-sdk";\nimport react from "@vitejs/plugin-react";\nimport { defineConfig } from "vite";\nimport previewConfig from "./preview.config.json" with { type: "json" };\n\nexport default defineConfig({ plugins: [react(), chatPlay({ apiBase: "http://127.0.0.1:11450", authentication: { mode: "account_proxy" }, model: previewConfig.model })], worker: { format: "es" }, server: { host: "127.0.0.1" } });\n',
+    },
+    { path: "view/preview.config.json", content: '{\n  "schema_version": 1,\n  "model": "anthropic/claude-sonnet-4-6"\n}\n' },
+    {
+        path: "view/tailwind.config.ts",
+        content: 'import type { Config } from "tailwindcss";\n\nexport default { content: ["./index.html", "./src/**/*.{ts,tsx}"], theme: { extend: {} }, plugins: [] } satisfies Config;\n',
+    },
+    {
+        path: "view/postcss.config.js",
+        content: 'export default { plugins: { tailwindcss: {}, autoprefixer: {} } };\n',
+    },
+    {
+        path: "view/src/main.tsx",
+        content: 'import React from "react";\nimport ReactDOM from "react-dom/client";\nimport { App } from "./App";\nimport "./styles.css";\n\nReactDOM.createRoot(document.getElementById("root")!).render(<React.StrictMode><App /></React.StrictMode>);\n',
+    },
+    {
+        path: "view/src/chatplay.d.ts",
+        content: 'import type {} from "@world-engines/view-sdk";\n',
+    },
+    {
+        path: "view/src/chatplay.ts",
+        content: DEFAULT_CHAT_BRIDGE,
+    },
+    {
+        path: "view/src/view-config.ts",
+        content: DEFAULT_CHAT_VIEW_CONFIG,
+    },
+    {
+        path: "view/src/App.tsx",
+        content: DEFAULT_CHAT_APP_V3,
+    },
+    { path: "view/src/player-panel.tsx", content: DEFAULT_CHAT_PLAYER_PANEL },
+    {
+        path: "view/src/chatplay.smoke.test.ts",
+        content: 'import { describe, expect, test, vi } from "vitest";\nimport { applyMessageDeleted, applyMessagePage, emitConfiguredAction, loadMessages, messageIdFromEvent, resolvedThemeFromEvent, sendMessage, type ChatPlayConversationBridge } from "./chatplay";\n\nconst message = (id: string, ts: number) => ({ id, saveId: "s", role: "assistant" as const, text: id, ts });\ndescribe("ChatPlay conversation bridge", () => {\n  test("ready 拒绝时不发请求，分页排序与发送服从正式 SDK", async () => {\n    const bridge = { ready: Promise.reject(new Error("not ready")), listMessages: vi.fn(), sendUserMessage: vi.fn() } as unknown as ChatPlayConversationBridge;\n    await expect(loadMessages(bridge)).rejects.toThrow("not ready"); await expect(sendMessage(bridge, "回复")).rejects.toThrow("not ready"); expect(bridge.listMessages).not.toHaveBeenCalled(); expect(bridge.sendUserMessage).not.toHaveBeenCalled();\n  });\n  test("删除 tombstone 和较晚旧页不会复活消息", () => {\n    const initial = { request: 2, deletedIds: new Set<string>(), messages: [message("a", 1), message("b", 2)] }; const removed = applyMessageDeleted(initial, "b");\n    expect(removed.messages).toMatchObject([{ id: "a" }]); expect(applyMessagePage(removed, 1, [message("b", 2)]).messages).toMatchObject([{ id: "a" }]); expect(applyMessagePage(removed, 3, [message("b", 2), message("c", 3)]).messages).toMatchObject([{ id: "a" }, { id: "c" }]); expect(messageIdFromEvent({ messageId: "b" })).toBe("b");\n  });\n  test("主题通知优先采用宿主 resolved，作者 action 只调用 manifest 声明事件", () => {\n    const emit = vi.fn().mockReturnValue({ interactionId: "i", nonce: "n" }); const bridge = { events: { emit } } as unknown as ChatPlayConversationBridge;\n    expect(resolvedThemeFromEvent({ resolved: "light" })).toBe("light"); expect(resolvedThemeFromEvent({ resolved: "system" })).toBeNull(); expect(emitConfiguredAction(bridge, "story.choose", { choice: "left" }, "i")).toEqual({ interactionId: "i", nonce: "n" }); expect(emit).toHaveBeenCalledWith("story.choose", { choice: "left" }, "i");\n  });\n});\n',
+    },
+    {
+        path: "view/src/styles.css",
+        content: DEFAULT_CHAT_STYLES,
+    },
+    { path: "examples/interaction-demo/install.mjs", content: INTERACTION_DEMO_INSTALLER },
+    { path: "examples/interaction-demo/view-config.ts", content: INTERACTION_DEMO_CONFIG },
+    { path: "examples/interaction-demo/README.md", content: INTERACTION_DEMO_README },
+    { path: "scenario/README.md", content: "# Scenario Part\n\n`source.wes` 是唯一作者源；请通过 GUI、MCP 或 CLI Tool 修改。\n" },
+    { path: "docs/README.md", content: "# 默认玩家视图二开\n\n`view/src/App.tsx` 是聊天中心；`player-panel.tsx` 只在玩家打开功能后读取数据。所有调用先等待 `ChatPlay.ready`。\n\n| 玩家菜单 / 页面 | 公开 SDK | 使用时机 |\n| --- | --- | --- |\n| 对话 | `listMessages`、`sendUserMessage`、消息/流事件 | ready 后独立读取消息；事件只刷新消息 |\n| 标题、主题和语言 | `getScenarioMeta`、`getTheme`/`themeChanged`、`getLocale`/`localeChanged` | 标题读取不得阻断消息；主题读取与通知用版本保护同步外观 |\n| 剧情、资源、已解锁 | `getProgress`、`listAssets`/`getAssetUrl`、`getOwnedResources` | 玩家打开相应面板后才读取 |\n| 角色状态 | `customState.keys`/`customState.get`、配置过的 `getVariable`/`getUnlock` | 使用 canonical custom state，不调用旧 readonly load aliases |\n| 互动选择 | `events.emit` | 仅发 manifest 声明的 action；同步返回不是故事完成回执 |\n| 世界线 | `worldline.list`、`fork`、`activate` | mutation 后清空当前消息、丢弃跨线迟到页，再重读新世界线 |\n| 切换模型 | `openModelSettings()` | host/provider 明确支持时显示；仅玩家点击才请求，调用不携带模型或配置参数 |\n\n默认 `view-config.ts` 保持空白，避免空剧本读取不存在的变量、解锁或 action。若要获得可运行的 TMW interaction、保存变量和解锁读取范例，请先阅读 `examples/interaction-demo/README.md`；该示范只会写入一个新建、未编辑的专用项目。\n\n不要在 View 中调用未公开的宿主 RPC、MCP 或写入状态，也不要在玩家 UI 展示 runtime、bridge、权限或 provider 技术信息。\n" },
+];

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@world-engines/create-project",
+  "version": "0.1.0-alpha.0",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "bin": {
+    "create-worldengine-project": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@world-engines/agent-kit": "0.1.0-alpha.0",
+    "@world-engines/project-format": "0.1.0-alpha.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "worldengine_source_sha256": "0b89a822b9a94e277fdee6c4935202710bd2177944fef360ae9c9d4ae5457bb7",
+  "worldengine_source_identity_provenance": {
+    "schema": "worldengine-public-namespace-projection/v1",
+    "kind": "composite-source-identity; namespace projection; not-full-source-recompile",
+    "original_name": "@worldengine/create-project",
+    "original_archive_sha256": "0850b35ea051ab5c57c87bc90dec998dd9302df5846bd12222e1e019ead2fa5f",
+    "original_source_sha256": "8ac35a1932805fd26785b8383454f9a1a775834a356465cdfb9e990dcbf89da8",
+    "projected_name": "@world-engines/create-project",
+    "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"
+    }
+  }
+}