feat(web): add freestyle line authoring

web/app/src/workers/web-engine.worker.ts

@@ -797,6 +797,14 @@ function assertFutureCapability(payload: Extract<WebEngineRequest["command"], {
       for (const field of ["foreground", "background"] as const) if (properties[field] !== undefined && (!Array.isArray(properties[field]) || properties[field].length !== 4 || properties[field].some((value) => !boundedNumber(value, 0, 1)))) throw report("RENDER_PROPERTY_INVALID", `Scene ${field} must contain four normalized channels`);
       return;
     }
+    case "setSceneLineSettings": {
+      const scene = currentSnapshot?.scenes.find((candidate) => candidate.id === payload.dataId);
+      const properties = payload.properties;
+      if (!scene || !validPropertyKeys(properties, ["mode", "thickness"])) throw report("RENDER_PROPERTY_INVALID", "Scene line target or properties are invalid");
+      if (properties.mode !== undefined && ![1, 2].includes(properties.mode)) throw report("RENDER_PROPERTY_INVALID", "Scene line mode is unsupported");
+      if (properties.thickness !== undefined && !boundedNumber(properties.thickness, 0, 1000)) throw report("RENDER_PROPERTY_INVALID", "Scene line thickness is outside the bounded range");
+      return;
+    }
     case "setGeometryNodeGraph": {
       const snapshot = currentSnapshot;
       const availableResourceIds = new Set([

web/protocol/animation-render-commands.ts

@@ -89,4 +89,7 @@ export const animationRenderCommands = Object.freeze({
   setSceneStampSettings(dataId: string, properties: AnimationCommand<"setSceneStampSettings">["properties"]): AnimationCommand<"setSceneStampSettings"> {
     return { type: "setSceneStampSettings", dataId, properties: { ...properties } };
   },
+  setSceneLineSettings(dataId: string, properties: AnimationCommand<"setSceneLineSettings">["properties"]): AnimationCommand<"setSceneLineSettings"> {
+    return { type: "setSceneLineSettings", dataId, properties: { ...properties } };
+  },
 } satisfies Record<string, (...args: never[]) => WebEngineEditCommand>);

web/protocol/scene-ir.ts

@@ -582,6 +582,7 @@ export interface SceneIR {
   samplingSettings?: { pixelAspectX: number; pixelAspectY: number; filterSize: number; dither: number };
   multiviewSettings?: { enabled: boolean; viewsFormat: number; imageViewsFormat: number; stereoDisplayMode: number; interlaceSwap: boolean; sideBySideCrossed: boolean; squeezedFrame: boolean };
   stampSettings?: { stampMask: number; fontId: number; userText: string; foreground: number[]; background: number[] };
+  lineSettings?: { mode: number; thickness: number };
   compositorGraph?: CompositorGraphIR;
   compositorStatus?: "AVAILABLE" | "BLOCKED";
   sequencerTimeline?: SequencerTimelineIR;
@@ -1656,6 +1657,11 @@ export function parseSceneSnapshotIR(value: unknown): SceneSnapshotIR {
       requireString(scene.stampSettings.userText, `scenes[${index}].stampSettings.userText`);
       for (const field of ["foreground", "background"] as const) requireTuple(scene.stampSettings[field], 4, `scenes[${index}].stampSettings.${field}`);
     }
+    if (scene.lineSettings !== undefined) {
+      if (!isRecord(scene.lineSettings)) throw new Error(`SceneIR.scenes[${index}].lineSettings must be an object`);
+      requireNumber(scene.lineSettings.mode, `scenes[${index}].lineSettings.mode`);
+      requireNumber(scene.lineSettings.thickness, `scenes[${index}].lineSettings.thickness`);
+    }
     if (scene.compositorStatus !== undefined && !["AVAILABLE", "BLOCKED"].includes(scene.compositorStatus as string)) {
       throw new Error(`scenes[${index}].compositorStatus is invalid`);
     }

web/protocol/web-engine-capabilities.ts

@@ -99,6 +99,7 @@ export const WEB_ENGINE_COMMAND_CAPABILITIES = {
   setSceneSamplingSettings: { family: "RENDER", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setSceneMultiviewSettings: { family: "RENDER", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setSceneStampSettings: { family: "RENDER", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
+  setSceneLineSettings: { family: "RENDER", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setMetaballElements: { family: "GEOMETRY", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   sculptStroke: { family: "SCULPT", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },
   setSculptMeshAttributes: { family: "SCULPT", route: "MAIN_AUTHORITATIVE", implementation: "SOURCE_BACKED" },

web/protocol/web-engine.ts

@@ -163,6 +163,7 @@ export type WebEngineEditCommand =
   | { type: "setSceneSamplingSettings"; dataId: string; properties: { pixelAspectX?: number; pixelAspectY?: number; filterSize?: number; dither?: number } }
   | { type: "setSceneMultiviewSettings"; dataId: string; properties: { enabled?: boolean; viewsFormat?: 0 | 1; imageViewsFormat?: 0 | 1 | 2; stereoDisplayMode?: 0 | 1 | 2 | 3 | 4; interlaceSwap?: boolean; sideBySideCrossed?: boolean; squeezedFrame?: boolean } }
   | { type: "setSceneStampSettings"; dataId: string; properties: { stampMask?: number; fontId?: number; userText?: string; foreground?: [number, number, number, number]; background?: [number, number, number, number] } }
+  | { type: "setSceneLineSettings"; dataId: string; properties: { mode?: 1 | 2; thickness?: number } }
   | { type: "setMetaballElements"; dataId: string; elements: Array<{ type: number; position: [number, number, number]; radius: number; scale: [number, number, number] }> }
   | { type: "sculptStroke"; stroke: SculptStrokeIR }
   | { type: "setSculptMeshAttributes"; attributes: SculptMeshAttributesIR }

web/protocol/workbench-command-groups.ts

@@ -4,7 +4,7 @@ export const WORKBENCH_COMMAND_GROUPS = Object.freeze({
   OBJECT: ["createPrimitive", "duplicateObject", "deleteObject", "setObjectTransform", "setParent", "createCollection", "moveObjectToCollection", "renameId", "applyObjectTransform", "setObjectOrigin"],
   MESH: ["meshEdit", "translateMeshVertices", "createUVMap", "setActiveUVMap", "unwrapUV", "setVertexColors", "setVertexWeights"],
   ANIMATION: ["setFrame", "insertObjectKeyframe", "deleteObjectKeyframe", "setFCurveInterpolation", "setConstraint", "setNLAStack"],
-  RENDER: ["setCameraProperties", "setLightProperties", "setWorldProperties", "setSceneProperties", "setSceneRenderSettings", "setSceneAudioSettings", "setSceneUnitSettings", "setSceneTimelineSettings", "setScenePipelineSettings", "setSceneBindings", "setSceneViewLayerSettings", "setSceneCollectionSettings", "setSceneBorderSettings", "setSceneSimplifySettings", "setSceneColorManagement", "setSceneImageFormat", "setSceneMotionBlur", "setSceneHairSettings", "setSceneCompositorSettings", "setScenePerformanceSettings", "setSceneSamplingSettings", "setSceneMultiviewSettings", "setSceneStampSettings"],
+  RENDER: ["setCameraProperties", "setLightProperties", "setWorldProperties", "setSceneProperties", "setSceneRenderSettings", "setSceneAudioSettings", "setSceneUnitSettings", "setSceneTimelineSettings", "setScenePipelineSettings", "setSceneBindings", "setSceneViewLayerSettings", "setSceneCollectionSettings", "setSceneBorderSettings", "setSceneSimplifySettings", "setSceneColorManagement", "setSceneImageFormat", "setSceneMotionBlur", "setSceneHairSettings", "setSceneCompositorSettings", "setScenePerformanceSettings", "setSceneSamplingSettings", "setSceneMultiviewSettings", "setSceneStampSettings", "setSceneLineSettings"],
   IO: ["importImage", "importVFont", "setMaterialImageNode"],
 } as const satisfies Record<string, readonly WebEngineCommandType[]>);