SceneModel ​

ts

export interface SceneModel {
  root: ConfiguratorNode[];
  defaultNodeId?: string;
  connections?: Connection[];
  connectionsBasis?: string;
  defaultView?: IDefaultView;
  presets?: IPreset[];
  attributes?: Record<string, unknown>;
  parameters?: Record<string, unknown>;
  toneMapping?: string;
  backgroundColor?: BackgroundValue;
  hdrUrl?: string;
  name?: string;
  _id?: string;
}

ts

import type { ConfiguratorNode, DeepReadonly, SceneModel, Session } from '@holostep-configurators/runtime-client/contract';
declare const session: Session;
declare const signal: AbortSignal;
// A node anywhere in the tree, by nodeId.
export function findNode(
  nodes: readonly DeepReadonly<ConfiguratorNode>[],
  nodeId: string,
): DeepReadonly<ConfiguratorNode> | null {
  for (const node of nodes) {
    if (node.nodeId === nodeId) return node;
    const found = findNode(node.children ?? [], nodeId);
    if (found) return found;
  }
  return null;
}
// A copy with `node` added under `parentId` (at the root without one), the rest untouched.
export function withNode(
  model: DeepReadonly<SceneModel>,
  node: ConfiguratorNode,
  parentId?: string,
): SceneModel {
  const copy = structuredClone(model) as SceneModel;
  const addUnder = (nodes: ConfiguratorNode[]): boolean =>
    nodes.some((n) => {
      if (n.nodeId !== parentId) return addUnder(n.children ?? []);
      n.children = [...(n.children ?? []), node];
      return true;
    });
  if (parentId === undefined) copy.root.push(node);
  else if (!addUnder(copy.root)) throw new Error(`no node ${parentId}`);
  return copy;
}
// A global-material group's selected material: `select(group, material)` records it as the
// group's `defaultNodeId`. Prices are your app's: read them from your catalogue by this id.
export function selectedMaterial(model: DeepReadonly<SceneModel>, group: string): string | null {
  const node = findNode(model.root, group);
  return node?.type === 'GroupNode' ? (node.defaultNodeId ?? null) : null;
}