@easytwin/devkit 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -6,13 +6,6 @@ declare const CONFIG_FILE_NAME = "easytwin.config.json";
 declare const DEFAULT_BASE_URL = "http://saas-twin.k8s.dtstack.cn/";
 /** 官方测试环境域名。 */
 declare const TEST_BASE_URL = "http://172.16.125.3:10100/";
-/**
- * 当前测试 OP 网关缺省头(与编辑器 curl 一致)。配置/环境变量可覆盖。
- * 免网关接口到位后删除(D13)。
- */
-declare const TEST_OP_ACCOUNT_ID = "25";
-declare const TEST_OP_USER_ID = "25";
-declare const TEST_SPACE_ID = "54";
 /**
  * 官方 OSS(twin runtime baseOSSUrl)。系统资产由此拼出:
  * `{ossUrl}/easytwin/system/libs/webp-wasm.wasm`、
@@ -37,10 +30,6 @@ interface EasyTwinConfig {
     baseUrl?: string;
     /** twin runtime 资产根(baseOSSUrl);缺省官方 OSS,可覆盖为 CDN/自建存储。 */
     ossUrl?: string;
-    /** 过渡期 OP 网关头;免网关接口到位后删除(D13)。 */
-    opAccountId?: string;
-    opUserId?: string;
-    spaceId?: string;
     /**
      * 关联场景摘要,由 scene list / 场景树刷新写入(D17)。
      * 不含场景 JSON 本体;下次 list 全量覆盖。
@@ -66,10 +55,6 @@ interface ResolvedConfig {
     /** 本地测试模式:appId/appSecret 均为 "test" 时启用,scene/upload/pull 走本地 mock 不发请求。 */
     mock: boolean;
     source: "file" | "env";
-    /** 过渡期 OP 网关头;env=test 时缺省 25/25/54。免网关接口到位后删除(D13)。 */
-    opAccountId?: string;
-    opUserId?: string;
-    spaceId?: string;
 }
 declare class ConfigError extends Error {
     constructor(message: string);
@@ -100,25 +85,21 @@ declare function initConfig(input: EasyTwinConfig, cwd: string): Promise<InitRes
 declare function writeConfigScenes(cwd: string, scenes: ConfigScene[]): Promise<void>;
 
 /**
- * 认证与路径以内部 swagger 为准(标签:SDK 应用场景 / SDK 应用代码 / SDK Runtime)。
- * 全仓唯一认证头注入点:`x-app-secret` = App Secret。
- * 过渡期另注入 OP 网关头 op-account-id / op-user-id / space-id(D13,免网关接口到位后删除)。
- * 场景/代码路径参数名为 applicationId;DevKit 传入配置里的 App ID。
+ * 认证与路径以内部 swagger 为准(标签:SDK 应用场景 / 分享相关 / SDK 应用代码)。
+ * 全仓唯一认证头注入点:`x-app-id` = App ID,`x-app-secret` = App Secret(D20)。
+ * share 代码与场景列表接口无路径参数(D21 / D22);上传不请求仍走 OP 网关的 workspace-config(D24)。
  */
+declare const APP_ID_HEADER = "x-app-id";
 declare const AUTH_HEADER = "x-app-secret";
-/** 过渡期 OP 网关头;免网关接口到位后删除(D13)。 */
-declare const OP_ACCOUNT_ID_HEADER = "op-account-id";
-declare const OP_USER_ID_HEADER = "op-user-id";
-declare const SPACE_ID_HEADER = "space-id";
 declare const ENDPOINTS: {
-    /** GET 已关联场景列表。 */
-    readonly linkedScenes: (applicationId: string) => string;
-    /** GET 工作区全部代码文件。 */
-    readonly workspaceCode: (applicationId: string) => string;
-    /** GET 工作区文件约束。 */
+    /** POST 已关联场景列表(分享路径,空 body)。 */
+    readonly linkedScenes: () => string;
+    /** POST 拉取工作区全部代码文件(分享路径,空 body)。 */
+    readonly workspaceCodePull: () => string;
+    /** POST 一次推送 create/update/delete(分享路径)。 */
+    readonly workspaceCodePush: () => string;
+    /** GET 工作区文件约束(仍带 applicationId,走 OP 网关;上传不调用,拉取失败则降级)。 */
     readonly workspaceConfig: (applicationId: string) => string;
-    /** POST 新建 / PATCH 批量更新 / DELETE 批量删除。 */
-    readonly workspaceCodeFiles: (applicationId: string) => string;
 };
 declare class EasyTwinApiError extends Error {
     readonly status: number;
@@ -135,14 +116,11 @@ declare class EasyTwinClient {
     readonly baseUrl: string;
     /** twin runtime / 场景快照资产根(baseOSSUrl)。 */
     readonly ossUrl: string;
-    /** 接入凭证 App ID;同时作为场景/代码 API 的 applicationId 路径参数。 */
+    /** 接入凭证 App ID;写入 `x-app-id`,workspace-config 路径仍可用。 */
     readonly appId: string;
     /** 本地测试模式:true 时 scene/upload/pull 走本地 mock,不发网络请求(见 config.ts)。 */
     readonly mock: boolean;
     private readonly appSecret;
-    private readonly opAccountId?;
-    private readonly opUserId?;
-    private readonly spaceId?;
     constructor(config: ResolvedConfig);
     /** 全仓唯一认证头注入点。 */
     private authHeaders;
@@ -251,20 +229,58 @@ interface UploadProgress {
 }
 interface UploadOptions {
     onProgress?: (progress: UploadProgress) => void;
-    /** 自定义忽略规则,默认只跳过 .git。 */
+    /** 额外忽略规则;默认已跳过插件产物与相关文件(D23)。 */
     ignore?: (relPath: string) => boolean;
 }
+interface CollectedFile {
+    relPath: string;
+    absPath: string;
+    size: number;
+}
 interface UploadResult {
     fileCount: number;
     byteCount: number;
+    created: number;
+    updated: number;
+    deleted: number;
+    unchanged: number;
     /** 本地测试模式(dry-run)时置 true:未真正上传。 */
     mock?: boolean;
 }
-interface CollectedFile {
-    relPath: string;
-    absPath: string;
-    size: number;
+interface UploadCreate {
+    file: CollectedFile;
+    content: string;
+}
+interface UploadUpdate {
+    file: CollectedFile;
+    id: string;
+    content: string;
 }
+interface UploadDelete {
+    id: string;
+    filePath: string;
+}
+/** 对照远端文件,本地区分新增 / 更新 / 删除(D21,一次 push)。 */
+interface WorkspaceUploadPlan {
+    creates: UploadCreate[];
+    updates: UploadUpdate[];
+    deletes: UploadDelete[];
+    unchanged: CollectedFile[];
+}
+/** 上传/拉取共同跳过:插件产物、agent 目录、构建产物与凭据。 */
+declare const WORKSPACE_IGNORED_DIRS: Set<string>;
+declare const WORKSPACE_IGNORED_FILES: Set<string>;
+/** 与 push 服务端一致的工作区代码扩展名(D25)。 */
+declare const WORKSPACE_CODE_EXTENSIONS: readonly [".ts", ".tsx", ".js", ".json"];
+/** 工作区本地预览测试文件:不参与 pull/upload(D27)。 */
+declare function isWorkspaceSpecFile(relPath: string): boolean;
+/**
+ * 插件产物、凭据、构建目录与场景快照。
+ * 不含 `*.spec.ts`(预览测试扫描需要读这些文件)。
+ */
+declare function isIgnoredWorkspacePath(relPath: string): boolean;
+/** 跳过插件产物/凭据/场景快照,以及本地预览测试文件 `*.spec.ts`(D23 / D26 / D27)。 */
+declare function defaultWorkspaceIgnore(relPath: string): boolean;
 /** swagger `SdkApplicationWorkspaceCodeConfigVo`。 */
 interface WorkspaceCodeConfig {
     allowedFileExtensions: string[];
@@ -286,12 +302,25 @@ declare function buildMultipartBody(boundary: string, fields: Record<string, str
 declare function normalizePath(relPath: string): string;
 declare function normalizeWorkspaceConfig(data: unknown): WorkspaceCodeConfig;
 declare function normalizeWorkspaceFiles(data: unknown): WorkspaceCodeFile[];
+/** 是否为可同步的工作区代码文件(`.ts` / `.tsx` / `.js` / `.json`)。 */
+declare function isWorkspaceCodeFile(relPath: string): boolean;
 /** 目录深度:根文件为 0,`src/a.ts` 为 1,`src/utils/a.ts` 为 2。 */
 declare function directoryDepth(relPath: string): number;
 declare function assertUploadable(files: CollectedFile[], config: WorkspaceCodeConfig): void;
 /**
- * 全量覆盖上传目录:对照工作区代码文件(GET/POST/PATCH/DELETE)使远端与本地一致。
- * 本地测试模式(mock)时退化为 dry-run。
+ * 对照远端工作区文件,把本地文件分成新增 / 更新 / 删除 / 未变。
+ * 不做本地清单:每次上传以本次 GET 的远端列表为准。
+ */
+declare function planWorkspaceUpload(local: {
+    file: CollectedFile;
+    content: string;
+}[], remote: WorkspaceCodeFile[]): WorkspaceUploadPlan;
+declare function formatUploadResult(result: UploadResult): string;
+/** swagger `PushSdkApplicationWorkspaceCodeDto`:字段均可选,有变更才带上。 */
+declare function buildWorkspacePushBody(plan: WorkspaceUploadPlan): Record<string, unknown> | null;
+/**
+ * 全量对齐上传目录:对照远端工作区,本地 diff 后一次 push(create/update/delete)。
+ * 不请求仍走 OP 网关的 workspace-config(D24);只收集 `.ts`/`.tsx`/`.js`/`.json`(D25)。本地测试模式(mock)时退化为 dry-run。
  */
 declare function uploadDirectory(client: EasyTwinClient, dir: string, options?: UploadOptions): Promise<UploadResult>;
 
@@ -348,10 +377,73 @@ declare function formatWorkspacePullResult(result: WorkspacePullResult): string;
 declare function workspacePullHasConflicts(plan: WorkspacePullPlan): boolean;
 declare function workspacePullPendingWrites(plan: WorkspacePullPlan, force?: boolean): string[];
 
+/** 用户代码固定入口(相对工作区根)。 */
+declare const USER_ENTRY = "src/main.ts";
+/** CLI 缺省输出路径(相对工作区根)。 */
+declare const DEFAULT_BUNDLE_OUT = "dist/main.js";
+/** 白名单允许的裸模块。 */
+declare const RUNTIME_MODULE = "@easytwin/runtime";
+declare const APPS_MODULE = "@easytwin/apps";
+declare class BundleError extends Error {
+    constructor(message: string);
+}
+interface BundleUserCodeOptions {
+    cwd: string;
+    /** 缺省不落盘,只返回产物字符串(插件内存编译);CLI 传入绝对/相对路径。 */
+    outFile?: string;
+}
+interface BundleWorkspaceModuleOptions extends BundleUserCodeOptions {
+    /** 相对 cwd 的入口文件(posix 或当前平台分隔符均可)。 */
+    entry: string;
+    /** 入口缺失时的报错文案;缺省按路径拼一条。 */
+    missingEntryMessage?: string;
+}
+interface BundleResult {
+    code: string;
+    warnings: string[];
+}
+/** 打包工作区任意入口。产物标准 ESM + inline sourcemap;仅允许 @easytwin/runtime 与 @easytwin/apps。 */
+declare function bundleWorkspaceModule(options: BundleWorkspaceModuleOptions): Promise<BundleResult>;
+/** 打包工作区 src/main.ts。产物标准 ESM + inline sourcemap;仅允许 @easytwin/runtime 与 @easytwin/apps。 */
+declare function bundleUserCode(options: BundleUserCodeOptions): Promise<BundleResult>;
+/** 若工作区尚未同步 runtime 类型,返回提示文案;已同步则返回 undefined。 */
+declare function typesMissingHint(cwd: string): Promise<string | undefined>;
+interface SourceMapJson {
+    sources?: string[];
+    mappings?: string;
+}
+declare function extractInlineSourceMap(code: string): SourceMapJson | undefined;
+/**
+ * 把 bundled JS 的 stack(blob: 行号)映射回 TS 源码行号。
+ * 映射失败时原样返回。
+ */
+declare function remapErrorStack(stack: string, bundledCode: string): string;
+
+interface WorkspaceTestCase {
+    /** `${file}:${name}`,文件内唯一。 */
+    id: string;
+    /** 相对工作区根的 posix 路径。 */
+    file: string;
+    name: string;
+    /** 除 ctx 外还有参数时,预览显示输入框。 */
+    hasInput: boolean;
+    /** 第二个参数名,作输入框占位。 */
+    inputName?: string;
+}
+/** 从 spec 源码解析命名导出的函数(跳过 default / type / class / 再导出)。 */
+declare function parseExportedTestFunctions(source: string): Omit<WorkspaceTestCase, "id" | "file">[];
+declare function workspaceTestId(file: string, name: string): string;
+/** 扫描工作区 `*.spec.ts` 的命名导出函数。跳过插件产物目录,不跳过 spec 本身。 */
+declare function listWorkspaceTests(cwd: string): Promise<WorkspaceTestCase[]>;
+declare function bundleWorkspaceTestFile(options: {
+    cwd: string;
+    file: string;
+}): Promise<BundleResult>;
+
 type SyncTarget = "cursor" | "claude" | "codex" | "qoder";
 type SyncTargetArg = SyncTarget | "all";
-/** 六件套清单(5.1),顺序即输出顺序。 */
-declare const SKILL_NAMES: readonly ["easytwin-render", "easytwin-core", "easytwin-develop", "easytwin-bootstrap", "easytwin-scene", "easytwin-upload"];
+/** 七件套清单(5.1),顺序即输出顺序。 */
+declare const SKILL_NAMES: readonly ["easytwin-render", "easytwin-core", "easytwin-develop", "easytwin-bootstrap", "easytwin-scene", "easytwin-upload", "easytwin-test"];
 type SyncAction = "created" | "updated" | "unchanged";
 interface SyncEntrySummary {
     name: string;
@@ -411,40 +503,6 @@ interface SkillsStatus {
 /** 供插件"缺失/过期时提示一次"使用:检测各目标当前同步状态。 */
 declare function detectSkillsStatus(cwd: string, sourceDir?: string): Promise<SkillsStatus>;
 
-/** 用户代码固定入口(相对工作区根)。 */
-declare const USER_ENTRY = "src/main.ts";
-/** CLI 缺省输出路径(相对工作区根)。 */
-declare const DEFAULT_BUNDLE_OUT = "dist/main.js";
-/** 白名单允许的裸模块。 */
-declare const RUNTIME_MODULE = "@easytwin/runtime";
-declare const APPS_MODULE = "@easytwin/apps";
-declare class BundleError extends Error {
-    constructor(message: string);
-}
-interface BundleUserCodeOptions {
-    cwd: string;
-    /** 缺省不落盘,只返回产物字符串(插件内存编译);CLI 传入绝对/相对路径。 */
-    outFile?: string;
-}
-interface BundleResult {
-    code: string;
-    warnings: string[];
-}
-/** 打包工作区 src/main.ts。产物标准 ESM + inline sourcemap;仅允许 @easytwin/runtime 与 @easytwin/apps。 */
-declare function bundleUserCode(options: BundleUserCodeOptions): Promise<BundleResult>;
-/** 若工作区尚未同步 runtime 类型,返回提示文案;已同步则返回 undefined。 */
-declare function typesMissingHint(cwd: string): Promise<string | undefined>;
-interface SourceMapJson {
-    sources?: string[];
-    mappings?: string;
-}
-declare function extractInlineSourceMap(code: string): SourceMapJson | undefined;
-/**
- * 把 bundled JS 的 stack(blob: 行号)映射回 TS 源码行号。
- * 映射失败时原样返回。
- */
-declare function remapErrorStack(stack: string, bundledCode: string): string;
-
 /** 在线 TwinApp 编译 stub 露出的 `@easytwin/runtime` 导出名。本地整包 external,超出此集合只 warning。 */
 declare const PORTABLE_RUNTIME_EXPORTS: readonly ["THREE", "RuntimeEngine", "SceneManager", "LoadSceneMode", "convertObjToComponentJson"];
 type PortableRuntimeExport = (typeof PORTABLE_RUNTIME_EXPORTS)[number];
@@ -566,6 +624,9 @@ declare class TwinAppPreviewHost {
     private readonly onEngineTick;
     constructor(options: TwinAppPreviewHostOptions);
     getEngine(): TwinAppEngine | null;
+    /** 给 spec 调用:场景字段取当前引擎主场景(不要求已 Run TwinApp)。 */
+    getTestContext(): TwinAppContext;
+    invokeTest(fn: (ctx: TwinAppContext, input?: string) => unknown, input?: string): Promise<unknown>;
     boot(): Promise<void>;
     run(code: string): Promise<void>;
     dispose(): Promise<void>;
@@ -583,4 +644,40 @@ declare class TwinAppPreviewHost {
     private getContext;
 }
 
-export { APPS_DTS, APPS_MODULE, APPS_TYPES_FILE, AUTH_HEADER, BundleError, type BundleResult, type BundleUserCodeOptions, CODEX_MARKER_BEGIN, CODEX_MARKER_END, CONFIG_FILE_NAME, type CollectedFile, ConfigError, type ConfigScene, DEFAULT_BASE_URL, DEFAULT_BUNDLE_OUT, DEFAULT_ENTRY_PATH, DEFAULT_MAIN_TS, DEFAULT_OSS_URL, EASYTWIN_TYPES_DIR, ENDPOINTS, EXAMPLE_SCENE_FILE, EasyTwinApiError, EasyTwinClient, type EasyTwinConfig, type EasyTwinEnv, GITIGNORE_ENTRY, GITIGNORE_FILE_NAME, type GitignoreResult, type InitResult, LOCAL_LOAD_SCENE_ERROR, type LinkedScene, META_FILE_NAME, MINIMAL_TSCONFIG, MISSING_TICK_ERROR, MOCK_APP_ID, MOCK_APP_SECRET, MOCK_SCENE_NAME, OP_ACCOUNT_ID_HEADER, OP_USER_ID_HEADER, PORTABLE_RUNTIME_EXPORTS, type PortableRuntimeExport, RUNTIME_MODULE, type RequestOptions, type ResolvedConfig, SKILL_NAMES, SPACE_ID_HEADER, type SceneDetail, type SceneSummary, type SceneTreeNode, type SkillsStatus, type SkillsTargetStatus, type SyncAction, type SyncEntrySummary, type SyncOptions, type SyncSkillsResult, type SyncSummary, type SyncTarget, type SyncTargetArg, TEST_BASE_URL, TEST_OP_ACCOUNT_ID, TEST_OP_USER_ID, TEST_SPACE_ID, TSCONFIG_PATHS_HINT, TwinApp, type TwinAppContext, type TwinAppEngine, TwinAppPreviewHost, type TwinAppPreviewHostOptions, type TwinAppRuntimeModule, type TwinAppRuntimeScene, type TwinAppSceneManager, type TwinAppTickListener, type TypesSyncSummary, USER_ENTRY, type UploadOptions, type UploadProgress, type UploadResult, type WorkspaceChangeKind, type WorkspaceCodeConfig, type WorkspaceCodeFile, type WorkspaceFileChange, type WorkspacePullApplyResult, type WorkspacePullOptions, type WorkspacePullPlan, type WorkspacePullResult, appendGitignore, applyWorkspacePull, assertUploadable, buildMultipartBody, buildRuntimeTypesContent, bundleUserCode, collectFiles, configFilePath, createAppInstance, defaultPullIgnore, defineApp, deriveExampleSceneId, detectSkillsStatus, directoryDepth, exampleSceneSummary, extractInlineSourceMap, extractSceneArray, formatWorkspacePullPlan, formatWorkspacePullResult, initConfig, isMockCredentials, isSafeRelPath, listScenes, loadConfig, loadExampleScene, normalizeLinkedScenes, normalizePath, normalizeSceneList, normalizeTargets, normalizeWorkspaceConfig, normalizeWorkspaceFiles, parseConfig, parseSceneStructure, planWorkspacePull, portableRuntimeWarning, pullScene, pullWorkspace, readConfigFile, readDevkitVersion, remapErrorStack, resolveConfig, resolveExampleScenePath, resolveRuntimeTypesSourceFile, resolveSkillsSourceDir, resolveSnapshotUrl, resolveWorkspaceAssetPath, saveSceneJson, syncSkills, toConfigScenes, typesMissingHint, uploadDirectory, validateConfigShape, workspacePullHasConflicts, workspacePullPendingWrites, writeConfigFile, writeConfigScenes };
+type PreviewHostKind = "vscode" | "http";
+/**
+ * 纯函数:构造场景预览页 HTML(插件 webview 与 CLI localhost HTTP 共用,D28)。
+ * 单栏三维场景页:module script 动态 import twin runtime,
+ * 用场景数据经 convertObjToComponentJson + RuntimeEngine.create + loadScene 真实渲染。
+ * baseOSSUrl 必须是 ossUrl(缺省官方 OSS),不是 API baseUrl。
+ * host=vscode 且页面为 HTTPS 时,HTTP 资源经扩展宿主代理,规避 mixed content。
+ * host=http(CLI preview)时直连 API 与 OSS,走同源 `/api/*` 做 bundle/tests/assets。
+ * 底部 Run 走 TwinAppPreviewHost(D14):import map 注入 @easytwin/runtime 与 @easytwin/apps。
+ * 工作区 *.spec.ts 命名导出在 Run 栏上方列出(D27)。
+ */
+declare function escapeHtml(text: string): string;
+/**
+ * 把 JSON 文本安全嵌入 `<script type="application/json">`。
+ * script 元素的内容是 raw text,HTML 实体不会解码,因此不能使用 escapeHtml;
+ * 只需把 `<`/`>` 与 U+2028/U+2029 转成 JSON 字面转义。
+ */
+declare function escapeJsonForScript(json: string): string;
+/** 纯状态页:预览加载中 / 加载失败时的兜底内容,避免空白 webview。 */
+declare function buildStatusHtml(message: string): string;
+declare function buildPreviewHtml(options: {
+    baseUrl: string;
+    ossUrl: string;
+    sceneJson: string;
+    mock?: boolean;
+    runtimeUri: string;
+    appsUri?: string;
+    hostUri?: string;
+    appId?: string;
+    /** vscode=webview postMessage+混合内容代理;http=CLI 同源 /api/*。缺省 vscode。 */
+    host?: PreviewHostKind;
+    /** VSCode webview.cspSource;缺省回退 runtimeUri 的 origin(单测用)。 */
+    cspSource?: string;
+    tests?: WorkspaceTestCase[];
+}): string;
+
+export { APPS_DTS, APPS_MODULE, APPS_TYPES_FILE, APP_ID_HEADER, AUTH_HEADER, BundleError, type BundleResult, type BundleUserCodeOptions, type BundleWorkspaceModuleOptions, CODEX_MARKER_BEGIN, CODEX_MARKER_END, CONFIG_FILE_NAME, type CollectedFile, ConfigError, type ConfigScene, DEFAULT_BASE_URL, DEFAULT_BUNDLE_OUT, DEFAULT_ENTRY_PATH, DEFAULT_MAIN_TS, DEFAULT_OSS_URL, EASYTWIN_TYPES_DIR, ENDPOINTS, EXAMPLE_SCENE_FILE, EasyTwinApiError, EasyTwinClient, type EasyTwinConfig, type EasyTwinEnv, GITIGNORE_ENTRY, GITIGNORE_FILE_NAME, type GitignoreResult, type InitResult, LOCAL_LOAD_SCENE_ERROR, type LinkedScene, META_FILE_NAME, MINIMAL_TSCONFIG, MISSING_TICK_ERROR, MOCK_APP_ID, MOCK_APP_SECRET, MOCK_SCENE_NAME, PORTABLE_RUNTIME_EXPORTS, type PortableRuntimeExport, type PreviewHostKind, RUNTIME_MODULE, type RequestOptions, type ResolvedConfig, SKILL_NAMES, type SceneDetail, type SceneSummary, type SceneTreeNode, type SkillsStatus, type SkillsTargetStatus, type SyncAction, type SyncEntrySummary, type SyncOptions, type SyncSkillsResult, type SyncSummary, type SyncTarget, type SyncTargetArg, TEST_BASE_URL, TSCONFIG_PATHS_HINT, TwinApp, type TwinAppContext, type TwinAppEngine, TwinAppPreviewHost, type TwinAppPreviewHostOptions, type TwinAppRuntimeModule, type TwinAppRuntimeScene, type TwinAppSceneManager, type TwinAppTickListener, type TypesSyncSummary, USER_ENTRY, type UploadCreate, type UploadDelete, type UploadOptions, type UploadProgress, type UploadResult, type UploadUpdate, WORKSPACE_CODE_EXTENSIONS, WORKSPACE_IGNORED_DIRS, WORKSPACE_IGNORED_FILES, type WorkspaceChangeKind, type WorkspaceCodeConfig, type WorkspaceCodeFile, type WorkspaceFileChange, type WorkspacePullApplyResult, type WorkspacePullOptions, type WorkspacePullPlan, type WorkspacePullResult, type WorkspaceTestCase, type WorkspaceUploadPlan, appendGitignore, applyWorkspacePull, assertUploadable, buildMultipartBody, buildPreviewHtml, buildRuntimeTypesContent, buildStatusHtml, buildWorkspacePushBody, bundleUserCode, bundleWorkspaceModule, bundleWorkspaceTestFile, collectFiles, configFilePath, createAppInstance, defaultPullIgnore, defaultWorkspaceIgnore, defineApp, deriveExampleSceneId, detectSkillsStatus, directoryDepth, escapeHtml, escapeJsonForScript, exampleSceneSummary, extractInlineSourceMap, extractSceneArray, formatUploadResult, formatWorkspacePullPlan, formatWorkspacePullResult, initConfig, isIgnoredWorkspacePath, isMockCredentials, isSafeRelPath, isWorkspaceCodeFile, isWorkspaceSpecFile, listScenes, listWorkspaceTests, loadConfig, loadExampleScene, normalizeLinkedScenes, normalizePath, normalizeSceneList, normalizeTargets, normalizeWorkspaceConfig, normalizeWorkspaceFiles, parseConfig, parseExportedTestFunctions, parseSceneStructure, planWorkspacePull, planWorkspaceUpload, portableRuntimeWarning, pullScene, pullWorkspace, readConfigFile, readDevkitVersion, remapErrorStack, resolveConfig, resolveExampleScenePath, resolveRuntimeTypesSourceFile, resolveSkillsSourceDir, resolveSnapshotUrl, resolveWorkspaceAssetPath, saveSceneJson, syncSkills, toConfigScenes, typesMissingHint, uploadDirectory, validateConfigShape, workspacePullHasConflicts, workspacePullPendingWrites, workspaceTestId, writeConfigFile, writeConfigScenes };