@vgai/editor-sdk 0.5.19 → 0.5.20

package/package.json

@@ -2,7 +2,7 @@
   "name": "@vgai/editor-sdk",
   "author": "Volter AI, Inc.",
   "license": "Apache-2.0",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "type": "module",
   "repository": {
     "type": "git",
@@ -23,7 +23,7 @@
   },
   "dependencies": {
     "@types/three": "^0.180.0",
-    "@vgai/sdk": "0.5.19"
+    "@vgai/sdk": "0.5.20"
   },
   "peerDependencies": {
     "@vgai/engine": "*",

package/src/editor-view.ts

@@ -1,5 +1,5 @@
 import type { AssetKind, EditorCameraState, EditorView, ViewPreset } from './types.js';
-import { EDITOR_VIEW_WORKSPACE_DOCUMENT_IDS } from './types.js';
+import { EDITOR_VIEW_WORKSPACE_DOCUMENT_IDS, isEditorViewUtility } from './types.js';
 
 const PREFIX = 'view.';
 const MAX_QUERY_LENGTH = 4096;
@@ -21,7 +21,6 @@ const CAMERAS = new Set<ViewPreset | 'isometric'>([
   'isometric',
 ]);
 type EditorViewDiagnostic = NonNullable<NonNullable<EditorView['viewport']>['diagnostic']>;
-type EditorViewUtility = NonNullable<EditorView['utility']>;
 const DIAGNOSTICS = new Set<EditorViewDiagnostic>([
   'solid',
   'unlit',
@@ -33,13 +32,6 @@ const DIAGNOSTICS = new Set<EditorViewDiagnostic>([
   'bounds',
   'skeleton',
 ]);
-const UTILITIES = new Set<EditorViewUtility>([
-  'profiler',
-  'console',
-  'animation',
-  'light-explorer',
-]);
-
 function nonEmpty(value: string | null): string | null {
   const trimmed = value?.trim();
   return trimmed ? trimmed : null;
@@ -210,9 +202,10 @@ export function editorViewFromUrl(value: string | URL): EditorView | null {
   if (ids.length) view.selection = { ids, focus: params.get(`${PREFIX}focus`) === '1' };
   const viewport = parseViewport(params);
   if (viewport) view.viewport = viewport;
+  // Shape check only: a `tool:` id names a utility the OPEN PROJECT
+  // contributes, so the URL cannot know whether it exists. The editor
+  // validates it against its live registry when the view is presented.
   const utility = params.get(`${PREFIX}utility`);
-  if (utility && UTILITIES.has(utility as EditorViewUtility)) {
-    view.utility = utility as EditorViewUtility;
-  }
+  if (utility && isEditorViewUtility(utility)) view.utility = utility;
   return view;
 }

package/src/index.ts

@@ -51,7 +51,9 @@ export type {
   EditorEntitySummary,
   EditorState,
   EditorView,
+  EditorViewBuiltInUtilityId,
   EditorViewDocument,
+  EditorViewUtility,
   GameCapture,
   GameplayRecordingCapture,
   GameplayRecordingOptions,
@@ -93,3 +95,8 @@ export type {
   ViewportCapture,
   ViewportTab,
 } from './types.js';
+export {
+  EDITOR_VIEW_BUILT_IN_UTILITY_IDS,
+  EDITOR_VIEW_TOOL_UTILITY_PREFIX,
+  isEditorViewUtility,
+} from './types.js';

package/src/types.ts

@@ -670,6 +670,53 @@ export const EDITOR_VIEW_WORKSPACE_DOCUMENT_IDS = [
 
 export type EditorViewWorkspaceDocumentId = (typeof EDITOR_VIEW_WORKSPACE_DOCUMENT_IDS)[number];
 
+/**
+ * The editor's OWN bottom-drawer instruments, as named in a shareable view.
+ * One runtime list owns both URL parsing and the public id type — the same
+ * discipline as {@link EDITOR_VIEW_WORKSPACE_DOCUMENT_IDS}, and for the same
+ * reason: a separate hand-written union and parser allowlist drift silently
+ * (`behavior` was in the union and missing from the allowlist, so a view
+ * carrying it round-tripped to nothing).
+ */
+export const EDITOR_VIEW_BUILT_IN_UTILITY_IDS = [
+  'profiler',
+  'console',
+  'animation',
+  'behavior',
+  'light-explorer',
+] as const;
+
+export type EditorViewBuiltInUtilityId = (typeof EDITOR_VIEW_BUILT_IN_UTILITY_IDS)[number];
+
+/** The prefix a PROJECT-contributed utility's id carries. The editor's tool
+ *  loader namespaces every `workspace.utility` contribution as
+ *  `tool:<contribution-id>`, exactly as a contributed center document is
+ *  addressed by `{ kind: 'tool', id }`. */
+export const EDITOR_VIEW_TOOL_UTILITY_PREFIX = 'tool:';
+
+/**
+ * Which bottom-drawer utility a view reveals: one of the editor's own
+ * instruments, or a utility the OPEN PROJECT contributes.
+ *
+ * The project half cannot be an enum — which tabs exist depends entirely on
+ * the game that is open — so the address space admits the namespace and the
+ * EDITOR validates the id against its live utility registry when the view is
+ * presented, refusing an unregistered one by naming what IS registered.
+ */
+export type EditorViewUtility =
+  | EditorViewBuiltInUtilityId
+  | `${typeof EDITOR_VIEW_TOOL_UTILITY_PREFIX}${string}`;
+
+/** Whether `value` is addressable as a view's utility. Shape only — existence
+ *  is the editor's answer at present-time, not the URL's. */
+export function isEditorViewUtility(value: string): value is EditorViewUtility {
+  return (
+    (EDITOR_VIEW_BUILT_IN_UTILITY_IDS as readonly string[]).includes(value) ||
+    (value.startsWith(EDITOR_VIEW_TOOL_UTILITY_PREFIX) &&
+      value.length > EDITOR_VIEW_TOOL_UTILITY_PREFIX.length)
+  );
+}
+
 /**
  * A durable, intentionally small projection of what an editor is presenting.
  * This is not workspace persistence: panel sizes, transient tool state, and
@@ -699,7 +746,7 @@ export interface EditorView {
     frame?: 'document' | 'selection';
     grid?: boolean;
   };
-  utility?: 'profiler' | 'console' | 'animation' | 'behavior' | 'light-explorer';
+  utility?: EditorViewUtility;
 }
 
 export interface PresentedEditorView {