@snaptrude/plugin-core 0.9.14 → 0.9.16

package/api-manifest.json

@@ -494,6 +494,30 @@
     "argsType": null,
     "resultType": "PluginCameraMode"
   },
+  {
+    "path": "core.camera.getNavigationSettings",
+    "namespace": "core.camera",
+    "summary": "Read the arrow-key navigation settings: whether the arrow keys walk the camera, the eye height used by `setPose`'s `standAt` and by walkthroughs that follow the floor, the walking speed, and whether walking stops at walls. Paired with {@linkcode PluginCameraApi.updateNavigationSettings}.",
+    "examplePrompts": [
+      "Is arrow-key navigation on?",
+      "What eye height does the camera use?\n\n# Example\n```ts\nconst { isKeyboardNavigationEnabled } =\nawait snaptrude.core.camera.getNavigationSettings()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCameraNavigationSettings"
+  },
+  {
+    "path": "core.camera.getPose",
+    "namespace": "core.camera",
+    "summary": "Read where the camera is and where it looks: the eye and target positions (world coordinates, internal `babylon` units), the view direction as yaw and pitch, the vertical field of view, the projection and the 2D/3D mode. Paired with {@linkcode PluginCameraApi.setPose}.",
+    "examplePrompts": [
+      "Where is the camera right now?",
+      "Remember this viewpoint so we can come back to it",
+      "Which way is the camera facing?",
+      "How high above the ground is the camera?\n\n# Example\n```ts\nconst pose = await snaptrude.core.camera.getPose()\nconsole.log(pose.eye, pose.yawInDegrees, pose.pitchInDegrees)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginCameraPose"
+  },
   {
     "path": "core.camera.getProjection",
     "namespace": "core.camera",
@@ -519,6 +543,31 @@
     "argsType": "Vec3Handle",
     "resultType": "boolean"
   },
+  {
+    "path": "core.camera.move",
+    "namespace": "core.camera",
+    "summary": "Walk or fly the camera by a displacement in its own frame: `forward` along the level view direction, `right` to its side and `up` vertically, in internal `babylon` units. The view direction does not change. With `options.followsFloor` the camera keeps its height above the floor as it goes, climbing and descending stairs and ramps the way the arrow keys do. Stops a playing walkthrough and switches from 2D plan view to 3D first. View-state only: not write-gated, not undoable.",
+    "examplePrompts": [
+      "Walk forward 3 metres",
+      "Step to the right a little",
+      "Walk up the stairs ahead",
+      "Raise the camera by 2 metres\n\n# Example\n```ts\nconst metre = 1 / 0.254\nawait snaptrude.core.camera.move(\n{ forward: 3 * metre },\n{ followsFloor: true, durationInSeconds: 2 },\n)\n```"
+    ],
+    "argsType": "PluginCameraMoveDisplacement",
+    "resultType": "PluginCameraPose"
+  },
+  {
+    "path": "core.camera.rotate",
+    "namespace": "core.camera",
+    "summary": "Turn the camera in place by signed angles: `yawInDegrees` to the right (clockwise seen from above) and `pitchInDegrees` up. The eye does not move; the resulting pitch is kept within ±89°. Stops a playing walkthrough and switches from 2D plan view to 3D first. View-state only: not write-gated, not undoable.",
+    "examplePrompts": [
+      "Turn around",
+      "Look 45 degrees to the left",
+      "Tilt the camera down a bit\n\n# Example\n```ts\nawait snaptrude.core.camera.rotate(180, 0, { durationInSeconds: 1 })\n```"
+    ],
+    "argsType": "number",
+    "resultType": "PluginCameraPose"
+  },
   {
     "path": "core.camera.setMode",
     "namespace": "core.camera",
@@ -532,6 +581,19 @@
     "argsType": "PluginCameraMode",
     "resultType": "boolean"
   },
+  {
+    "path": "core.camera.setPose",
+    "namespace": "core.camera",
+    "summary": "Place the camera, optionally easing there over `options.durationInSeconds`, and resolve once the new view has been drawn, so a capture that follows sees it without a fixed wait. `pose` is one of:",
+    "examplePrompts": [
+      "Stand in the living room at eye level facing the window",
+      "Move the camera to (40, 12, 30) looking at the entrance",
+      "Fly the camera smoothly over to the courtyard",
+      "Put me back at the viewpoint we saved earlier\n\n# Example\n```ts\nconst { camera } = snaptrude.core\nawait camera.setPose({ standAt: { x: 20, y: 0, z: 35 }, yawInDegrees: 90 })\nawait camera.setPose(\n{ eye: { x: 60, y: 25, z: 60 }, target: { x: 0, y: 5, z: 0 } },\n{ durationInSeconds: 1.5 },\n)\n```"
+    ],
+    "argsType": "PluginCameraPoseInput",
+    "resultType": "PluginCameraPose"
+  },
   {
     "path": "core.camera.setProjection",
     "namespace": "core.camera",
@@ -559,6 +621,18 @@
     "argsType": "PluginStandardView",
     "resultType": "boolean"
   },
+  {
+    "path": "core.camera.updateNavigationSettings",
+    "namespace": "core.camera",
+    "summary": "Change arrow-key navigation settings; only the fields given change. `isKeyboardNavigationEnabled` is the user's Project Settings switch and is saved on this device; the other settings last for the session. Write-gated: this changes the user's preferences, not just the view.",
+    "examplePrompts": [
+      "Turn off arrow-key navigation",
+      "Use a 1.6 m eye height",
+      "Make walking stop at walls\n\n# Example\n```ts\nawait snaptrude.core.camera.updateNavigationSettings({\neyeHeight: 1.6 / 0.254,\nisCollisionEnabled: true,\n})\n```"
+    ],
+    "argsType": "PluginCameraNavigationSettingsPatch",
+    "resultType": "PluginCameraNavigationSettings"
+  },
   {
     "path": "core.camera.zoomExtents",
     "namespace": "core.camera",
@@ -3249,14 +3323,55 @@
     "argsType": "UnderlayHandle",
     "resultType": "{ scaleFactor: number }"
   },
+  {
+    "path": "core.layers.assign",
+    "namespace": "core.layers",
+    "summary": "Move objects onto a layer (picking a layer in the object properties panel).",
+    "examplePrompts": [
+      "Move the selected objects to the BIM layer",
+      "Move the selected objects to the Furniture layer",
+      "Assign the generated walls to the Structure layer",
+      "Put these masses on layer 3f2a…\n\n# Example\n```ts\nconst { assigned, skipped } = await snaptrude.core.layers.assign(ids, layerId)\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginCoreLayersAssignResult"
+  },
+  {
+    "path": "core.layers.create",
+    "namespace": "core.layers",
+    "summary": "Create a new layer in the Layers panel (the panel's \"Add new layer\" button followed by naming it).",
+    "examplePrompts": [
+      "Create a new layer called Furniture",
+      "Add a layer called Landscape",
+      "Add a layer named Landscape to the Layers panel",
+      "Make a new layer for the facade elements",
+      "Create layers named Structure and Services\n\n# Example\n```ts\nconst layer = await snaptrude.core.layers.create(\"Furniture\")\nawait snaptrude.core.layers.setActive(layer.id)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersCreateResult"
+  },
+  {
+    "path": "core.layers.delete",
+    "namespace": "core.layers",
+    "summary": "Delete a layer (the panel row's \"Delete layer\").",
+    "examplePrompts": [
+      "Delete the Furniture layer and everything on it",
+      "Delete the Furniture layer and move its objects to Default",
+      "Remove layer 3f2a… and move its objects to the default layer",
+      "Merge the Services layer into Structure and delete it",
+      "Delete every empty layer\n\n# Example\n```ts\nawait snaptrude.core.layers.delete(layerId, { deleteObjects: true })\nconst { layers } = await snaptrude.core.layers.list()\nconst def = layers.find((l) => l.isDefault)!\nawait snaptrude.core.layers.delete(otherId, { targetLayerId: def.id })\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersDeleteResult"
+  },
   {
     "path": "core.layers.get",
     "namespace": "core.layers",
-    "summary": "Get a single drawing layer by id.",
+    "summary": "Get one Layers-panel layer by id, including layers owned by other design options.",
     "examplePrompts": [
-      "Get the drawing layer with id ly_5",
-      "Is layer ly_5 hidden or locked?",
-      "Look up a single drawing layer by its id\n\n# Example\n```ts\nconst layer = await snaptrude.core.layers.get(\"ly_5\")\nif (layer) console.log(layer.name, layer.hidden, layer.locked)\n```"
+      "Get the Layers-panel layer with id 3f2a…",
+      "Is the Furniture layer locked or hidden?",
+      "How many objects are on layer 3f2a…?\n\n# Example\n```ts\nconst layer = await snaptrude.core.layers.get(layerId)\nif (layer) console.log(layer.name, layer.objectCount)\n```"
     ],
     "argsType": "string",
     "resultType": "PluginCoreLayersGetResult"
@@ -3264,35 +3379,51 @@
   {
     "path": "core.layers.getActive",
     "namespace": "core.layers",
-    "summary": "Get the active drawing layer of a storey.",
+    "summary": "Get the active Layers-panel layer: the one new objects land on.",
     "examplePrompts": [
-      "Which drawing layer is active on this storey?",
-      "Get the current layer on storey st_2",
-      "What layer am I drawing on?\n\n# Example\n```ts\nconst active = await snaptrude.core.layers.getActive(\"st_2\")\nif (active) console.log(active.name)\n```"
+      "Which layer is active?",
+      "Which layer in the Layers panel is active?",
+      "What layer will new objects go on?",
+      "Which layer are new walls and masses being added to?\n\n# Example\n```ts\nconst active = await snaptrude.core.layers.getActive()\nif (active) console.log(active.name)\n```"
     ],
-    "argsType": "string",
+    "argsType": null,
     "resultType": "PluginCoreLayersGetActiveResult"
   },
   {
     "path": "core.layers.list",
     "namespace": "core.layers",
-    "summary": "List the drawing layers of a storey.",
+    "summary": "List the layers in the Layers panel: the active design option's layers, default layer first, then in creation order.",
     "examplePrompts": [
-      "List the drawing layers on this storey",
-      "Show all the PDF underlays on storey st_2",
-      "What CAD layers are on the ground floor?\n\n# Example\n```ts\nconst { layers } = await snaptrude.core.layers.list(\"st_2\")\nfor (const l of layers) console.log(l.name, l.layerType, l.hidden)\n```"
+      "List all the layers in the Layers panel",
+      "Show me the layers in the left sidebar",
+      "What layers does this project have?",
+      "Show every layer with whether it is locked or hidden",
+      "Which layer is the default layer?",
+      "Which layers are empty?\n\n# Example\n```ts\nconst { layers } = await snaptrude.core.layers.list()\nfor (const l of layers) console.log(l.name, l.objectCount, l.locked, l.hidden)\n```"
     ],
-    "argsType": "string",
+    "argsType": null,
     "resultType": "PluginCoreLayersListResult"
   },
+  {
+    "path": "core.layers.rename",
+    "namespace": "core.layers",
+    "summary": "Rename a layer (the panel row's \"Rename layer\").",
+    "examplePrompts": [
+      "Rename the Furniture layer to Loose furniture",
+      "Rename layer 3f2a… to Existing building",
+      "Change the name of the Landscape layer\n\n# Example\n```ts\nawait snaptrude.core.layers.rename(layerId, \"Loose furniture\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreLayersRenameResult"
+  },
   {
     "path": "core.layers.setActive",
     "namespace": "core.layers",
-    "summary": "Make a drawing layer the active layer of its storey.",
+    "summary": "Make a layer the active layer (clicking its row in the Layers panel).",
     "examplePrompts": [
-      "Draw on layer ly_5",
-      "Make this the active layer",
-      "Switch the active layer to the CAD underlay\n\n# Example\n```ts\nawait snaptrude.core.layers.setActive(\"ly_5\")\n```"
+      "Put new objects on the Furniture layer",
+      "Make the Structure layer the active layer in the Layers panel",
+      "Switch the active layer to Landscape\n\n# Example\n```ts\nawait snaptrude.core.layers.setActive(layerId)\n```"
     ],
     "argsType": "string",
     "resultType": "PluginCoreLayersSetActiveResult"
@@ -3300,11 +3431,12 @@
   {
     "path": "core.layers.update",
     "namespace": "core.layers",
-    "summary": "Update a drawing layer's visibility.",
+    "summary": "Lock/unlock or show/hide a layer (the panel row's padlock and eye).",
     "examplePrompts": [
-      "Hide the PDF underlay layer",
-      "Show the CAD layer again",
-      "Hide layer ly_5\n\n# Example\n```ts\nconst layer = await snaptrude.core.layers.update(\"ly_5\", true)\n```"
+      "Lock the Default layer",
+      "Lock the Structure layer",
+      "Hide the Landscape layer in the Layers panel",
+      "Unlock layer 3f2a… and show it again\n\n# Example\n```ts\nawait snaptrude.core.layers.update(layerId, { locked: true, hidden: false })\n```"
     ],
     "argsType": "string",
     "resultType": "PluginCoreLayersUpdateResult"
@@ -4034,6 +4166,66 @@
     "argsType": null,
     "resultType": "number"
   },
+  {
+    "path": "core.storeys.layers.get",
+    "namespace": "core.storeys.layers",
+    "summary": "Get a single storey layer by id.",
+    "examplePrompts": [
+      "Get the storey drawing layer with id ly_5",
+      "Is storey layer ly_5 hidden?",
+      "Look up a storey underlay layer by id\n\n# Example\n```ts\nconst layer = await snaptrude.core.storeys.layers.get(\"ly_5\")\nif (layer) console.log(layer.name, layer.hidden, layer.locked)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreStoreysLayersGetResult"
+  },
+  {
+    "path": "core.storeys.layers.getActive",
+    "namespace": "core.storeys.layers",
+    "summary": "Get the active storey layer of a storey.",
+    "examplePrompts": [
+      "Which sketch surface (Wall/Rough) is active on this storey?",
+      "Get the active storey drawing layer on st_2",
+      "Which storey layer is new sketch geometry drawn onto?\n\n# Example\n```ts\nconst active = await snaptrude.core.storeys.layers.getActive(\"st_2\")\nif (active) console.log(active.name)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreStoreysLayersGetActiveResult"
+  },
+  {
+    "path": "core.storeys.layers.list",
+    "namespace": "core.storeys.layers",
+    "summary": "List the storey layers of a storey.",
+    "examplePrompts": [
+      "List the sketch surfaces and underlays on this storey",
+      "Show all the PDF underlays on storey st_2",
+      "What CAD layers are on the ground floor?\n\n# Example\n```ts\nconst { layers } = await snaptrude.core.storeys.layers.list(\"st_2\")\nfor (const l of layers) console.log(l.name, l.layerType, l.hidden)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreStoreysLayersListResult"
+  },
+  {
+    "path": "core.storeys.layers.setActive",
+    "namespace": "core.storeys.layers",
+    "summary": "Make a storey layer the active layer of its storey.",
+    "examplePrompts": [
+      "Switch this storey's sketch surface to the Rough layer",
+      "Make storey layer ly_5 the active sketch surface",
+      "Switch the active storey layer to the CAD underlay\n\n# Example\n```ts\nawait snaptrude.core.storeys.layers.setActive(\"ly_5\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreStoreysLayersSetActiveResult"
+  },
+  {
+    "path": "core.storeys.layers.update",
+    "namespace": "core.storeys.layers",
+    "summary": "Update a storey layer's visibility.",
+    "examplePrompts": [
+      "Hide the PDF underlay layer",
+      "Show the CAD underlay again",
+      "Hide storey layer ly_5\n\n# Example\n```ts\nconst layer = await snaptrude.core.storeys.layers.update(\"ly_5\", true)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCoreStoreysLayersUpdateResult"
+  },
   {
     "path": "core.storeys.list",
     "namespace": "core.storeys",
@@ -4761,17 +4953,18 @@
   {
     "path": "design.create.wallRuns",
     "namespace": "design.create",
-    "summary": "Create **many wall runs** in one undoable operation (bulk plural of {@linkcode walls}). Each item is one full run — a wall per curve in that item's profile chain, mitred at shared endpoints. Junctions resolve within a run, not between runs. Each item carries its own dimensions, `wallType` and `storey`, so a single call can build a whole floor plate or several storeys at once. Validate-all-or-throw; one command.",
+    "summary": "Create **many wall runs** in one undoable operation (bulk plural of {@linkcode walls}). Each item is one full run — a wall per curve in that item's profile chain, mitred at shared endpoints. Junctions resolve within a run, not between runs. Each item carries its own dimensions, `wallType` and `storey`, so a single call can build a whole floor plate or several storeys at once. Per-curve `topProfiles` make raked or gabled walls (see {@linkcode PluginWallTopProfile}). Validate-all-or-throw; one command.",
     "examplePrompts": [
       "Draw all the walls of this floor plan at once",
       "Build every room's perimeter in one operation",
       "Bulk create wall runs from these centerlines",
       "Create the walls for both storeys in a single undo step",
-      "Turn these polylines into 200mm brick walls together"
+      "Turn these polylines into 200mm brick walls together",
+      "Import these raked walls with their top profiles in one go"
     ],
     "argsType": "PluginCreateWallRunItem[]",
     "resultType": "ComponentHandle[][]",
-    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry. Always prefer this over calling `design.create.walls` in a loop: build the full `items[]` array first (all profiles up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const ground = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), await v.new(8, 0, 6), ]) const upper = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), ]) const [groundWalls, upperWalls] = await snaptrude.design.create.wallRuns([ { profile: ground, height: 3, thickness: 0.2 }, { profile: upper, height: 3, storey: 2 }, ]) console.log(groundWalls.length, \"walls on the ground floor\") ```"
+    "performance": "Bulk creator — the whole batch is ONE host round-trip and ONE undo entry. Always prefer this over calling `design.create.walls` in a loop: build the full `items[]` array first (all profiles up front), then make one call. # Example ```ts const v = snaptrude.core.math.vec3 const ground = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), await v.new(8, 0, 6), ]) const upper = await snaptrude.core.geom.create.profileFromLinePoints([ await v.new(0, 0, 0), await v.new(8, 0, 0), ]) const [groundWalls, upperWalls] = await snaptrude.design.create.wallRuns([ { profile: ground, height: 3, thickness: 0.2 }, { profile: upper, height: 3, storey: 2 }, // one gable wall: 3m at both ends, 5m ridge in the middle { profile: upper, thickness: 0.2, storey: 3, topProfiles: [[{ along: 0, height: 3 }, { along: 0.5, height: 5 }, { along: 1, height: 3 }]] }, ]) console.log(groundWalls.length, \"walls on the ground floor\") ```"
   },
   {
     "path": "design.create.walls",
@@ -4784,7 +4977,10 @@
       "Turn this polyline sketch into walls",
       "Add walls with mitred corners along the path",
       "Draw brick walls with plaster along this outline",
-      "Build the perimeter in exposed concrete walls\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst centerlines = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(8, 0, 0),\nawait v.new(8, 0, 6),\n])\nconst walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)\n// …built as a specific wall type (layers/material/thickness from the type):\nconst [brick] = await snaptrude.design.types.list(\"wall\")\nconst brickWalls = await snaptrude.design.create.walls(\ncenterlines, 3, undefined, brick.label,\n)\n```"
+      "Build the perimeter in exposed concrete walls",
+      "Create a raked wall that slopes from 3m to 5m",
+      "Build a gable end wall with the ridge in the middle",
+      "Draw a wall with a sloped top edge\n\n# Example\n```ts\nconst v = snaptrude.core.math.vec3\nconst centerlines = await snaptrude.core.geom.create.profileFromLinePoints([\nawait v.new(0, 0, 0),\nawait v.new(8, 0, 0),\nawait v.new(8, 0, 6),\n])\nconst walls = await snaptrude.design.create.walls(centerlines, 3, 0.2)\n// …built as a specific wall type (layers/material/thickness from the type):\nconst [brick] = await snaptrude.design.types.list(\"wall\")\nconst brickWalls = await snaptrude.design.create.walls(\ncenterlines, 3, undefined, brick.label,\n)\n// …a raked wall (3m at the start, 5m at the end) on a single centerline:\nconst run = await snaptrude.core.geom.create.profileFromCurves([\nawait snaptrude.core.geom.create.line(await v.new(0, 0, 10), await v.new(8, 0, 10)),\n])\nconst [raked] = await snaptrude.design.create.walls(run, undefined, 0.2, undefined, undefined, [\n[{ along: 0, height: 3 }, { along: 1, height: 5 }],\n])\n```"
     ],
     "argsType": "ProfileHandle",
     "resultType": "ComponentHandle[]",
@@ -6489,6 +6685,21 @@
     "argsType": "ComponentHandle",
     "resultType": "boolean"
   },
+  {
+    "path": "design.update.setObjectType",
+    "namespace": "design.update",
+    "summary": "Change the **object type** of one or more masses — turn a mass into a real wall, roof, slab or floor: the properties panel's Object Type dropdown, headless. The geometry is kept exactly as it is (a wedge stays a wedge; nothing is flattened to a default thickness), so a sloped mass built with `design.create.massFromBrep` becomes a sloped roof or a raked wall. The component keeps its handle, label and storey; it gains the target type's construction layers and properties, and the type's default material when the mass still wore the default. One undoable operation for the whole list; undo turns them back into masses.",
+    "examplePrompts": [
+      "Convert this mass into a wall",
+      "Turn the sloped mass into a roof",
+      "Make these masses real slabs",
+      "Change the object type of the selection to wall",
+      "Convert the wedge I built into a raked wall",
+      "Turn this mass into a floor\n\n# Example\n```ts\nconst brep = await snaptrude.core.geom.create.brepFromFaces(wedgeFaces)\nconst wedge = await snaptrude.design.create.massFromBrep(brep, \"Gable end\")\nconst { affected } = await snaptrude.design.update.setObjectType([wedge], \"wall\")\nconsole.log(await snaptrude.design.query.getEntityType(affected[0])) // \"wall\"\n```"
+    ],
+    "argsType": "ComponentHandle[]",
+    "resultType": "PluginDesignChangeResult"
+  },
   {
     "path": "design.update.setStorey",
     "namespace": "design.update",
@@ -7198,6 +7409,70 @@
     "argsType": "string",
     "resultType": "PluginPresentationAnnotateTextResult"
   },
+  {
+    "path": "presentation.camera.capture",
+    "namespace": "presentation.camera",
+    "summary": "Screenshot what the Present canvas currently shows.",
+    "examplePrompts": [
+      "Take a screenshot of the Present canvas",
+      "Capture what I am looking at in Present mode",
+      "Screenshot the presentation canvas as a JPEG",
+      "Grab a high-res image of the current sheet view\n\n# Example\n```ts\nconst { image, width, height } = await snaptrude.presentation.camera.capture({\nformat: \"png\",\npixelRatio: 2,\n})\n```"
+    ],
+    "argsType": "{\n    format?: PluginPresentationImageFormat\n    pixelRatio?: number\n  }",
+    "resultType": "PluginPresentationCameraCaptureResult"
+  },
+  {
+    "path": "presentation.camera.get",
+    "namespace": "presentation.camera",
+    "summary": "Read the Present camera: pan, zoom, the visible page-space rectangle and the sheet under the centre of the view.",
+    "examplePrompts": [
+      "Where is the Present canvas camera?",
+      "What zoom level is Present mode at?",
+      "Which sheet is on screen right now?",
+      "Read the visible area of the presentation canvas\n\n# Example\n```ts\nconst { zoom, sheetId } = await snaptrude.presentation.camera.get()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationCameraState"
+  },
+  {
+    "path": "presentation.camera.set",
+    "namespace": "presentation.camera",
+    "summary": "Pan and/or zoom the Present canvas. Fields left out keep their current value, so `{ zoom: 2 }` changes only the zoom (the page point at the viewport's top-left corner stays put) and `{ x, y }` pans at the current zoom. `zoom` is clamped to the editor's range (1% to 1000%); the requested `x`/`y` are always honoured. Immediate (no animation). View-state only — not undoable.",
+    "examplePrompts": [
+      "Zoom the Present canvas to 50%",
+      "Pan the presentation canvas to the right",
+      "Restore the Present camera I saved earlier",
+      "Set the Present zoom to 200% without moving\n\n# Example\n```ts\nconst saved = await snaptrude.presentation.camera.get()\nawait snaptrude.presentation.camera.set({ zoom: 0.5 })\n// …later, restore the exact framing\nawait snaptrude.presentation.camera.set({ x: saved.x, y: saved.y, zoom: saved.zoom })\n```"
+    ],
+    "argsType": "{\n    x?: number\n    y?: number\n    zoom?: number\n  }",
+    "resultType": "PluginPresentationCameraState"
+  },
+  {
+    "path": "presentation.camera.zoomTo",
+    "namespace": "presentation.camera",
+    "summary": "Frame one shape on the Present canvas: a sheet, a placed view, a keyed shape or an annotation — any id the other `presentation` namespaces hand out. Pair with {@linkcode PluginPresentationCameraApi.capture} to screenshot a single sheet or placed view as it appears on screen. Immediate, unlike `sheets.setActive`, which animates its move over half a second. View-state only — not undoable.",
+    "examplePrompts": [
+      "Zoom in on sheet 2 in Present mode",
+      "Frame this placed view on the Present canvas",
+      "Go to the cover sheet and screenshot it",
+      "Centre the presentation view on that table\n\n# Example\n```ts\nconst { sheets } = await snaptrude.presentation.sheets.list()\nawait snaptrude.presentation.camera.zoomTo(sheets[1].id)\nconst { image } = await snaptrude.presentation.camera.capture()\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationCameraState"
+  },
+  {
+    "path": "presentation.camera.zoomToFit",
+    "namespace": "presentation.camera",
+    "summary": "Frame everything on the Present canvas — every sheet and loose shape — the Present-mode \"zoom to fit\". View-state only — not undoable.",
+    "examplePrompts": [
+      "Zoom out to see all the sheets",
+      "Fit the whole presentation in the Present view",
+      "Zoom to fit in Present mode\n\n# Example\n```ts\nawait snaptrude.presentation.camera.zoomToFit()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationCameraState"
+  },
   {
     "path": "presentation.diagrams.generateProgram",
     "namespace": "presentation.diagrams",
@@ -7914,6 +8189,232 @@
     "argsType": "string",
     "resultType": "PluginPresentationViewsUpdateSettingsResult"
   },
+  {
+    "path": "presentation.walkthroughs.cancelJob",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Cancel an export job. The recording stops and nothing is placed; a job that has already finished is returned unchanged. Write-gated.",
+    "examplePrompts": [
+      "Cancel the video export\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.cancelJob(jobId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughExportJob"
+  },
+  {
+    "path": "presentation.walkthroughs.capture",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Capture frames of a walkthrough as one contact-sheet image: a grid of views at evenly spaced moments (or at `options.timesInSeconds`), read left to right and top to bottom. The camera goes back to where it was afterwards. Switches from 2D plan view to 3D first.",
+    "examplePrompts": [
+      "Show me what the walkthrough looks like",
+      "Capture six frames of the fly-over\n\n# Example\n```ts\nconst { image } = await snaptrude.presentation.walkthroughs.capture(walkthroughId, {\ncount: 6,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughCaptureResult"
+  },
+  {
+    "path": "presentation.walkthroughs.create",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Create a walkthrough from full keyframes: where the camera stands at each and how it looks there (ahead along the path, at a target, or in a fixed direction). A keyframe that follows the floor stands at the walkthrough's eye height above the floor, stair, terrain or ground at or below its `eye`, and the path between two such keyframes climbs stairs and ramps. The new walkthrough opens in the walkthrough dock. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Make a walkthrough through these three viewpoints",
+      "Create a camera path that looks at the atrium the whole way\n\n# Example\n```ts\nconst walkthrough = await snaptrude.presentation.walkthroughs.create(\n[\n{ eye: { x: 0, y: 30, z: 80 }, look: { mode: \"target\", target: { x: 0, y: 10, z: 0 } } },\n{ eye: { x: 60, y: 30, z: 0 }, look: { mode: \"target\", target: { x: 0, y: 10, z: 0 } } },\n],\n{ name: \"Approach\", durationInSeconds: 10 },\n)\n```"
+    ],
+    "argsType": "PluginWalkthroughKeyframeInput[]",
+    "resultType": "PluginWalkthrough"
+  },
+  {
+    "path": "presentation.walkthroughs.createFromPoints",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Create a walkthrough that walks through points on the floor, the way the Walkthrough tool draws a route: the camera stands at eye height above the floor, stair, terrain or ground at each point, climbs stairs and ramps between them, and looks ahead along the path, or at `options.lookAt` the whole way. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Walk from the entrance through the lobby to the stairs",
+      "Make a walkthrough that visits every room on this floor",
+      "Create a loop around the courtyard\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.createFromPoints(\n[{ x: 0, y: 0, z: 0 }, { x: 40, y: 0, z: 0 }, { x: 40, y: 0, z: 30 }],\n{ name: \"Ground floor tour\" },\n)\n```"
+    ],
+    "argsType": "Vec3Components[]",
+    "resultType": "PluginWalkthrough"
+  },
+  {
+    "path": "presentation.walkthroughs.createFromPreset",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Create a walkthrough from a camera move around a subject, as the Walkthrough button's menu does: `orbit` circles it facing its middle, `flyOver` passes above it looking ahead and down, `pushIn` and `pullBack` move toward and away from it, and `rise` cranes up from eye level. The subject is `options.subject`, else the selection, else the visible model without its terrain; the move is sized to fit it in view and starts on the side the camera is on. While the walkthrough is still a preset, {@linkcode PluginPresentationWalkthroughsApi.update} can change its distance, height and direction; editing a keyframe makes it ordinary. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Orbit around the selected building",
+      "Make a drone fly-over of the site",
+      "Push in slowly toward the entrance",
+      "Crane up to reveal the whole campus\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.createFromPreset(\"orbit\", {\nsubject: [towerId],\nheightInDegrees: 35,\ndurationInSeconds: 20,\n})\n```"
+    ],
+    "argsType": "PluginWalkthroughPresetKind",
+    "resultType": "PluginWalkthrough"
+  },
+  {
+    "path": "presentation.walkthroughs.createKeyframe",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Add a keyframe to a walkthrough at `index` (0 to the keyframe count; default: the end). A preset walkthrough becomes ordinary. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Add a stop in the kitchen after the second point\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.createKeyframe(\nwalkthroughId,\n{ eye: { x: 12, y: 0, z: 30 }, followsFloor: true, holdInSeconds: 2 },\n2,\n)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthrough"
+  },
+  {
+    "path": "presentation.walkthroughs.delete",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Delete a walkthrough. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Delete the old walkthrough\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.delete(walkthroughId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "boolean"
+  },
+  {
+    "path": "presentation.walkthroughs.deleteKeyframe",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Remove a keyframe; the path then runs straight from the keyframe before it to the one after. Removing the last keyframe deletes the walkthrough. A preset walkthrough becomes ordinary. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Remove the third stop from the walkthrough\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.deleteKeyframe(walkthroughId, keyframeId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthrough | null"
+  },
+  {
+    "path": "presentation.walkthroughs.export",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Record a walkthrough as a video and place it on the Present canvas, as an asynchronous job: this resolves at once with the queued job, and {@linkcode PluginPresentationWalkthroughsApi.getJob} reports it until it completes, fails or is cancelled. Recording plays the walkthrough in real time at the chosen size, so it takes about as long as the walkthrough plus the upload; the editor switches to Present mode to place the video, which keeps playing muted in a loop there. Only one export runs at a time. Write-gated.",
+    "examplePrompts": [
+      "Export the walkthrough as a video",
+      "Put a 1080p video of the orbit on a sheet\n\n# Example\n```ts\nconst walkthroughs = snaptrude.presentation.walkthroughs\nlet job = await walkthroughs.export(walkthroughId, { quality: \"1080p\" })\nwhile (job.status === \"queued\" || job.status === \"running\") {\nawait new Promise((resolve) => setTimeout(resolve, 2000))\njob = (await walkthroughs.getJob(job.jobId))!\n}\nconsole.log(job.result?.shapeId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughExportJob"
+  },
+  {
+    "path": "presentation.walkthroughs.get",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Get one walkthrough by id.",
+    "examplePrompts": [
+      "Show me the keyframes of the orbit walkthrough",
+      "How long does this walkthrough take?\n\n# Example\n```ts\nconst walkthrough = await snaptrude.presentation.walkthroughs.get(walkthroughId)\nconsole.log(walkthrough?.durationInSeconds)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthrough | null"
+  },
+  {
+    "path": "presentation.walkthroughs.getJob",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Get an export job by id.",
+    "examplePrompts": [
+      "Is the video export done yet?\n\n# Example\n```ts\nconst job = await snaptrude.presentation.walkthroughs.getJob(jobId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughExportJob | null"
+  },
+  {
+    "path": "presentation.walkthroughs.getState",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Read the playback state: which walkthrough is playing or paused, and how far through it.",
+    "examplePrompts": [
+      "Is the walkthrough still playing?\n\n# Example\n```ts\nconst { status, timeInSeconds } = await snaptrude.presentation.walkthroughs.getState()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginWalkthroughPlaybackState"
+  },
+  {
+    "path": "presentation.walkthroughs.list",
+    "namespace": "presentation.walkthroughs",
+    "summary": "List the open project's walkthroughs, oldest first.",
+    "examplePrompts": [
+      "Which walkthroughs are there?",
+      "List the camera paths in this project\n\n# Example\n```ts\nconst { walkthroughs } = await snaptrude.presentation.walkthroughs.list()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginWalkthroughsListResult"
+  },
+  {
+    "path": "presentation.walkthroughs.listIssues",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Find places where a walkthrough's camera passes through the model: through anything walking would stop at, such as a wall, glazing, a column, a slab or a roof, which would show the inside of the geometry on screen. Doors, furniture and room masses don't count, as walking passes through them. Each issue gives the first moment and point of one pass. The camera itself does not move.",
+    "examplePrompts": [
+      "Does the walkthrough go through any walls?",
+      "Check the camera path for clashes and fix them\n\n# Example\n```ts\nconst { issues } = await snaptrude.presentation.walkthroughs.listIssues(walkthroughId)\nfor (const issue of issues) console.log(issue.timeInSeconds, issue.componentId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughListIssuesResult"
+  },
+  {
+    "path": "presentation.walkthroughs.listJobs",
+    "namespace": "presentation.walkthroughs",
+    "summary": "List export jobs, newest first: running ones and those that finished in the last 30 minutes.",
+    "examplePrompts": [
+      "Which video exports are running?\n\n# Example\n```ts\nconst { jobs } = await snaptrude.presentation.walkthroughs.listJobs()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginWalkthroughListJobsResult"
+  },
+  {
+    "path": "presentation.walkthroughs.reorderKeyframe",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Move a keyframe to position `index` in the walkthrough's order (the `presentation.sheets.reorder` convention). A preset walkthrough becomes ordinary. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Visit the terrace before the living room\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.reorderKeyframe(walkthroughId, keyframeId, 0)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthrough"
+  },
+  {
+    "path": "presentation.walkthroughs.sample",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Sample where the camera is and which way it looks at given moments of a walkthrough's playback, without moving the camera.",
+    "examplePrompts": [
+      "Where is the camera halfway through the walkthrough?",
+      "Check how high the camera flies over the roof\n\n# Example\n```ts\nconst walkthrough = await snaptrude.presentation.walkthroughs.get(walkthroughId)\nconst { samples } = await snaptrude.presentation.walkthroughs.sample(walkthroughId, [\n0,\nwalkthrough!.durationInSeconds / 2,\n])\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughSampleResult"
+  },
+  {
+    "path": "presentation.walkthroughs.start",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Play a walkthrough in the viewport, from the start or `options.fromTimeInSeconds`. Arrow-key navigation pauses while it plays; {@linkcode PluginPresentationWalkthroughsApi.stop} puts the camera back where it was. Switches from 2D plan view to 3D first. Resolves once playback has started; a walkthrough that is already playing keeps playing.",
+    "examplePrompts": [
+      "Play the walkthrough",
+      "Show me the orbit\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.start(walkthroughId)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthroughPlaybackState"
+  },
+  {
+    "path": "presentation.walkthroughs.stop",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Stop playback and put the camera back where it was before it started. A no-op when nothing is playing.",
+    "examplePrompts": [
+      "Stop the walkthrough\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.stop()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginWalkthroughPlaybackState"
+  },
+  {
+    "path": "presentation.walkthroughs.update",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Change a walkthrough: only the fields given change. Speed and duration are two ways to set one thing, so give at most one of them. `preset` changes a preset walkthrough's camera move and makes its keyframes again, keeping its duration; changing `isLoop` of a preset walkthrough makes it ordinary. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Slow the walkthrough down to 30 seconds",
+      "Rename it to \"Evening approach\"",
+      "Make the orbit go the other way round and higher up\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.update(walkthroughId, {\ndurationInSeconds: 30,\nisRepeating: true,\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthrough"
+  },
+  {
+    "path": "presentation.walkthroughs.updateKeyframe",
+    "namespace": "presentation.walkthroughs",
+    "summary": "Change a keyframe: only the fields given change. A preset walkthrough becomes ordinary. Write-gated; one undo step.",
+    "examplePrompts": [
+      "Pause for three seconds at the second point",
+      "Make the last point look at the fireplace\n\n# Example\n```ts\nawait snaptrude.presentation.walkthroughs.updateKeyframe(walkthroughId, keyframeId, {\nlook: { mode: \"target\", target: { x: 5, y: 4, z: 10 } },\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginWalkthrough"
+  },
   {
     "path": "program.adjacency.compute",
     "namespace": "program.adjacency",