@skenora/editor 0.1.2

package/dist/core/commands.js

@@ -0,0 +1,282 @@
+/** Core command contract and reusable document operations. */
+import { createMaterialBindingId, getMaterialBindingsForEntity, toMaterialDefinition, } from "@skenora/contracts";
+import { getAtPath, } from "@skenora/document";
+let commandSequence = 0;
+export function createCommandId(prefix = "command") {
+    commandSequence += 1;
+    return `${prefix}-${Date.now()}-${commandSequence}`;
+}
+export function setPropertyCommand(path, value, label = "Set property") {
+    return {
+        id: createCommandId("set"),
+        label,
+        createPatches(document) {
+            const previousValue = getAtPath(document, path);
+            if (Object.is(previousValue, value))
+                return [];
+            return [{ op: "set", path, value, previousValue }];
+        },
+    };
+}
+export function replaceDocumentCommand(document, label = "Replace document") {
+    return setPropertyCommand([], document, label);
+}
+export function addEntityCommand(entity) {
+    return {
+        id: createCommandId("add-entity"),
+        label: `Add ${entity.name}`,
+        createPatches(document) {
+            if (document.entities[entity.id]) {
+                throw new Error(`Entity already exists: ${entity.id}`);
+            }
+            const patches = [
+                {
+                    op: "set",
+                    path: ["entities", entity.id],
+                    value: entity,
+                    previousValue: undefined,
+                },
+            ];
+            if (entity.parentId === null) {
+                patches.push({
+                    op: "set",
+                    path: ["rootEntityIds"],
+                    value: [...document.rootEntityIds, entity.id],
+                    previousValue: document.rootEntityIds,
+                });
+            }
+            return patches;
+        },
+    };
+}
+export function removeEntityCommand(entityId) {
+    return {
+        id: createCommandId("remove-entity"),
+        label: "Remove entity",
+        createPatches(document) {
+            const target = document.entities[entityId];
+            if (!target)
+                return [];
+            const descendants = collectDescendants(document, entityId);
+            const removedIds = new Set([entityId, ...descendants]);
+            const nextRoots = document.rootEntityIds.filter((id) => !removedIds.has(id));
+            const patches = [];
+            for (const id of [...descendants].reverse()) {
+                const entity = document.entities[id];
+                if (!entity)
+                    continue;
+                patches.push({
+                    op: "delete",
+                    path: ["entities", id],
+                    previousValue: entity,
+                });
+            }
+            patches.push({
+                op: "delete",
+                path: ["entities", entityId],
+                previousValue: target,
+            });
+            for (const [bindingId, binding] of Object.entries(document.materialBindings)) {
+                if (!removedIds.has(binding.entityId))
+                    continue;
+                patches.push({
+                    op: "delete",
+                    path: ["materialBindings", bindingId],
+                    previousValue: binding,
+                });
+            }
+            if (nextRoots.length !== document.rootEntityIds.length) {
+                patches.push({
+                    op: "set",
+                    path: ["rootEntityIds"],
+                    value: nextRoots,
+                    previousValue: document.rootEntityIds,
+                });
+            }
+            return patches;
+        },
+    };
+}
+export function setEntityTransformCommand(entityId, transform) {
+    return setPropertyCommand(["entities", entityId, "transform"], transform, "Transform entity");
+}
+export function renameEntityCommand(entityId, name) {
+    return setPropertyCommand(["entities", entityId, "name"], name, "Rename entity");
+}
+export function setEntityEnabledCommand(entityId, enabled) {
+    return setPropertyCommand(["entities", entityId, "enabled"], enabled, enabled ? "Enable entity" : "Disable entity");
+}
+export function setEntityVisibleCommand(entityId, visible) {
+    return setPropertyCommand(["entities", entityId, "visible"], visible, visible ? "Show entity" : "Hide entity");
+}
+export function reparentEntityCommand(entityId, parentId) {
+    return {
+        id: createCommandId("reparent"),
+        label: "Reparent entity",
+        createPatches(document) {
+            const entity = document.entities[entityId];
+            if (!entity)
+                throw new Error(`Entity not found: ${entityId}`);
+            if (parentId === entityId)
+                throw new Error("An entity cannot parent itself");
+            if (parentId && !document.entities[parentId]) {
+                throw new Error(`Parent entity not found: ${parentId}`);
+            }
+            if (parentId &&
+                collectDescendants(document, entityId).includes(parentId)) {
+                throw new Error("An entity cannot be parented below one of its descendants");
+            }
+            if (entity.parentId === parentId)
+                return [];
+            const wasRoot = entity.parentId === null;
+            const becomesRoot = parentId === null;
+            const patches = [
+                {
+                    op: "set",
+                    path: ["entities", entityId, "parentId"],
+                    value: parentId,
+                    previousValue: entity.parentId,
+                },
+            ];
+            if (wasRoot !== becomesRoot) {
+                patches.push({
+                    op: "set",
+                    path: ["rootEntityIds"],
+                    value: becomesRoot
+                        ? [...document.rootEntityIds, entityId]
+                        : document.rootEntityIds.filter((id) => id !== entityId),
+                    previousValue: document.rootEntityIds,
+                });
+            }
+            return patches;
+        },
+    };
+}
+export function duplicateEntityTreeCommand(entityId, createId = (sourceId) => `${sourceId}-copy-${createCommandId("entity")}`) {
+    return {
+        id: createCommandId("duplicate"),
+        label: "Duplicate entity",
+        createPatches(document) {
+            const source = document.entities[entityId];
+            if (!source)
+                throw new Error(`Entity not found: ${entityId}`);
+            const sourceIds = [entityId, ...collectDescendants(document, entityId)];
+            const idMap = new Map(sourceIds.map((id) => [id, createId(id)]));
+            const nextEntityIds = [...idMap.values()];
+            if (new Set(nextEntityIds).size !== nextEntityIds.length ||
+                nextEntityIds.some((id) => !id.trim() || document.entities[id])) {
+                throw new Error("Duplicate entity ids must be unique and unused");
+            }
+            const occupiedMaterialIds = new Set(Object.keys(document.materials));
+            const occupiedBindingIds = new Set(Object.keys(document.materialBindings));
+            const materialIdMap = new Map();
+            const patches = [];
+            for (const sourceId of sourceIds) {
+                const entity = document.entities[sourceId];
+                const nextId = idMap.get(sourceId);
+                if (!entity || !nextId)
+                    continue;
+                const parentId = sourceId === entityId
+                    ? entity.parentId
+                    : entity.parentId
+                        ? (idMap.get(entity.parentId) ?? entity.parentId)
+                        : null;
+                const copy = {
+                    ...structuredClone(entity),
+                    id: nextId,
+                    name: sourceId === entityId ? `${entity.name} copy` : entity.name,
+                    parentId,
+                };
+                delete copy.materialIds;
+                for (const binding of getMaterialBindingsForEntity(document, sourceId)) {
+                    const material = document.materials[binding.materialId];
+                    if (!material) {
+                        throw new Error(`Material not found: ${binding.materialId}`);
+                    }
+                    const nextMaterialId = availableRecordId(`${nextId}:${binding.materialId}`, occupiedMaterialIds);
+                    occupiedMaterialIds.add(nextMaterialId);
+                    materialIdMap.set(binding.materialId, nextMaterialId);
+                    patches.push({
+                        op: "set",
+                        path: ["materials", nextMaterialId],
+                        value: {
+                            ...toMaterialDefinition(material),
+                            id: nextMaterialId,
+                        },
+                        previousValue: undefined,
+                    });
+                    const nextBindingId = createMaterialBindingId(nextMaterialId, nextId, binding.targetName, occupiedBindingIds);
+                    occupiedBindingIds.add(nextBindingId);
+                    patches.push({
+                        op: "set",
+                        path: ["materialBindings", nextBindingId],
+                        value: {
+                            id: nextBindingId,
+                            materialId: nextMaterialId,
+                            entityId: nextId,
+                            ...(binding.targetName ? { targetName: binding.targetName } : {}),
+                        },
+                        previousValue: undefined,
+                    });
+                }
+                patches.push({
+                    op: "set",
+                    path: ["entities", nextId],
+                    value: copy,
+                    previousValue: undefined,
+                });
+            }
+            const occupiedAnimationIds = new Set(Object.keys(document.textureAnimations));
+            for (const [animationId, animation] of Object.entries(document.textureAnimations)) {
+                const materialId = materialIdMap.get(animation.materialId);
+                if (!materialId)
+                    continue;
+                const nextAnimationId = availableRecordId(`${materialId}:${animationId}`, occupiedAnimationIds);
+                occupiedAnimationIds.add(nextAnimationId);
+                patches.push({
+                    op: "set",
+                    path: ["textureAnimations", nextAnimationId],
+                    value: {
+                        ...structuredClone(animation),
+                        id: nextAnimationId,
+                        materialId,
+                    },
+                    previousValue: undefined,
+                });
+            }
+            const rootCopyId = idMap.get(entityId);
+            if (source.parentId === null && rootCopyId) {
+                patches.push({
+                    op: "set",
+                    path: ["rootEntityIds"],
+                    value: [...document.rootEntityIds, rootCopyId],
+                    previousValue: document.rootEntityIds,
+                });
+            }
+            return patches;
+        },
+    };
+}
+function availableRecordId(base, occupied) {
+    if (!occupied.has(base))
+        return base;
+    let suffix = 2;
+    while (occupied.has(`${base}-${suffix}`))
+        suffix += 1;
+    return `${base}-${suffix}`;
+}
+function collectDescendants(document, entityId) {
+    const result = [];
+    const queue = [entityId];
+    while (queue.length > 0) {
+        const parentId = queue.shift();
+        for (const entity of Object.values(document.entities)) {
+            if (entity.parentId !== parentId)
+                continue;
+            result.push(entity.id);
+            queue.push(entity.id);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=commands.js.map

package/dist/core/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/core/commands.ts"],"names":[],"mappings":"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"}

package/dist/core/editor-session.d.ts

@@ -0,0 +1,92 @@
+/** Instance-scoped headless authoring session. */
+import { type SceneDocumentData } from "@skenora/contracts";
+import { type DocumentChange } from "@skenora/document";
+import { EventHub, type EventEnvelope } from "@skenora/events";
+import { type SkenoraPlugin } from "@skenora/plugins";
+import { type CandidateCommitOptions, type CandidateCommitResult } from "./candidate-commit.js";
+import { type EditorCommand } from "./commands.js";
+export interface EditorEventMap {
+    "document.changed": DocumentChange;
+    "selection.changed": {
+        entityIds: readonly string[];
+    };
+    "history.changed": {
+        canUndo: boolean;
+        canRedo: boolean;
+    };
+    "dirty.changed": {
+        dirty: boolean;
+    };
+    "command.rejected": {
+        commandId: string;
+        error: unknown;
+    };
+    "transaction.committed": {
+        transactionId: string;
+        label: string;
+        mergeKey: string | null;
+    };
+    "transaction.cancelled": {
+        transactionId: string;
+        label: string;
+    };
+    "extension.error": {
+        extensionId: string;
+        error: unknown;
+    };
+}
+export interface EditorSessionOptions {
+    events?: EventHub<EditorEventMap>;
+    historyLimit?: number;
+    validate?: false | ((document: Readonly<SceneDocumentData>) => void);
+    plugins?: readonly EditorPlugin[];
+}
+export type EditorPlugin = SkenoraPlugin<EditorSession>;
+/** @deprecated Use {@link EditorPlugin}. */
+export type EditorExtension = EditorPlugin;
+export interface TransactionOptions {
+    label?: string;
+    mergeKey?: string;
+    mergeWindowMs?: number;
+}
+export interface TransactionHandle {
+    readonly id: string;
+    readonly label: string;
+    readonly active: boolean;
+    execute(command: EditorCommand): DocumentChange | null;
+    commit(): DocumentChange | null;
+    cancel(): DocumentChange | null;
+}
+export declare class EditorSession {
+    #private;
+    readonly events: EventHub<EditorEventMap>;
+    constructor(document: SceneDocumentData, options?: EditorSessionOptions);
+    get snapshot(): Readonly<SceneDocumentData>;
+    get revision(): number;
+    /**
+     * Commits a complete candidate document with an Editor-level revision CAS.
+     *
+     * The candidate is normalized and asserted before being converted into
+     * granular patches. The expected revision and optional document hash are
+     * checked again inside the synchronous commit boundary immediately before
+     * the Store commit, so stale candidates produce no history entry or document
+     * change. Queueing belongs to the SDK executor, not this session.
+     */
+    commitCandidateAtRevision(candidate: unknown, options: CandidateCommitOptions): CandidateCommitResult;
+    get selection(): readonly string[];
+    get dirty(): boolean;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    get transactionActive(): boolean;
+    execute(command: EditorCommand): DocumentChange | null;
+    transaction(label: string, commands: readonly EditorCommand[]): DocumentChange | null;
+    beginTransaction(options?: TransactionOptions): TransactionHandle;
+    undo(): DocumentChange | null;
+    redo(): DocumentChange | null;
+    select(entityIds: readonly string[]): void;
+    markSaved(): void;
+    install(plugin: EditorPlugin): () => void;
+    subscribe<TKey extends keyof EditorEventMap & string>(type: TKey, handler: (payload: EditorEventMap[TKey], event: EventEnvelope<string, EditorEventMap[TKey]>) => void, signal?: AbortSignal): () => void;
+    dispose(): void;
+}
+//# sourceMappingURL=editor-session.d.ts.map

package/dist/core/editor-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-session.d.ts","sourceRoot":"","sources":["../../src/core/editor-session.ts"],"names":[],"mappings":"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"}