@fps-games/editor 0.2.1-beta.3 → 0.2.1-beta.4

package/dist/editor-commands/capabilities/transform.d.ts

@@ -0,0 +1,5 @@
+import type { LocalEditorCommandTransformSource } from '../source-types.js';
+import { type LocalEditorCommandCapabilitySourceOperations, type LocalEditorCommandHarnessState } from '../shared.js';
+import type { LocalEditorHarnessOptions } from '../../local-editor-harness.js';
+export declare function createLocalEditorCommandTransformSource<TDocument, TPatch, TAsset>(state: LocalEditorCommandHarnessState<TDocument, TPatch>, options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>, renderUi: () => void, operations: LocalEditorCommandCapabilitySourceOperations<TDocument>): LocalEditorCommandTransformSource;
+//# sourceMappingURL=transform.d.ts.map

package/dist/editor-commands/capabilities/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/editor-commands/capabilities/transform.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAKL,KAAK,4CAA4C,EACjD,KAAK,8BAA8B,EACpC,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,wBAAgB,uCAAuC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAC/E,KAAK,EAAE,8BAA8B,CAAC,SAAS,EAAE,MAAM,CAAC,EACxD,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7D,QAAQ,EAAE,MAAM,IAAI,EACpB,UAAU,EAAE,4CAA4C,CAAC,SAAS,CAAC,GAClE,iCAAiC,CASnC"}

package/dist/editor-commands/capabilities/transform.js

@@ -0,0 +1,164 @@
+import { isEditorTransformTrsSnapshot, } from '@fps-games/editor-core';
+import { EDITOR_COMMAND_ID, } from '@fps-games/editor-protocol';
+import { cloneVec3, createLocalEditorCommandFailure, editorTransformSnapshotToAgentTransform, isLocalEditorCommandVec3, } from '../diagnostics.js';
+import { cloneEditorCommandSelection, getEditorCommandSafeSceneSelection, isEditorCommandDocumentNodeSelectable, isEditorCommandSafeSceneObjectId, } from '../shared.js';
+export function createLocalEditorCommandTransformSource(state, options, renderUi, operations) {
+    return {
+        move(input) {
+            return moveEditorCommandObject(state, options, input, renderUi, operations);
+        },
+        set(input) {
+            return setEditorCommandObjectTransform(state, options, input, renderUi, operations);
+        },
+    };
+}
+function moveEditorCommandObject(state, options, input, renderUi, operations) {
+    const objectId = typeof input?.objectId === 'string' ? input.objectId.trim() : '';
+    if (!objectId) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, 'transform.move requires objectId.', { code: 'transform.invalidInput' });
+    }
+    const hasPosition = input.position !== undefined;
+    const hasOffset = input.offset !== undefined;
+    if (hasPosition === hasOffset) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, 'transform.move requires exactly one of position or offset.', { code: 'transform.invalidInput', objectId });
+    }
+    const movePosition = hasPosition && isLocalEditorCommandVec3(input.position) ? input.position : null;
+    const moveOffset = hasOffset && isLocalEditorCommandVec3(input.offset) ? input.offset : null;
+    if ((hasPosition && !movePosition) || (hasOffset && !moveOffset)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, 'transform.move position or offset must be a finite Vec3.', { code: 'transform.invalidVec3', objectId });
+    }
+    if (state.mode !== 'editor' || !state.session) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, 'Editor is not in edit mode.', { code: 'editor.notReady', objectId });
+    }
+    const document = state.session.getState({ cloneDocuments: false }).workingDocument;
+    if (!isEditorCommandSafeSceneObjectId(operations, objectId)
+        || !isEditorCommandDocumentNodeSelectable(options, document, objectId)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, `Object is not movable: ${objectId}`, { code: 'transform.notSelectable', objectId });
+    }
+    const before = state.projection?.readNodeTransform(objectId) ?? null;
+    if (!before || !isEditorTransformTrsSnapshot(before)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, `Object does not have an editable TRS transform: ${objectId}`, { code: 'transform.unsupported', objectId });
+    }
+    const after = operations.cloneTransformSnapshot(before);
+    if (!isEditorTransformTrsSnapshot(after)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_MOVE, `Object does not have an editable TRS transform: ${objectId}`, { code: 'transform.unsupported', objectId });
+    }
+    after.position = movePosition
+        ? cloneVec3(movePosition)
+        : addEditorCommandVec3(after.position, moveOffset);
+    return dispatchEditorCommandTransformPatch(state, options, {
+        capabilityId: EDITOR_COMMAND_ID.TRANSFORM_MOVE,
+        objectId,
+        before,
+        after,
+        tool: 'move',
+        label: `Agent move ${objectId}`,
+    }, renderUi, operations);
+}
+function setEditorCommandObjectTransform(state, options, input, renderUi, operations) {
+    const objectId = typeof input?.objectId === 'string' ? input.objectId.trim() : '';
+    if (!objectId) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, 'transform.set requires objectId.', { code: 'transform.invalidInput' });
+    }
+    const hasPosition = input.position !== undefined;
+    const hasRotation = input.rotation !== undefined;
+    const hasScale = input.scale !== undefined;
+    if (!hasPosition && !hasRotation && !hasScale) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, 'transform.set requires at least one of position, rotation, or scale.', { code: 'transform.invalidInput', objectId });
+    }
+    const position = hasPosition && isLocalEditorCommandVec3(input.position) ? input.position : null;
+    const rotation = hasRotation && isLocalEditorCommandVec3(input.rotation) ? input.rotation : null;
+    const scale = hasScale && isLocalEditorCommandVec3(input.scale) ? input.scale : null;
+    if ((hasPosition && !position) || (hasRotation && !rotation) || (hasScale && !scale)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, 'transform.set position, rotation, and scale must be finite Vec3 values when provided.', { code: 'transform.invalidVec3', objectId });
+    }
+    if (state.mode !== 'editor' || !state.session) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, 'Editor is not in edit mode.', { code: 'editor.notReady', objectId });
+    }
+    const document = state.session.getState({ cloneDocuments: false }).workingDocument;
+    if (!isEditorCommandSafeSceneObjectId(operations, objectId)
+        || !isEditorCommandDocumentNodeSelectable(options, document, objectId)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, `Object is not transformable: ${objectId}`, { code: 'transform.notSelectable', objectId });
+    }
+    const before = state.projection?.readNodeTransform(objectId) ?? null;
+    if (!before || !isEditorTransformTrsSnapshot(before)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, `Object does not have an editable TRS transform: ${objectId}`, { code: 'transform.unsupported', objectId });
+    }
+    const after = operations.cloneTransformSnapshot(before);
+    if (!isEditorTransformTrsSnapshot(after)) {
+        return createLocalEditorCommandFailure(EDITOR_COMMAND_ID.TRANSFORM_SET, `Object does not have an editable TRS transform: ${objectId}`, { code: 'transform.unsupported', objectId });
+    }
+    if (position)
+        after.position = cloneVec3(position);
+    if (rotation)
+        after.rotation = cloneVec3(rotation);
+    if (scale)
+        after.scale = cloneVec3(scale);
+    return dispatchEditorCommandTransformPatch(state, options, {
+        capabilityId: EDITOR_COMMAND_ID.TRANSFORM_SET,
+        objectId,
+        before,
+        after,
+        tool: position ? 'move' : rotation ? 'rotate' : 'scale',
+        label: `Agent set transform ${objectId}`,
+    }, renderUi, operations);
+}
+function dispatchEditorCommandTransformPatch(state, options, input, renderUi, operations) {
+    const { capabilityId, objectId, before, after, tool, label } = input;
+    if (state.mode !== 'editor' || !state.session) {
+        return createLocalEditorCommandFailure(capabilityId, 'Editor is not in edit mode.', { code: 'editor.notReady', objectId });
+    }
+    const document = state.session.getState({ cloneDocuments: false }).workingDocument;
+    const patch = options.documentAdapter.createTransformPatch?.({
+        document,
+        targetId: objectId,
+        tool,
+        space: 'world',
+        constraint: 'free',
+        before,
+        after,
+    });
+    if (!patch) {
+        return createLocalEditorCommandFailure(capabilityId, `Transform patch was not created for object: ${objectId}`, { code: 'transform.patchUnavailable', objectId });
+    }
+    const result = state.session.dispatch({
+        type: 'document.patch',
+        label: patch.label ?? `Agent move ${objectId}`,
+        patch: patch.patch,
+        targetId: objectId,
+        ...operations.withProjectionImpact(operations.resolveProjectionImpact(patch, patch.reprojectIds?.length
+            ? operations.createReprojectProjectionImpact(patch.reprojectIds)
+            : operations.createTransformProjectionImpact([patch.changedId ?? objectId]))),
+    });
+    if (!result.documentChanged) {
+        return createLocalEditorCommandFailure(capabilityId, `Transform was unchanged for object: ${objectId}`, { code: 'transform.unchanged', objectId });
+    }
+    if (patch.reprojectIds?.length)
+        operations.reprojectProjectionForChangedIds(result.workingDocument, patch.reprojectIds);
+    else
+        operations.syncProjectionForChangedIds(result.workingDocument, [patch.changedId ?? objectId]);
+    state.summary = operations.summarizeDocument(result.workingDocument, state.session.getSource());
+    state.status = patch.label ?? label;
+    operations.dispatchSelectionCommand({
+        type: 'selection.replace',
+        selectedIds: [objectId],
+        activeId: objectId,
+        label,
+    });
+    renderUi();
+    const updated = state.projection?.readNodeTransform(objectId) ?? after;
+    return {
+        objectId,
+        before: editorTransformSnapshotToAgentTransform(before) ?? {},
+        after: editorTransformSnapshotToAgentTransform(updated) ?? {},
+        selection: cloneEditorCommandSelection(getEditorCommandSafeSceneSelection(operations)),
+    };
+}
+function addEditorCommandVec3(left, right) {
+    return {
+        x: left.x + right.x,
+        y: left.y + right.y,
+        z: left.z + right.z,
+    };
+}
+//# sourceMappingURL=transform.js.map

package/dist/editor-commands/capabilities/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../src/editor-commands/capabilities/transform.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  type EditorTransformSnapshot,\n  type EditorTransformTool,\n  isEditorTransformTrsSnapshot,\n} from '@fps-games/editor-core';\nimport {\n  EDITOR_COMMAND_ID,\n  type EditorCommandTransformMoveOutput,\n  type EditorCommandVec3,\n} from '@fps-games/editor-protocol';\nimport {\n  cloneVec3,\n  createLocalEditorCommandFailure,\n  editorTransformSnapshotToAgentTransform,\n  isLocalEditorCommandVec3,\n} from '../diagnostics.js';\nimport type { LocalEditorCommandTransformSource } from '../source-types.js';\nimport {\n  cloneEditorCommandSelection,\n  getEditorCommandSafeSceneSelection,\n  isEditorCommandDocumentNodeSelectable,\n  isEditorCommandSafeSceneObjectId,\n  type LocalEditorCommandCapabilitySourceOperations,\n  type LocalEditorCommandHarnessState,\n} from '../shared.js';\nimport type { LocalEditorHarnessOptions } from '../../local-editor-harness.js';\n\nexport function createLocalEditorCommandTransformSource<TDocument, TPatch, TAsset>(\n  state: LocalEditorCommandHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  renderUi: () => void,\n  operations: LocalEditorCommandCapabilitySourceOperations<TDocument>,\n): LocalEditorCommandTransformSource {\n  return {\n    move(input) {\n      return moveEditorCommandObject(state, options, input, renderUi, operations);\n    },\n    set(input) {\n      return setEditorCommandObjectTransform(state, options, input, renderUi, operations);\n    },\n  };\n}\n\nfunction moveEditorCommandObject<TDocument, TPatch, TAsset>(\n  state: LocalEditorCommandHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  input: { objectId?: string; position?: unknown; offset?: unknown },\n  renderUi: () => void,\n  operations: LocalEditorCommandCapabilitySourceOperations<TDocument>,\n): ReturnType<LocalEditorCommandTransformSource['move']> {\n  const objectId = typeof input?.objectId === 'string' ? input.objectId.trim() : '';\n  if (!objectId) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      'transform.move requires objectId.',\n      { code: 'transform.invalidInput' },\n    );\n  }\n  const hasPosition = input.position !== undefined;\n  const hasOffset = input.offset !== undefined;\n  if (hasPosition === hasOffset) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      'transform.move requires exactly one of position or offset.',\n      { code: 'transform.invalidInput', objectId },\n    );\n  }\n  const movePosition = hasPosition && isLocalEditorCommandVec3(input.position) ? input.position : null;\n  const moveOffset = hasOffset && isLocalEditorCommandVec3(input.offset) ? input.offset : null;\n  if ((hasPosition && !movePosition) || (hasOffset && !moveOffset)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      'transform.move position or offset must be a finite Vec3.',\n      { code: 'transform.invalidVec3', objectId },\n    );\n  }\n  if (state.mode !== 'editor' || !state.session) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      'Editor is not in edit mode.',\n      { code: 'editor.notReady', objectId },\n    );\n  }\n  const document = state.session.getState({ cloneDocuments: false }).workingDocument;\n  if (!isEditorCommandSafeSceneObjectId(operations, objectId)\n    || !isEditorCommandDocumentNodeSelectable(options, document, objectId)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      `Object is not movable: ${objectId}`,\n      { code: 'transform.notSelectable', objectId },\n    );\n  }\n  const before = state.projection?.readNodeTransform(objectId) ?? null;\n  if (!before || !isEditorTransformTrsSnapshot(before)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      `Object does not have an editable TRS transform: ${objectId}`,\n      { code: 'transform.unsupported', objectId },\n    );\n  }\n  const after = operations.cloneTransformSnapshot(before);\n  if (!isEditorTransformTrsSnapshot(after)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      `Object does not have an editable TRS transform: ${objectId}`,\n      { code: 'transform.unsupported', objectId },\n    );\n  }\n  after.position = movePosition\n    ? cloneVec3(movePosition)\n    : addEditorCommandVec3(after.position, moveOffset!);\n  return dispatchEditorCommandTransformPatch(\n    state,\n    options,\n    {\n      capabilityId: EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      objectId,\n      before,\n      after,\n      tool: 'move',\n      label: `Agent move ${objectId}`,\n    },\n    renderUi,\n    operations,\n  );\n}\n\nfunction setEditorCommandObjectTransform<TDocument, TPatch, TAsset>(\n  state: LocalEditorCommandHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  input: { objectId?: string; position?: unknown; rotation?: unknown; scale?: unknown },\n  renderUi: () => void,\n  operations: LocalEditorCommandCapabilitySourceOperations<TDocument>,\n): ReturnType<LocalEditorCommandTransformSource['set']> {\n  const objectId = typeof input?.objectId === 'string' ? input.objectId.trim() : '';\n  if (!objectId) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      'transform.set requires objectId.',\n      { code: 'transform.invalidInput' },\n    );\n  }\n  const hasPosition = input.position !== undefined;\n  const hasRotation = input.rotation !== undefined;\n  const hasScale = input.scale !== undefined;\n  if (!hasPosition && !hasRotation && !hasScale) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      'transform.set requires at least one of position, rotation, or scale.',\n      { code: 'transform.invalidInput', objectId },\n    );\n  }\n  const position = hasPosition && isLocalEditorCommandVec3(input.position) ? input.position : null;\n  const rotation = hasRotation && isLocalEditorCommandVec3(input.rotation) ? input.rotation : null;\n  const scale = hasScale && isLocalEditorCommandVec3(input.scale) ? input.scale : null;\n  if ((hasPosition && !position) || (hasRotation && !rotation) || (hasScale && !scale)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      'transform.set position, rotation, and scale must be finite Vec3 values when provided.',\n      { code: 'transform.invalidVec3', objectId },\n    );\n  }\n  if (state.mode !== 'editor' || !state.session) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      'Editor is not in edit mode.',\n      { code: 'editor.notReady', objectId },\n    );\n  }\n  const document = state.session.getState({ cloneDocuments: false }).workingDocument;\n  if (!isEditorCommandSafeSceneObjectId(operations, objectId)\n    || !isEditorCommandDocumentNodeSelectable(options, document, objectId)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      `Object is not transformable: ${objectId}`,\n      { code: 'transform.notSelectable', objectId },\n    );\n  }\n  const before = state.projection?.readNodeTransform(objectId) ?? null;\n  if (!before || !isEditorTransformTrsSnapshot(before)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      `Object does not have an editable TRS transform: ${objectId}`,\n      { code: 'transform.unsupported', objectId },\n    );\n  }\n  const after = operations.cloneTransformSnapshot(before);\n  if (!isEditorTransformTrsSnapshot(after)) {\n    return createLocalEditorCommandFailure(\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      `Object does not have an editable TRS transform: ${objectId}`,\n      { code: 'transform.unsupported', objectId },\n    );\n  }\n  if (position) after.position = cloneVec3(position);\n  if (rotation) after.rotation = cloneVec3(rotation);\n  if (scale) after.scale = cloneVec3(scale);\n  return dispatchEditorCommandTransformPatch(\n    state,\n    options,\n    {\n      capabilityId: EDITOR_COMMAND_ID.TRANSFORM_SET,\n      objectId,\n      before,\n      after,\n      tool: position ? 'move' : rotation ? 'rotate' : 'scale',\n      label: `Agent set transform ${objectId}`,\n    },\n    renderUi,\n    operations,\n  );\n}\n\nfunction dispatchEditorCommandTransformPatch<TDocument, TPatch, TAsset>(\n  state: LocalEditorCommandHarnessState<TDocument, TPatch>,\n  options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>,\n  input: {\n    capabilityId: string;\n    objectId: string;\n    before: EditorTransformSnapshot;\n    after: EditorTransformSnapshot;\n    tool: Exclude<EditorTransformTool, 'select'>;\n    label: string;\n  },\n  renderUi: () => void,\n  operations: LocalEditorCommandCapabilitySourceOperations<TDocument>,\n): EditorCommandTransformMoveOutput | ReturnType<typeof createLocalEditorCommandFailure> {\n  const { capabilityId, objectId, before, after, tool, label } = input;\n  if (state.mode !== 'editor' || !state.session) {\n    return createLocalEditorCommandFailure(\n      capabilityId,\n      'Editor is not in edit mode.',\n      { code: 'editor.notReady', objectId },\n    );\n  }\n  const document = state.session.getState({ cloneDocuments: false }).workingDocument;\n  const patch = options.documentAdapter.createTransformPatch?.({\n    document,\n    targetId: objectId,\n    tool,\n    space: 'world',\n    constraint: 'free',\n    before,\n    after,\n  });\n  if (!patch) {\n    return createLocalEditorCommandFailure(\n      capabilityId,\n      `Transform patch was not created for object: ${objectId}`,\n      { code: 'transform.patchUnavailable', objectId },\n    );\n  }\n  const result = state.session.dispatch({\n    type: 'document.patch',\n    label: patch.label ?? `Agent move ${objectId}`,\n    patch: patch.patch,\n    targetId: objectId,\n    ...operations.withProjectionImpact(operations.resolveProjectionImpact(\n      patch,\n      patch.reprojectIds?.length\n        ? operations.createReprojectProjectionImpact(patch.reprojectIds)\n        : operations.createTransformProjectionImpact([patch.changedId ?? objectId]),\n    )),\n  });\n  if (!result.documentChanged) {\n    return createLocalEditorCommandFailure(\n      capabilityId,\n      `Transform was unchanged for object: ${objectId}`,\n      { code: 'transform.unchanged', objectId },\n    );\n  }\n  if (patch.reprojectIds?.length) operations.reprojectProjectionForChangedIds(result.workingDocument, patch.reprojectIds);\n  else operations.syncProjectionForChangedIds(result.workingDocument, [patch.changedId ?? objectId]);\n  state.summary = operations.summarizeDocument(result.workingDocument, state.session.getSource());\n  state.status = patch.label ?? label;\n  operations.dispatchSelectionCommand({\n    type: 'selection.replace',\n    selectedIds: [objectId],\n    activeId: objectId,\n    label,\n  });\n  renderUi();\n  const updated = state.projection?.readNodeTransform(objectId) ?? after;\n  return {\n    objectId,\n    before: editorTransformSnapshotToAgentTransform(before) ?? {},\n    after: editorTransformSnapshotToAgentTransform(updated) ?? {},\n    selection: cloneEditorCommandSelection(getEditorCommandSafeSceneSelection(operations)),\n  } satisfies EditorCommandTransformMoveOutput;\n}\n\nfunction addEditorCommandVec3(left: EditorCommandVec3, right: EditorCommandVec3): EditorCommandVec3 {\n  return {\n    x: left.x + right.x,\n    y: left.y + right.y,\n    z: left.z + right.z,\n  };\n}\n"]}

package/dist/editor-commands/capabilities/ui-regions.d.ts

@@ -0,0 +1,4 @@
+import type { LocalEditorCommandUiSource } from '../source-types.js';
+import type { LocalEditorCommandHarnessState } from '../shared.js';
+export declare function createLocalEditorCommandUiSource<TDocument, TPatch>(state: LocalEditorCommandHarnessState<TDocument, TPatch>): LocalEditorCommandUiSource;
+//# sourceMappingURL=ui-regions.d.ts.map

package/dist/editor-commands/capabilities/ui-regions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-regions.d.ts","sourceRoot":"","sources":["../../../src/editor-commands/capabilities/ui-regions.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAkKnE,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,MAAM,EAChE,KAAK,EAAE,8BAA8B,CAAC,SAAS,EAAE,MAAM,CAAC,GACvD,0BAA0B,CAM5B"}

package/dist/{agent-bridge → editor-commands}/capabilities/ui-regions.js

@@ -1,16 +1,16 @@
-import { EDITOR_AGENT_BRIDGE_CAPABILITY_ID, } from '@fps-games/editor-protocol';
-const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
+import { EDITOR_COMMAND_ID, } from '@fps-games/editor-protocol';
+const EDITOR_COMMAND_WORKSPACE_REGIONS = Object.freeze([
     {
         id: 'top-toolbar',
         label: 'Top Toolbar',
         location: 'top',
-        purpose: 'Mode, transform tool, viewport utility, save/history, and Agent Bridge status controls.',
+        purpose: 'Mode, transform tool, viewport utility, save/history, and Command Service status controls.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_MODE_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_EDITOR_ENTER,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.HOST_EDITOR_WAIT_READY,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,
+            EDITOR_COMMAND_ID.HOST_MODE_GET,
+            EDITOR_COMMAND_ID.HOST_EDITOR_ENTER,
+            EDITOR_COMMAND_ID.HOST_EDITOR_WAIT_READY,
+            EDITOR_COMMAND_ID.EDITOR_STATE_GET,
+            EDITOR_COMMAND_ID.EDITOR_DIAGNOSTICS_LIST,
         ],
         fallbackTools: ['playwright', 'chrome'],
         notes: [
@@ -24,11 +24,11 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
         location: 'left',
         purpose: 'Scene object tree, selection context, protected/locked object visibility, and hierarchy actions.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SCENE_OBJECTS_LIST,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_RESOLVE,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SELECTION_SET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_CREATE_PRIMITIVE,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_DELETE,
+            EDITOR_COMMAND_ID.SCENE_OBJECTS_LIST,
+            EDITOR_COMMAND_ID.OBJECT_RESOLVE,
+            EDITOR_COMMAND_ID.SELECTION_SET,
+            EDITOR_COMMAND_ID.OBJECT_CREATE_PRIMITIVE,
+            EDITOR_COMMAND_ID.OBJECT_DELETE,
         ],
         fallbackTools: ['playwright', 'chrome'],
         notes: [
@@ -42,13 +42,13 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
         location: 'center',
         purpose: 'Rendered scene viewport, selection focus, transform gizmo, camera framing, and visual inspection.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_FOCUS_OBJECT,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_FRAME_SELECTION,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_SET_PRESET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.VIEWPORT_CAMERA_ORBIT,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_MOVE,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_SET,
+            EDITOR_COMMAND_ID.VIEWPORT_FOCUS_OBJECT,
+            EDITOR_COMMAND_ID.VIEWPORT_FRAME_SELECTION,
+            EDITOR_COMMAND_ID.VIEWPORT_CAMERA_GET,
+            EDITOR_COMMAND_ID.VIEWPORT_CAMERA_SET_PRESET,
+            EDITOR_COMMAND_ID.VIEWPORT_CAMERA_ORBIT,
+            EDITOR_COMMAND_ID.TRANSFORM_MOVE,
+            EDITOR_COMMAND_ID.TRANSFORM_SET,
         ],
         fallbackTools: ['playwright', 'chrome', 'computer-use'],
         notes: [
@@ -62,11 +62,11 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
         location: 'right',
         purpose: 'Selected object properties, Transform fields, project adapter sections, and editable component data.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_SNAPSHOT_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.TRANSFORM_SET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.SELECTION_SET,
+            EDITOR_COMMAND_ID.EDITOR_STATE_GET,
+            EDITOR_COMMAND_ID.EDITOR_DIAGNOSTICS_LIST,
+            EDITOR_COMMAND_ID.EDITOR_SNAPSHOT_GET,
+            EDITOR_COMMAND_ID.TRANSFORM_SET,
+            EDITOR_COMMAND_ID.SELECTION_SET,
         ],
         fallbackTools: ['playwright', 'chrome'],
         notes: [
@@ -80,8 +80,8 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
         location: 'right',
         purpose: 'Rendering-oriented panels, diagnostics, and project-specific inspector tabs when present.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_SNAPSHOT_GET,
+            EDITOR_COMMAND_ID.EDITOR_STATE_GET,
+            EDITOR_COMMAND_ID.EDITOR_SNAPSHOT_GET,
         ],
         fallbackTools: ['playwright', 'chrome'],
         notes: [
@@ -95,13 +95,13 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
         location: 'bottom',
         purpose: 'Project asset browsing, asset analysis, and asset placement into the scene.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_LIBRARY_LIST,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_INFO_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.ASSET_ANALYSIS_GET,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_RESOLVE,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_STAGE_OPEN,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.PREFAB_STAGE_EXIT,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.OBJECT_CREATE_FROM_ASSET,
+            EDITOR_COMMAND_ID.ASSET_LIBRARY_LIST,
+            EDITOR_COMMAND_ID.ASSET_INFO_GET,
+            EDITOR_COMMAND_ID.ASSET_ANALYSIS_GET,
+            EDITOR_COMMAND_ID.PREFAB_RESOLVE,
+            EDITOR_COMMAND_ID.PREFAB_STAGE_OPEN,
+            EDITOR_COMMAND_ID.PREFAB_STAGE_EXIT,
+            EDITOR_COMMAND_ID.OBJECT_CREATE_FROM_ASSET,
         ],
         fallbackTools: ['playwright', 'chrome'],
         notes: [
@@ -114,42 +114,40 @@ const AGENT_BRIDGE_WORKSPACE_REGIONS = Object.freeze([
         id: 'bottom-console',
         label: 'Editor Console',
         location: 'bottom-global',
-        purpose: 'Session-scoped structured output for editor save, import, compile, run, plugin, and capability operations.',
+        purpose: 'Session-scoped structured output for editor save, import, compile, run, plugin, and command operations.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_DIAGNOSTICS_LIST,
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,
+            EDITOR_COMMAND_ID.EDITOR_DIAGNOSTICS_LIST,
+            EDITOR_COMMAND_ID.EDITOR_STATE_GET,
         ],
         fallbackTools: ['playwright', 'chrome'],
         notes: [
             'This Console is Editor-owned operation output and does not intercept browser console.* calls.',
             'Validation Center remains the revision-aware diagnostics surface and Save/Run gate.',
-            'Agent Bridge Console remains a separate external observability plane.',
+            'Command operation and trace details come from the shared Command System.',
         ],
     },
     {
-        id: 'agent-console',
-        label: 'Agent Bridge Console',
-        location: 'external-localhost',
-        purpose: 'Readonly observability for MCP health, editor sessions, capabilities, recent calls, logs, traces, diagnostics, and L0 artifacts.',
+        id: 'command-center',
+        label: 'Command Center',
+        location: 'overlay',
+        purpose: 'Manifest-driven command discovery, schema input, invocation history, and operation diagnostics.',
         primaryCapabilities: [
-            EDITOR_AGENT_BRIDGE_CAPABILITY_ID.EDITOR_STATE_GET,
+            EDITOR_COMMAND_ID.EDITOR_STATE_GET,
         ],
         fallbackTools: ['browser', 'playwright', 'chrome'],
         notes: [
-            'The console is an observability plane, not an editing UI.',
-            'Write L0 screenshot paths and console/page errors to /api/traces/events instead of embedding binary payloads.',
+            'Cmd/Ctrl+Shift+P opens the Palette; commands with required input continue in the schema Console.',
+            'Favorites and manual invocation history are local view state and never become document authority.',
         ],
     },
 ]);
 const RECOMMENDED_OPERATION_ORDER = Object.freeze([
-    'get_bridge_health',
-    'list_editor_sessions',
-    'list_editor_capabilities',
-    'call_editor_capability(editor.ui.regions.get)',
-    'call_editor_capability(host.editor.enter)',
-    'call_editor_capability(host.editor.waitReady when needed)',
-    'L2 semantic capability for the target region',
-    'L0 browser automation only for missing capability, disconnected bridge, page load, or screenshot evidence',
+    'fps-editor-agent status',
+    'fps-editor-agent commands list/search/describe',
+    'fps-editor-agent command editor.ui.regions.get',
+    'fps-editor-agent command host.editor.enter',
+    'L2 semantic command for the target region',
+    'L0 browser automation only for a missing command, unavailable Browser attachment, page load, or screenshot evidence',
 ]);
 const L0_FALLBACK_RULES = Object.freeze([
     'Do not click Hierarchy rows when selection.set or object.resolve can provide the same semantic result.',
@@ -158,19 +156,19 @@ const L0_FALLBACK_RULES = Object.freeze([
     'Do not drag assets from the bottom panel when object.createFromAsset can place a standard asset.',
     'When L0 fallback is required, record screenshot paths and console/page errors through Agent Operation Trace.',
 ]);
-export function createLocalEditorAgentBridgeUiSource(state) {
+export function createLocalEditorCommandUiSource(state) {
     return {
         getRegions() {
-            return createAgentBridgeUiRegions(state);
+            return createEditorCommandUiRegions(state);
         },
     };
 }
-function createAgentBridgeUiRegions(state) {
+function createEditorCommandUiRegions(state) {
     return {
         mode: state.mode,
         editorReady: state.mode === 'editor' && !!state.session && !state.busy,
         sessionActive: !!state.session,
-        regions: AGENT_BRIDGE_WORKSPACE_REGIONS.map(cloneRegion),
+        regions: EDITOR_COMMAND_WORKSPACE_REGIONS.map(cloneRegion),
         recommendedOperationOrder: [...RECOMMENDED_OPERATION_ORDER],
         l0FallbackRules: [...L0_FALLBACK_RULES],
     };

package/dist/editor-commands/capabilities/ui-regions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-regions.js","sourceRoot":"","sources":["../../../src/editor-commands/capabilities/ui-regions.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  EDITOR_COMMAND_ID,\n  type EditorCommandUiRegionsGetOutput,\n  type EditorCommandWorkspaceRegion,\n} from '@fps-games/editor-protocol';\nimport type { LocalEditorCommandUiSource } from '../source-types.js';\nimport type { LocalEditorCommandHarnessState } from '../shared.js';\n\nconst EDITOR_COMMAND_WORKSPACE_REGIONS: readonly EditorCommandWorkspaceRegion[] = Object.freeze([\n  {\n    id: 'top-toolbar',\n    label: 'Top Toolbar',\n    location: 'top',\n    purpose: 'Mode, transform tool, viewport utility, save/history, and Command Service status controls.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.HOST_MODE_GET,\n      EDITOR_COMMAND_ID.HOST_EDITOR_ENTER,\n      EDITOR_COMMAND_ID.HOST_EDITOR_WAIT_READY,\n      EDITOR_COMMAND_ID.EDITOR_STATE_GET,\n      EDITOR_COMMAND_ID.EDITOR_DIAGNOSTICS_LIST,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Use host.editor.enter instead of clicking the editor entry UI.',\n      'Use editor.diagnostics.list for the same revision-aware snapshot shown in the Validation Center.',\n    ],\n  },\n  {\n    id: 'left-hierarchy',\n    label: 'Hierarchy',\n    location: 'left',\n    purpose: 'Scene object tree, selection context, protected/locked object visibility, and hierarchy actions.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.SCENE_OBJECTS_LIST,\n      EDITOR_COMMAND_ID.OBJECT_RESOLVE,\n      EDITOR_COMMAND_ID.SELECTION_SET,\n      EDITOR_COMMAND_ID.OBJECT_CREATE_PRIMITIVE,\n      EDITOR_COMMAND_ID.OBJECT_DELETE,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Prefer object ids from scene.objects.list or object.resolve over clicking hierarchy rows.',\n      'Creation and deletion must go through editor scene graph capabilities, not manual scene JSON edits.',\n    ],\n  },\n  {\n    id: 'center-preview',\n    label: 'Preview / Scene View',\n    location: 'center',\n    purpose: 'Rendered scene viewport, selection focus, transform gizmo, camera framing, and visual inspection.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.VIEWPORT_FOCUS_OBJECT,\n      EDITOR_COMMAND_ID.VIEWPORT_FRAME_SELECTION,\n      EDITOR_COMMAND_ID.VIEWPORT_CAMERA_GET,\n      EDITOR_COMMAND_ID.VIEWPORT_CAMERA_SET_PRESET,\n      EDITOR_COMMAND_ID.VIEWPORT_CAMERA_ORBIT,\n      EDITOR_COMMAND_ID.TRANSFORM_MOVE,\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n    ],\n    fallbackTools: ['playwright', 'chrome', 'computer-use'],\n    notes: [\n      'Use viewport.camera.setPreset before L0 screenshots so visual evidence has a stable semantic view.',\n      'Use transform capabilities instead of dragging the gizmo when a structured transform target is known.',\n    ],\n  },\n  {\n    id: 'right-inspector',\n    label: 'Inspector',\n    location: 'right',\n    purpose: 'Selected object properties, Transform fields, project adapter sections, and editable component data.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.EDITOR_STATE_GET,\n      EDITOR_COMMAND_ID.EDITOR_DIAGNOSTICS_LIST,\n      EDITOR_COMMAND_ID.EDITOR_SNAPSHOT_GET,\n      EDITOR_COMMAND_ID.TRANSFORM_SET,\n      EDITOR_COMMAND_ID.SELECTION_SET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Prefer semantic capabilities for known fields; use Inspector UI only when a field has no capability yet.',\n      'Future material, shadow, and rendering property work should add focused capabilities before relying on form automation.',\n    ],\n  },\n  {\n    id: 'right-render-tabs',\n    label: 'Render / Diagnostics Tabs',\n    location: 'right',\n    purpose: 'Rendering-oriented panels, diagnostics, and project-specific inspector tabs when present.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.EDITOR_STATE_GET,\n      EDITOR_COMMAND_ID.EDITOR_SNAPSHOT_GET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Treat render tab UI as fallback until rendering/shadow capabilities are added.',\n      'Capture tab screenshots as trace artifacts when using L0 fallback for visual diagnostics.',\n    ],\n  },\n  {\n    id: 'bottom-assets',\n    label: 'Asset Library',\n    location: 'bottom',\n    purpose: 'Project asset browsing, asset analysis, and asset placement into the scene.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.ASSET_LIBRARY_LIST,\n      EDITOR_COMMAND_ID.ASSET_INFO_GET,\n      EDITOR_COMMAND_ID.ASSET_ANALYSIS_GET,\n      EDITOR_COMMAND_ID.PREFAB_RESOLVE,\n      EDITOR_COMMAND_ID.PREFAB_STAGE_OPEN,\n      EDITOR_COMMAND_ID.PREFAB_STAGE_EXIT,\n      EDITOR_COMMAND_ID.OBJECT_CREATE_FROM_ASSET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'Use asset.library.list and asset.analysis.get before object.createFromAsset.',\n      'Double-clicking a prefab asset opens the Prefab stage for users; agents should call prefab.resolve then prefab.stage.open.',\n      'Do not drag assets in the browser or hand-edit generated catalogs as the primary placement path.',\n    ],\n  },\n  {\n    id: 'bottom-console',\n    label: 'Editor Console',\n    location: 'bottom-global',\n    purpose: 'Session-scoped structured output for editor save, import, compile, run, plugin, and command operations.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.EDITOR_DIAGNOSTICS_LIST,\n      EDITOR_COMMAND_ID.EDITOR_STATE_GET,\n    ],\n    fallbackTools: ['playwright', 'chrome'],\n    notes: [\n      'This Console is Editor-owned operation output and does not intercept browser console.* calls.',\n      'Validation Center remains the revision-aware diagnostics surface and Save/Run gate.',\n      'Command operation and trace details come from the shared Command System.',\n    ],\n  },\n  {\n    id: 'command-center',\n    label: 'Command Center',\n    location: 'overlay',\n    purpose: 'Manifest-driven command discovery, schema input, invocation history, and operation diagnostics.',\n    primaryCapabilities: [\n      EDITOR_COMMAND_ID.EDITOR_STATE_GET,\n    ],\n    fallbackTools: ['browser', 'playwright', 'chrome'],\n    notes: [\n      'Cmd/Ctrl+Shift+P opens the Palette; commands with required input continue in the schema Console.',\n      'Favorites and manual invocation history are local view state and never become document authority.',\n    ],\n  },\n]);\n\nconst RECOMMENDED_OPERATION_ORDER = Object.freeze([\n  'fps-editor-agent status',\n  'fps-editor-agent commands list/search/describe',\n  'fps-editor-agent command editor.ui.regions.get',\n  'fps-editor-agent command host.editor.enter',\n  'L2 semantic command for the target region',\n  'L0 browser automation only for a missing command, unavailable Browser attachment, page load, or screenshot evidence',\n]);\n\nconst L0_FALLBACK_RULES = Object.freeze([\n  'Do not click Hierarchy rows when selection.set or object.resolve can provide the same semantic result.',\n  'Do not drag the Preview gizmo when transform.move or transform.set can express the edit.',\n  'Do not use browser screenshots for camera setup before trying viewport.camera.setPreset or viewport.camera.orbit.',\n  'Do not drag assets from the bottom panel when object.createFromAsset can place a standard asset.',\n  'When L0 fallback is required, record screenshot paths and console/page errors through Agent Operation Trace.',\n]);\n\nexport function createLocalEditorCommandUiSource<TDocument, TPatch>(\n  state: LocalEditorCommandHarnessState<TDocument, TPatch>,\n): LocalEditorCommandUiSource {\n  return {\n    getRegions() {\n      return createEditorCommandUiRegions(state);\n    },\n  };\n}\n\nfunction createEditorCommandUiRegions<TDocument, TPatch>(\n  state: LocalEditorCommandHarnessState<TDocument, TPatch>,\n): EditorCommandUiRegionsGetOutput {\n  return {\n    mode: state.mode,\n    editorReady: state.mode === 'editor' && !!state.session && !state.busy,\n    sessionActive: !!state.session,\n    regions: EDITOR_COMMAND_WORKSPACE_REGIONS.map(cloneRegion),\n    recommendedOperationOrder: [...RECOMMENDED_OPERATION_ORDER],\n    l0FallbackRules: [...L0_FALLBACK_RULES],\n  };\n}\n\nfunction cloneRegion(region: EditorCommandWorkspaceRegion): EditorCommandWorkspaceRegion {\n  return {\n    ...region,\n    primaryCapabilities: [...region.primaryCapabilities],\n    ...(region.fallbackTools ? { fallbackTools: [...region.fallbackTools] } : {}),\n    ...(region.notes ? { notes: [...region.notes] } : {}),\n  };\n}\n"]}

package/dist/editor-commands/capabilities/viewport.d.ts

@@ -0,0 +1,5 @@
+import type { LocalEditorCommandViewportSource } from '../source-types.js';
+import { type LocalEditorCommandCapabilitySourceOperations, type LocalEditorCommandHarnessState } from '../shared.js';
+import type { LocalEditorHarnessOptions } from '../../local-editor-harness.js';
+export declare function createLocalEditorCommandViewportSource<TDocument, TPatch, TAsset>(state: LocalEditorCommandHarnessState<TDocument, TPatch>, options: LocalEditorHarnessOptions<TDocument, TPatch, TAsset>, renderUi: () => void, operations: LocalEditorCommandCapabilitySourceOperations<TDocument>): LocalEditorCommandViewportSource;
+//# sourceMappingURL=viewport.d.ts.map

package/dist/editor-commands/capabilities/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../../src/editor-commands/capabilities/viewport.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EASL,KAAK,4CAA4C,EACjD,KAAK,8BAA8B,EACpC,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/E,wBAAgB,sCAAsC,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAC9E,KAAK,EAAE,8BAA8B,CAAC,SAAS,EAAE,MAAM,CAAC,EACxD,OAAO,EAAE,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7D,QAAQ,EAAE,MAAM,IAAI,EACpB,UAAU,EAAE,4CAA4C,CAAC,SAAS,CAAC,GAClE,gCAAgC,CA2FlC"}