@treasuryspatial/viewer-orchestrator 0.1.1

package/dist/boot.d.ts

@@ -0,0 +1,3 @@
+import type { OrchestratorModule } from "./types";
+export declare const buildBootModules: () => OrchestratorModule[];
+//# sourceMappingURL=boot.d.ts.map

package/dist/boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,SAAS,CAAC;AAOrE,eAAO,MAAM,gBAAgB,QAAO,kBAAkB,EA0ErD,CAAC"}

package/dist/boot.js

@@ -0,0 +1,86 @@
+const advancePhase = (state, next) => ({
+    ...state,
+    ...next,
+});
+export const buildBootModules = () => [
+    {
+        id: "boot:error",
+        kind: "bootstrap",
+        priority: 0,
+        apply: (state, context) => {
+            if (!context.error)
+                return state;
+            return advancePhase(state, { phase: "ERROR", error: context.error });
+        },
+    },
+    {
+        id: "boot:viewer",
+        kind: "viewer",
+        priority: 10,
+        apply: (state, context) => {
+            if (!context.viewer)
+                return state;
+            return advancePhase(state, { phase: "VIEWER_READY" });
+        },
+    },
+    {
+        id: "boot:tools",
+        kind: "tools",
+        priority: 20,
+        apply: (state, context) => {
+            if (!context.tools || context.tools.length === 0)
+                return state;
+            return advancePhase(state, { phase: "TOOLS_READY" });
+        },
+    },
+    {
+        id: "boot:tool",
+        kind: "tools",
+        priority: 30,
+        apply: (state, context) => {
+            if (!context.activeToolId)
+                return state;
+            return advancePhase(state, { phase: "TOOLS_READY", activeToolId: context.activeToolId });
+        },
+    },
+    {
+        id: "boot:overrides",
+        kind: "presets",
+        priority: 40,
+        apply: (state, context) => {
+            if (!context.activeToolId || !context.runtimePresetId)
+                return state;
+            return advancePhase(state, {
+                phase: "OVERRIDES_APPLIED",
+                activeToolId: context.activeToolId,
+                runtimePresetId: context.runtimePresetId,
+            });
+        },
+    },
+    {
+        id: "boot:geometry",
+        kind: "geometry",
+        priority: 50,
+        apply: (state, context) => {
+            if (!context.geometryReady)
+                return state;
+            return advancePhase(state, {
+                phase: "GEOMETRY_READY",
+                activeToolId: context.activeToolId ?? state.activeToolId,
+            });
+        },
+    },
+    {
+        id: "boot:ready",
+        kind: "ui",
+        priority: 60,
+        apply: (state, context) => {
+            if (!context.geometryReady)
+                return state;
+            return advancePhase(state, {
+                phase: "READY",
+                activeToolId: context.activeToolId ?? state.activeToolId,
+            });
+        },
+    },
+];

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types";
+export { mergeRenderPreset } from "./merge";
+export { buildBootModules } from "./boot";
+import type { ViewerOrchestrator, ViewerOrchestratorOptions } from "./types";
+export declare function createViewerOrchestrator(options: ViewerOrchestratorOptions): ViewerOrchestrator;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,KAAK,EAKV,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAWjB,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CA4D/F"}

package/dist/index.js

@@ -0,0 +1,59 @@
+export * from "./types";
+export { mergeRenderPreset } from "./merge";
+export { buildBootModules } from "./boot";
+const emitEvent = (timeline, onEvent, event) => {
+    timeline.push(event);
+    onEvent?.(event);
+};
+export function createViewerOrchestrator(options) {
+    const { viewer, presets, onEvent } = options;
+    let state = { phase: "IDLE" };
+    const timeline = [];
+    const context = {
+        viewer,
+        presets,
+    };
+    const updateState = (next, detail) => {
+        state = next;
+        emitEvent(timeline, onEvent, {
+            phase: state.phase,
+            ts: Date.now(),
+            detail,
+        });
+    };
+    updateState(state, { reason: "init" });
+    return {
+        getState: () => ({ ...state }),
+        getTimeline: () => [...timeline],
+        applyModules: (modules) => {
+            const sorted = [...modules].sort((a, b) => a.priority - b.priority);
+            sorted.forEach((module) => {
+                try {
+                    state = module.apply(state, context);
+                }
+                catch (error) {
+                    state = { phase: "ERROR", error: error?.message ?? "orchestrator module error" };
+                }
+            });
+            updateState(state, { moduleCount: sorted.length });
+        },
+        setRuntimePreset: (preset) => {
+            viewer.setRuntimePreset(preset);
+            updateState({
+                ...state,
+                runtimePresetId: preset.id ?? "__runtime__",
+            }, { action: "setRuntimePreset" });
+        },
+        setContext: (partial) => {
+            Object.assign(context, partial);
+            updateState({
+                ...state,
+                activeToolId: context.activeToolId ?? state.activeToolId,
+                runtimePresetId: context.runtimePresetId ?? state.runtimePresetId,
+            }, { action: "setContext" });
+        },
+        dispose: () => {
+            updateState({ phase: "IDLE" }, { action: "dispose" });
+        },
+    };
+}

package/dist/merge.d.ts

@@ -0,0 +1,7 @@
+import type { RenderPresetDefinition } from "@treasuryspatial/viewer-kit";
+/**
+ * Merge render preset definitions with a predictable override order.
+ * Arrays are overwritten (not concatenated) to preserve explicit overrides.
+ */
+export declare const mergeRenderPreset: (base: RenderPresetDefinition, ...overrides: Array<RenderPresetDefinition | undefined | null>) => RenderPresetDefinition;
+//# sourceMappingURL=merge.d.ts.map

package/dist/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../src/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAiB1E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,sBAAsB,EAC5B,GAAG,WAAW,KAAK,CAAC,sBAAsB,GAAG,SAAS,GAAG,IAAI,CAAC,KAC7D,sBAOF,CAAC"}

package/dist/merge.js

@@ -0,0 +1,26 @@
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const mergeRecords = (target, source) => {
+    const next = { ...target };
+    Object.entries(source).forEach(([key, value]) => {
+        if (isRecord(value) && isRecord(next[key])) {
+            next[key] = mergeRecords(next[key], value);
+        }
+        else {
+            next[key] = value;
+        }
+    });
+    return next;
+};
+/**
+ * Merge render preset definitions with a predictable override order.
+ * Arrays are overwritten (not concatenated) to preserve explicit overrides.
+ */
+export const mergeRenderPreset = (base, ...overrides) => {
+    let result = { ...base };
+    overrides.forEach((override) => {
+        if (!override)
+            return;
+        result = mergeRecords(result, override);
+    });
+    return result;
+};

package/dist/types.d.ts

@@ -0,0 +1,48 @@
+import type { PresetCatalog, RenderPresetDefinition, ViewerHandle } from "@treasuryspatial/viewer-kit";
+import type { PluginManifest, ToolManifest } from "@treasuryspatial/plugin-manifest";
+import type { UiManifest } from "@treasuryspatial/ui-manifest";
+export type OrchestratorPhase = "IDLE" | "BOOTSTRAP_READY" | "VIEWER_READY" | "TOOLS_READY" | "OVERRIDES_APPLIED" | "GEOMETRY_READY" | "READY" | "ERROR";
+export type OrchestratorEvent = {
+    phase: OrchestratorPhase;
+    ts: number;
+    detail?: Record<string, unknown>;
+};
+export type OrchestratorState = {
+    phase: OrchestratorPhase;
+    activeToolId?: string;
+    runtimePresetId?: string;
+    error?: string;
+};
+export type OrchestratorModuleKind = "bootstrap" | "viewer" | "tools" | "lighting" | "environment" | "materials" | "presets" | "postfx" | "camera" | "geometry" | "ui";
+export type OrchestratorContext = {
+    viewer: ViewerHandle;
+    presets: PresetCatalog;
+    uiManifest?: UiManifest;
+    tools?: ToolManifest[];
+    plugins?: Record<string, PluginManifest>;
+    activeToolId?: string;
+    runtimePresetId?: string;
+    geometryReady?: boolean;
+    error?: string;
+};
+export type OrchestratorModule = {
+    id: string;
+    kind: OrchestratorModuleKind;
+    priority: number;
+    apply: (state: OrchestratorState, context: OrchestratorContext) => OrchestratorState;
+    dispose?: (context: OrchestratorContext) => void;
+};
+export type ViewerOrchestratorOptions = {
+    viewer: ViewerHandle;
+    presets: PresetCatalog;
+    onEvent?: (event: OrchestratorEvent) => void;
+};
+export type ViewerOrchestrator = {
+    getState: () => OrchestratorState;
+    getTimeline: () => OrchestratorEvent[];
+    applyModules: (modules: OrchestratorModule[]) => void;
+    setRuntimePreset: (preset: RenderPresetDefinition) => void;
+    setContext: (partial: Partial<OrchestratorContext>) => void;
+    dispose: () => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,iBAAiB,GACjB,cAAc,GACd,aAAa,GACb,mBAAmB,GACnB,gBAAgB,GAChB,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B,WAAW,GACX,QAAQ,GACR,OAAO,GACP,UAAU,GACV,aAAa,GACb,WAAW,GACX,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,IAAI,CAAC;AAET,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,sBAAsB,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAmB,KAAK,iBAAiB,CAAC;IACrF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,iBAAiB,CAAC;IAClC,WAAW,EAAE,MAAM,iBAAiB,EAAE,CAAC;IACvC,YAAY,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,CAAC;IACtD,gBAAgB,EAAE,CAAC,MAAM,EAAE,sBAAsB,KAAK,IAAI,CAAC;IAC3D,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,KAAK,IAAI,CAAC;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@treasuryspatial/viewer-orchestrator",
+  "version": "0.1.1",
+  "type": "module",
+  "license": "UNLICENSED",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "typecheck": "tsc -b --pretty false --noEmit"
+  },
+  "dependencies": {
+    "@treasuryspatial/plugin-manifest": "^0.1.3",
+    "@treasuryspatial/ui-manifest": "^0.1.3",
+    "@treasuryspatial/viewer-kit": "^0.2.0"
+  }
+}