@snaptrude/plugin-core 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @snaptrude/plugin-core
 
+## 0.9.2
+
+### Patch Changes
+
+- 5b91c7b: OCC geometry batch: new `core.geom.create` brep constructors — `brepFromFillet`, `brepFromChamfer`, `brepFromOffset`, `brepFromShell`, `brepsFromSplit`, `brepFromSweep`, `brepFromRevolution`; `brepFromLoft` widened with optional `intermediateContours` (multi-section lofts); new `core.geom.query.brep.getDistance` (minimum distance between two solids with witness points).
+
 ## 0.9.1
 
 ### Patch Changes

package/api-manifest.full.json

@@ -715,6 +715,18 @@
     "argsType": "Vec3Handle",
     "resultType": "ArcHandle"
   },
+  {
+    "path": "core.geom.create.brepFromChamfer",
+    "namespace": "core.geom.create",
+    "summary": "Bevels the given straight edges of a solid with a symmetric planar cut. Host API call — returns a new {@linkcode BrepHandle}; the input brep is read-only.",
+    "examplePrompts": [
+      "Bevel these edges by 100mm",
+      "Chamfer the top edges of the plinth",
+      "Cut a 45-degree flat along the corners of this mass\n\n# Example\n```ts\nconst brep = await snaptrude.core.geom.create.brepFromExtrusion(contour, { x: 0, y: 1, z: 0 }, 3)\nconst edges = await snaptrude.core.geom.query.brep.listEdges(brep)\nconst beveled = await snaptrude.core.geom.create.brepFromChamfer(brep, [edges[0]], 0.1)\n```"
+    ],
+    "argsType": "BrepHandle",
+    "resultType": "BrepHandle"
+  },
   {
     "path": "core.geom.create.brepFromExtrusion",
     "namespace": "core.geom.create",
@@ -739,6 +751,18 @@
     "argsType": "Vec3Components[][]",
     "resultType": "BrepHandle"
   },
+  {
+    "path": "core.geom.create.brepFromFillet",
+    "namespace": "core.geom.create",
+    "summary": "Rounds the given straight edges of a solid with a constant radius. Host API call — returns a new {@linkcode BrepHandle}; the input brep is read-only.",
+    "examplePrompts": [
+      "Round the edges of this mass",
+      "Fillet the corners of the podium with a 0.5m radius",
+      "Soften the vertical edges of this tower\n\n# Example\n```ts\nconst brep = await snaptrude.core.geom.create.brepFromExtrusion(contour, { x: 0, y: 1, z: 0 }, 3)\nconst edges = await snaptrude.core.geom.query.brep.listEdges(brep)\nconst rounded = await snaptrude.core.geom.create.brepFromFillet(brep, [edges[0]], 0.3)\n```"
+    ],
+    "argsType": "BrepHandle",
+    "resultType": "BrepHandle"
+  },
   {
     "path": "core.geom.create.brepFromIntersection",
     "namespace": "core.geom.create",
@@ -754,11 +778,12 @@
   {
     "path": "core.geom.create.brepFromLoft",
     "namespace": "core.geom.create",
-    "summary": "Create a closed solid **B-rep** by lofting between a bottom and a top contour. Host API call — returns a {@linkcode BrepHandle}. Both contours must have the same number of edges (and matching hole counts); side faces connect corresponding edges by authored index. Corresponding edges must stay coplanar — a twisted loft would produce non-planar side faces and is rejected. The contours are copied — the input handles are never mutated.",
+    "summary": "Create a closed solid **B-rep** by lofting between a bottom and a top contour, optionally through intermediate cross-sections. Host API call — returns a {@linkcode BrepHandle}. All sections must have the same number of edges; side faces connect corresponding edges by authored index. Corresponding edges must stay coplanar segment to segment (matching hole counts allowed in the two-section form) — a twisted loft would produce non-planar side faces and is rejected. With intermediates the loft is a chain of ruled segments folded into one solid: sections must be planar and hole-free, ordered bottom → intermediates → top. The contours are copied — the input handles are never mutated.",
     "examplePrompts": [
       "Make a tapered tower from these two outlines",
       "Loft between a large base and a smaller top",
-      "Create a frustum from two squares\n\n# Example\n```ts\n// A square frustum: 4m base lofted to a 2m top, 3m up\nconst base = await snaptrude.core.geom.create.profileRect(4, 4)\nconst top = await snaptrude.core.geom.create.profileRect(2, 2, await snaptrude.core.math.vec3.new(0, 3, 0))\nconst brep = await snaptrude.core.geom.create.brepFromLoft(\nawait snaptrude.core.geom.create.contourFromProfile(base),\nawait snaptrude.core.geom.create.contourFromProfile(top),\n)\nconst faceCount = await snaptrude.core.geom.query.brep.getFaceCount(brep) // 6\n```"
+      "Create a frustum from two squares",
+      "Loft the tower through these three floor outlines\n\n# Example\n```ts\n// A square frustum: 4m base lofted to a 2m top, 3m up\nconst base = await snaptrude.core.geom.create.profileRect(4, 4)\nconst top = await snaptrude.core.geom.create.profileRect(2, 2, await snaptrude.core.math.vec3.new(0, 3, 0))\nconst brep = await snaptrude.core.geom.create.brepFromLoft(\nawait snaptrude.core.geom.create.contourFromProfile(base),\nawait snaptrude.core.geom.create.contourFromProfile(top),\n)\nconst faceCount = await snaptrude.core.geom.query.brep.getFaceCount(brep) // 6\n```"
     ],
     "argsType": "ContourHandle",
     "resultType": "BrepHandle"
@@ -775,6 +800,42 @@
     "argsType": "Vec3Components[]",
     "resultType": "BrepHandle"
   },
+  {
+    "path": "core.geom.create.brepFromOffset",
+    "namespace": "core.geom.create",
+    "summary": "Grows or shrinks a solid by offsetting every face — positive distance moves faces outward, negative moves them inward. Host API call — returns a new {@linkcode BrepHandle}; the input brep is read-only.",
+    "examplePrompts": [
+      "Grow this solid by 0.5m in every direction",
+      "Shrink this mass by 200mm",
+      "Offset the building envelope outward by 1m\n\n# Example\n```ts\nconst brep = await snaptrude.core.geom.create.brepFromExtrusion(contour, { x: 0, y: 1, z: 0 }, 3)\nconst grown = await snaptrude.core.geom.create.brepFromOffset(brep, 0.5)\n```"
+    ],
+    "argsType": "BrepHandle",
+    "resultType": "BrepHandle"
+  },
+  {
+    "path": "core.geom.create.brepFromRevolution",
+    "namespace": "core.geom.create",
+    "summary": "Revolves a planar profile about an axis to make a solid of revolution — a full turn by default. Host API call — returns a new {@linkcode BrepHandle}; the input contour is read-only. Holes in the profile are allowed. Profile segments must stay parallel or perpendicular to the axis — inclined or arc segments would revolve into surfaces Snaptrude cannot represent.",
+    "examplePrompts": [
+      "Create a dome from this section",
+      "Revolve this profile 360 degrees around the vertical axis",
+      "Build a rotunda by revolving this wall section\n\n# Example\n```ts\n// A cylinder: revolve a 2m-wide, 3m-tall rectangle about the Y axis at its edge\nconst rect = await snaptrude.core.geom.create.profileFromLinePoints([\nawait snaptrude.core.math.vec3.new(0, 0, 0),\nawait snaptrude.core.math.vec3.new(2, 0, 0),\nawait snaptrude.core.math.vec3.new(2, 3, 0),\nawait snaptrude.core.math.vec3.new(0, 3, 0),\n])\nconst profile = await snaptrude.core.geom.create.contourFromProfile(rect)\nconst cylinder = await snaptrude.core.geom.create.brepFromRevolution(\nprofile,\n{ x: 0, y: 0, z: 0 },\n{ x: 0, y: 1, z: 0 },\n)\n```"
+    ],
+    "argsType": "ContourHandle",
+    "resultType": "BrepHandle"
+  },
+  {
+    "path": "core.geom.create.brepFromShell",
+    "namespace": "core.geom.create",
+    "summary": "Hollows a solid into constant-thickness walls, removing the given faces as openings. Host API call — returns a new {@linkcode BrepHandle}; the input brep is read-only. The outer surface is kept and the walls grow inward.",
+    "examplePrompts": [
+      "Hollow this mass into 200mm walls",
+      "Shell this form with the top face open",
+      "Turn this solid tower into a tube open at both ends\n\n# Example\n```ts\nconst brep = await snaptrude.core.geom.create.brepFromExtrusion(contour, { x: 0, y: 1, z: 0 }, 3)\nconst faces = await snaptrude.core.geom.query.brep.listFaces(brep)\nconst hollow = await snaptrude.core.geom.create.brepFromShell(brep, [faces[0]], 0.2)\n```"
+    ],
+    "argsType": "BrepHandle",
+    "resultType": "BrepHandle"
+  },
   {
     "path": "core.geom.create.brepFromSubtraction",
     "namespace": "core.geom.create",
@@ -787,6 +848,18 @@
     "argsType": "BrepHandle",
     "resultType": "BrepHandle"
   },
+  {
+    "path": "core.geom.create.brepFromSweep",
+    "namespace": "core.geom.create",
+    "summary": "Sweeps a planar profile along an open polyline path, with mitred corners at each bend. Host API call — returns a new {@linkcode BrepHandle}; the input contour is read-only. The profile must be hole-free and must not lie in a plane containing the first path segment's direction.",
+    "examplePrompts": [
+      "Sweep this profile along the corridor path",
+      "Extrude the railing section along this route",
+      "Run a duct profile through these points\n\n# Example\n```ts\nconst rect = await snaptrude.core.geom.create.profileRect(0.4, 0.4)\nconst profile = await snaptrude.core.geom.create.contourFromProfile(rect)\n// profileRect lies in the XZ plane, so the path must START out of that\n// plane (here: straight up), then it can run horizontally.\nconst duct = await snaptrude.core.geom.create.brepFromSweep(profile, [\n{ x: 0, y: 0, z: 0 },\n{ x: 0, y: 2.8, z: 0 },\n{ x: 10, y: 2.8, z: 0 },\n])\n```"
+    ],
+    "argsType": "ContourHandle",
+    "resultType": "BrepHandle"
+  },
   {
     "path": "core.geom.create.brepFromUnion",
     "namespace": "core.geom.create",
@@ -799,6 +872,18 @@
     "argsType": "BrepHandle",
     "resultType": "BrepHandle"
   },
+  {
+    "path": "core.geom.create.brepsFromSplit",
+    "namespace": "core.geom.create",
+    "summary": "Cuts a solid by an infinite plane and returns one brep per resulting piece — a single piece if the plane misses the solid. Host API call — returns new {@linkcode BrepHandle}s; the input brep is read-only. The plane is defined by a point on it and its normal direction.",
+    "examplePrompts": [
+      "Cut this building at 12m height",
+      "Split the tower from the podium with a horizontal plane",
+      "Slice this mass along a vertical plane\n\n# Example\n```ts\nconst pieces = await snaptrude.core.geom.create.brepsFromSplit(\ntowerBrep,\n{ x: 0, y: 12, z: 0 },\n{ x: 0, y: 1, z: 0 },\n)\nconsole.log(\"pieces:\", pieces.length)\n```"
+    ],
+    "argsType": "BrepHandle",
+    "resultType": "BrepHandle[]"
+  },
   {
     "path": "core.geom.create.circle",
     "namespace": "core.geom.create",
@@ -961,6 +1046,18 @@
     "argsType": "BrepHandle",
     "resultType": "Vec3Components"
   },
+  {
+    "path": "core.geom.query.brep.getDistance",
+    "namespace": "core.geom.query.brep",
+    "summary": "Measures the minimum distance between two solids, with the closest witness point on each. Touching or overlapping solids report a distance of 0 with contact points.",
+    "examplePrompts": [
+      "What is the clearance between these two masses?",
+      "How far apart are the tower and the neighbouring building?",
+      "Find the closest points between these two solids\n\n# Example\n```ts\nconst [a, b] = await snaptrude.design.query.listMasses()\nconst brepA = await snaptrude.design.query.geometry.getBrep(a)\nconst brepB = await snaptrude.design.query.geometry.getBrep(b)\nif (brepA && brepB) {\nconst { distance, pointA, pointB } = await snaptrude.core.geom.query.brep.getDistance(brepA, brepB)\nconsole.log(\"clearance:\", distance)\n}\n```"
+    ],
+    "argsType": "BrepHandle",
+    "resultType": "{ distance: number; pointA: Vec3Components; pointB: Vec3Components }"
+  },
   {
     "path": "core.geom.query.brep.getEdge",
     "namespace": "core.geom.query.brep",
@@ -2750,6 +2847,19 @@
     "argsType": null,
     "resultType": "boolean | null"
   },
+  {
+    "path": "core.io.terrain.replaceMesh",
+    "namespace": "core.io.terrain",
+    "summary": "Replace the terrain surface with a caller-supplied triangle mesh. Undoable (one step), and the replacement persists with the project. The returned promise resolves only after the surface is fully applied and recorded — it is safe to toggle terrain resolution or read the surface back the moment it resolves.",
+    "examplePrompts": [
+      "Replace the terrain with this surveyed mesh",
+      "Flatten a building pad into the site surface",
+      "Load a custom DEM surface onto the terrain",
+      "Regrade the terrain from these points\n\n# Example\n```ts\n// Projects with no terrain yet: import first, then replace.\nif (!(await snaptrude.core.io.terrain.exists())) {\nawait snaptrude.core.io.import.terrain(40.7128, -74.006, 300, 300)\n}\nconst result = await snaptrude.core.io.terrain.replaceMesh(\npositions, // [x0, y0, z0, x1, y1, z1, …] — world space\nindices,   // [a0, b0, c0, a1, b1, c1, …]\n\"meters\",\n{\ncoordinateSpace: \"world\",\nexpectedTerrain: await snaptrude.core.io.terrain.get(),\nbaseline: \"make-replacement-original\",\npreserve: { datum: true, geolocation: true, satellite: true, material: true },\nclientMutationId: \"survey-2026-08-05-r1\",\n},\n)\n// result.modelRevision — pass back as expectedModelRevision on the next call\n```"
+    ],
+    "argsType": "number[]",
+    "resultType": "PluginTerrainReplaceMeshResult"
+  },
   {
     "path": "core.io.terrain.setDatum",
     "namespace": "core.io.terrain",
@@ -6332,6 +6442,18 @@
     "argsType": null,
     "resultType": "PluginPresentationDiagramsGenerateResult"
   },
+  {
+    "path": "presentation.diagrams.generateSite",
+    "namespace": "presentation.diagrams",
+    "summary": "Generate the site diagrams (location, streetview, climate) for the current model, creating new layout sheets.",
+    "examplePrompts": [
+      "Generate the site diagrams for this project",
+      "Create the location, streetview and climate sheets",
+      "Add a climate diagram sheet to the presentation\n\n# Example\n```ts\nconst { sheetIds } = await snaptrude.presentation.diagrams.generateSite({\ntypes: [\"location\", \"climate\"],\n})\n```"
+    ],
+    "argsType": "{\n    types?: PluginPresentationSiteDiagramType[]\n  }",
+    "resultType": "PluginPresentationDiagramsGenerateResult"
+  },
   {
     "path": "presentation.diagrams.place",
     "namespace": "presentation.diagrams",
@@ -6397,6 +6519,18 @@
     "argsType": "{ url?: string; dataUrl?: string }",
     "resultType": "PluginPresentationImportResult"
   },
+  {
+    "path": "presentation.placedViews.deleteShapes",
+    "namespace": "presentation.placedViews",
+    "summary": "Delete Present-canvas shapes. One undoable step for the whole batch, and the batch is atomic — if any id is rejected, nothing is deleted.",
+    "examplePrompts": [
+      "Delete the old AI renders from the sheet",
+      "Remove that placed view",
+      "Clear the diagram images I placed\n\n# Example\n```ts\nconst { deleted } = await snaptrude.presentation.placedViews.deleteShapes([\nout1.shapeId,\nout2.shapeId,\n])\n```"
+    ],
+    "argsType": "string[]",
+    "resultType": "PluginCanvasShapesDeleteResult"
+  },
   {
     "path": "presentation.placedViews.get",
     "namespace": "presentation.placedViews",
@@ -6409,6 +6543,29 @@
     "argsType": "string",
     "resultType": "PluginPlacedView"
   },
+  {
+    "path": "presentation.placedViews.getShape",
+    "namespace": "presentation.placedViews",
+    "summary": "Get one Present-canvas shape by id — works for any top-level shape (placed view, AI output, diagram image, plugin shape, annotation), unlike `get` which requires a placed view. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Inspect the AI render I just generated",
+      "Get the bounds of that diagram image"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCanvasShape"
+  },
+  {
+    "path": "presentation.placedViews.getStyles",
+    "namespace": "presentation.placedViews",
+    "summary": "Read a placed view's (or sheet's) per-category presentation styles.",
+    "examplePrompts": [
+      "What line weights is this placed plan using?",
+      "Read the styling of the placed view",
+      "Which categories can I restyle on this sheet?\n\n# Example\n```ts\nconst styles = await snaptrude.presentation.placedViews.getStyles(shapeId)\nconst space = styles.categories.find((c) => c.category === \"Space\")\nconsole.log(space?.settings.cutWidth, space?.settings.lineStyle)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewStylesResult"
+  },
   {
     "path": "presentation.placedViews.list",
     "namespace": "presentation.placedViews",
@@ -6422,6 +6579,30 @@
     "argsType": "string",
     "resultType": "PluginPresentationPlacedViewsListResult"
   },
+  {
+    "path": "presentation.placedViews.listLabels",
+    "namespace": "presentation.placedViews",
+    "summary": "List a placed view's labels — the text children generated from the view's content (space names, departments, areas, dimension texts). Each label is individually addressable: it can be moved and hidden. Returns `[]` when the view has no labels. Requires Present mode to be open.",
+    "examplePrompts": [
+      "List the labels on this placed plan",
+      "Where are the space labels on this view?",
+      "Show every label with its position\n\n# Example\n```ts\nconst { labels } = await snaptrude.presentation.placedViews.listLabels(shapeId)\nfor (const l of labels) console.log(l.text, l.position, l.hidden)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewLabelsResult"
+  },
+  {
+    "path": "presentation.placedViews.listShapes",
+    "namespace": "presentation.placedViews",
+    "summary": "List the top-level shapes on the Present canvas — not just placed views: AI-generated outputs, placed diagram images, plugin-created shapes, and annotations, each with an `origin` classification. Sheets (frames) are not listed — use `sheets.list`. Pass `sheetId` to list only shapes on that sheet. Returns `[]` when Present mode is closed.",
+    "examplePrompts": [
+      "List everything on the Present canvas",
+      "What AI outputs are on this sheet?",
+      "Show all the shapes with their positions\n\n# Example\n```ts\nconst { shapes } = await snaptrude.presentation.placedViews.listShapes()\nconst aiOutputs = shapes.filter((s) => s.origin === \"aiOutput\")\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCanvasShapesListResult"
+  },
   {
     "path": "presentation.placedViews.move",
     "namespace": "presentation.placedViews",
@@ -6434,6 +6615,64 @@
     "argsType": "string",
     "resultType": "PluginPlacedView"
   },
+  {
+    "path": "presentation.placedViews.moveLabel",
+    "namespace": "presentation.placedViews",
+    "summary": "Move a label to a new position (coordinates relative to its placed view, the same space `listLabels` reports). The manual position survives style changes. Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Move the kitchen label out of the hatched area",
+      "Nudge this label 20 units right",
+      "Reposition the area text"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewLabel"
+  },
+  {
+    "path": "presentation.placedViews.moveShape",
+    "namespace": "presentation.placedViews",
+    "summary": "Move any Present-canvas shape (AI outputs, diagram images, plugin shapes, annotations — placed views too). Same coordinate semantics as `move`: sheet-local when on a sheet, page coordinates otherwise; pass `options.sheetId` to reparent onto a sheet. Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Move the AI render to the top of the sheet",
+      "Put the diagram image at 100, 200"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCanvasShape"
+  },
+  {
+    "path": "presentation.placedViews.resetStyles",
+    "namespace": "presentation.placedViews",
+    "summary": "Reset a placed view's styling to defaults — the sidebar's Reset button: clears every per-category override and view-style restyle, resets font styles, and un-hides labels hidden by styling. Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Reset this view's styling",
+      "Clear all the style overrides on the placed plan",
+      "Put the sheet styles back to default"
+    ],
+    "argsType": "string",
+    "resultType": "void"
+  },
+  {
+    "path": "presentation.placedViews.resizeShape",
+    "namespace": "presentation.placedViews",
+    "summary": "Resize any Present-canvas shape by a uniform factor about its top-left corner (aspect ratio held) — the generic counterpart of `scale`, which requires a placed view. Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Make the AI output half its size",
+      "Double the size of that image"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCanvasShape"
+  },
+  {
+    "path": "presentation.placedViews.rotateShape",
+    "namespace": "presentation.placedViews",
+    "summary": "Rotate any Present-canvas shape (AI outputs, diagram images, plugin shapes, annotations — placed views too) — the generic counterpart of `setRotation`, same target rules as `moveShape`. Same semantics: **absolute** angle in radians (tldraw convention) about the shape's bounds center, canonicalized into `[0, 2π)` (pass values in that range for an exact round-trip via `getShape`), one undo step. A placed view passed here falls under the same 3D-only rule as `setRotation`: 2D and site-plan views cannot rotate and are refused with a typed `PRECONDITION_FAILED`. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Rotate the AI render 15 degrees",
+      "Turn that image sideways",
+      "Reset the diagram image's rotation"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCanvasShape"
+  },
   {
     "path": "presentation.placedViews.scale",
     "namespace": "presentation.placedViews",
@@ -6458,6 +6697,51 @@
     "argsType": "string",
     "resultType": "PluginPlacedView"
   },
+  {
+    "path": "presentation.placedViews.setLabelHidden",
+    "namespace": "presentation.placedViews",
+    "summary": "Hide or show a single label (independent of the category-level label visibility). Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Hide the corridor label",
+      "Show that label again"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewLabel"
+  },
+  {
+    "path": "presentation.placedViews.setMask",
+    "namespace": "presentation.placedViews",
+    "summary": "Toggle \"mask context buildings\" on a placed view — mutes the inactive proposal buildings in the view (the sidebar checkbox). Views only. Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Mask the context buildings in this view",
+      "Show the neighboring proposals again in the placed view"
+    ],
+    "argsType": "string",
+    "resultType": "void"
+  },
+  {
+    "path": "presentation.placedViews.setOpacity",
+    "namespace": "presentation.placedViews",
+    "summary": "Set a Present-canvas shape's opacity (`0` transparent .. `1` opaque) — the sidebar's whole-shape opacity slider (distinct from the per-category fill opacity in `updateStyles`). Works for any top-level shape. Undoable. Requires Present mode to be open.",
+    "examplePrompts": [
+      "Fade the placed view to 50%",
+      "Make the AI render semi-transparent"
+    ],
+    "argsType": "string",
+    "resultType": "void"
+  },
+  {
+    "path": "presentation.placedViews.setRotation",
+    "namespace": "presentation.placedViews",
+    "summary": "Set a placed view's rotation.",
+    "examplePrompts": [
+      "Rotate the placed plan 90 degrees",
+      "Set this view's rotation to 45 degrees",
+      "Straighten the placed view back to zero rotation\n\n# Example\n```ts\nawait snaptrude.presentation.placedViews.setRotation(shapeId, Math.PI / 2)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedView"
+  },
   {
     "path": "presentation.placedViews.setScale",
     "namespace": "presentation.placedViews",
@@ -6470,6 +6754,32 @@
     "argsType": "string",
     "resultType": "PluginPlacedView"
   },
+  {
+    "path": "presentation.placedViews.updateFontStyles",
+    "namespace": "presentation.placedViews",
+    "summary": "Update a category's label typography on a placed view (or sheet) — the configure panel's Text tab.",
+    "examplePrompts": [
+      "Set the space labels to Roboto 24px bold",
+      "Hide the area values on this plan",
+      "Make the department labels italic\n\n# Example\n```ts\nawait snaptrude.presentation.placedViews.updateFontStyles(shapeId, \"Space\", {\nobjectLabels: { fontFamily: \"Roboto\", fontWeight: \"700\", fontSize: 24 },\nvisibleTypes: [\"objectLabels\", \"areas\"],\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "void"
+  },
+  {
+    "path": "presentation.placedViews.updateStyles",
+    "namespace": "presentation.placedViews",
+    "summary": "Update one style category on a placed view (or sheet) — the same writes the Present sidebar's per-category configure panel performs.",
+    "examplePrompts": [
+      "Set the Space cut line weight to 0.5 mm",
+      "Make the Department lines dashed",
+      "Color the plan by department",
+      "Hide the dimension lines on this view",
+      "Round the space corners with a 2 ft radius\n\n# Example\n```ts\nawait snaptrude.presentation.placedViews.updateStyles(shapeId, \"Space\", {\ncutWidth: 0.5,\nprojectionWidth: 0.18,\nlineStyle: \"dashed\",\ncolorMode: \"department\",\n})\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPlacedViewCategoryStyles"
+  },
   {
     "path": "presentation.shapes.list",
     "namespace": "presentation.shapes",
@@ -6619,6 +6929,18 @@
     "argsType": "string",
     "resultType": "PluginPresentationSheet"
   },
+  {
+    "path": "presentation.sheets.setMargin",
+    "namespace": "presentation.sheets",
+    "summary": "Set a sheet's print margin.",
+    "examplePrompts": [
+      "Set the sheet margin to half an inch",
+      "Remove the margins on sheet_1",
+      "Give the cover sheet a 10mm margin\n\n# Example\n```ts\nconst sheet = await snaptrude.presentation.sheets.setMargin(\"sheet_1\", 0.5)\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginPresentationSheet"
+  },
   {
     "path": "presentation.sheets.setSize",
     "namespace": "presentation.sheets",
@@ -6644,6 +6966,56 @@
     "argsType": "{\n    sheetId?: string\n  }",
     "resultType": "PluginPresentationSheetsUpdatePlacedViewResult"
   },
+  {
+    "path": "presentation.slideshow.getState",
+    "namespace": "presentation.slideshow",
+    "summary": "Read the slideshow state.",
+    "examplePrompts": [
+      "Is the slideshow running?",
+      "Which slide is the presentation on?",
+      "Check the slideshow state\n\n# Example\n```ts\nconst { running, index } = await snaptrude.presentation.slideshow.getState()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationSlideshowState"
+  },
+  {
+    "path": "presentation.slideshow.start",
+    "namespace": "presentation.slideshow",
+    "summary": "Start the slideshow.",
+    "examplePrompts": [
+      "Start the slideshow",
+      "Present the sheets from the beginning",
+      "Start the slideshow on sheet 3",
+      "Play the presentation starting at the cover sheet\n\n# Example\n```ts\nconst state = await snaptrude.presentation.slideshow.start({ startIndex: 2 })\nconsole.log(state.running, state.index) // true, 2\n```"
+    ],
+    "argsType": "{\n    sheetIds?: string[]\n    startIndex?: number\n  }",
+    "resultType": "PluginPresentationSlideshowState"
+  },
+  {
+    "path": "presentation.slideshow.stop",
+    "namespace": "presentation.slideshow",
+    "summary": "Stop the slideshow.",
+    "examplePrompts": [
+      "Stop the slideshow",
+      "Exit the presentation",
+      "Close the slideshow and go back to the sheets\n\n# Example\n```ts\nawait snaptrude.presentation.slideshow.stop()\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginPresentationSlideshowState"
+  },
+  {
+    "path": "presentation.tables.place",
+    "namespace": "presentation.tables",
+    "summary": "Place a table on a sheet.",
+    "examplePrompts": [
+      "Put the area schedule as a table on Sheet 1",
+      "Add a table of the room programs to the cover sheet",
+      "Paste this data as a table on the sheet",
+      "Place a two-column table of space names and areas\n\n# Example\n```ts\nconst shape = await snaptrude.presentation.tables.place(\"sheet_1\", {\nrows: [\n[\"Room\", \"Area\"],\n[\"Kitchen\", \"12.4 m²\"],\n[\"Living\", \"28.0 m²\"],\n],\n}, { position: { x: 40, y: 40 } })\n```"
+    ],
+    "argsType": "string",
+    "resultType": "PluginCanvasShape"
+  },
   {
     "path": "presentation.views.capture",
     "namespace": "presentation.views",
@@ -7195,6 +7567,19 @@
     "argsType": null,
     "resultType": "PluginProgramSiteWeatherResult"
   },
+  {
+    "path": "program.site.listEdges",
+    "namespace": "program.site",
+    "summary": "List each site parcel's boundary edges with their front / side / rear classification — the same per-edge roles the buildable-envelope setback pills show on canvas, so a plugin can pick up the user's edge tagging without asking them to set it up again.",
+    "examplePrompts": [
+      "Which edge of my site is the front?",
+      "Read the front / side / rear edges of the plot",
+      "What setback applies to each site edge?",
+      "Get the site edges the way the setback pills show them\n\n# Example\n```ts\nconst { sites } = await snaptrude.program.site.listEdges()\nfor (const site of sites)\nfor (const e of site.edges)\nconsole.log(e.edgeIndex, e.role, e.roleSource, e.setbackMeters)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteListEdgesResult"
+  },
   {
     "path": "program.site.listGeoPolygons",
     "namespace": "program.site",
@@ -7602,6 +7987,30 @@
     "argsType": "PluginSpreadsheetTransactionOp[]",
     "resultType": "PluginProgramSpreadsheetTransactionResult"
   },
+  {
+    "path": "workspace.closePresentMode",
+    "namespace": "workspace",
+    "summary": "Close Present mode and return to the modeling canvas.",
+    "examplePrompts": [
+      "Close present mode",
+      "Exit the presentation editor",
+      "Go back to the modeling canvas\n\n# Example\n```ts\nawait snaptrude.workspace.closePresentMode()\n```"
+    ],
+    "argsType": null,
+    "resultType": "void"
+  },
+  {
+    "path": "workspace.openPresentMode",
+    "namespace": "workspace",
+    "summary": "Open Present mode — the documentation editor the `presentation.*` namespaces operate on.",
+    "examplePrompts": [
+      "Open present mode",
+      "Switch to the presentation editor",
+      "Open the sheets so I can lay out views\n\n# Example\n```ts\nawait snaptrude.workspace.openPresentMode()\nconst { sheets } = await snaptrude.presentation.sheets.list()\n```"
+    ],
+    "argsType": null,
+    "resultType": "void"
+  },
   {
     "path": "workspace.projects.copy",
     "namespace": "workspace.projects",