@snaptrude/plugin-core 0.9.4 → 0.10.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @snaptrude/plugin-core
 
+## 0.10.0
+
+### Minor Changes
+
+- 432ada9: Expose retained AutoCAD layer names and their paginated world-space geometry through the underlay API.
+
 ## 0.9.4
 
 ### Patch Changes

package/api-manifest.json

@@ -2907,6 +2907,19 @@
     "argsType": "number",
     "resultType": "void"
   },
+  {
+    "path": "core.io.underlay.classifyArcs",
+    "namespace": "core.io.underlay",
+    "summary": "Classify one retained AutoCAD layer's **arcs as door swings** — the deterministic tracing primitive behind CAD-to-BIM door placement. A door swing is drawn as a ~90° arc whose radius IS the leaf width and whose centre IS the hinge point. This filters the layer's arcs by plausible radius and sweep (rejecting inch-scale fillets, full-circle symbols and long shallow curves), reads each survivor as a door candidate (hinge, leaf width, swing direction, hosting wall direction), merges mirrored pairs sharing a chord line into double doors, and returns a radius histogram — real drawings use a handful of standard door sizes, so the histogram's clusters are the drawing's door widths (sanity-check them against the catalog; distrust arcs in no cluster).",
+    "examplePrompts": [
+      "Find the doors on the a-door CAD layer",
+      "Classify the door swing arcs in the imported drawing",
+      "What door sizes does this DWG use?",
+      "Read hinge points and leaf widths from the CAD door layer\n\n# Example\n```ts\nconst [cad] = await snaptrude.core.io.underlay.list()\nconst r = await snaptrude.core.io.underlay.classifyArcs(cad, \"a-door\")\nif (r) {\nconsole.log(`${r.doors.length} doors; sizes:`,\nr.radiusHistogram.filter((b) => b.count > 1))\n}\n```"
+    ],
+    "argsType": "UnderlayHandle",
+    "resultType": "PluginCadArcClassifyResult | null"
+  },
   {
     "path": "core.io.underlay.delete",
     "namespace": "core.io.underlay",
@@ -2920,6 +2933,19 @@
     "argsType": "UnderlayHandle",
     "resultType": "void"
   },
+  {
+    "path": "core.io.underlay.extractCenterlines",
+    "namespace": "core.io.underlay",
+    "summary": "Extract **continuous wall centrelines** from one retained AutoCAD layer's double-line wall faces — the deterministic tracing primitive behind CAD-to-BIM wall conversion. Instead of paging raw curves and re-deriving the geometry in worker code, this reads the whole layer and runs the vetted pipeline: cull fragments, dedupe, merge collinear runs into *faces*, pair parallel faces a wall-thickness apart into centrelines (midline = axis, separation = thickness), bridge collinear gaps up to `bridgeOpenings.maxWidth` into ONE continuous centreline while recording each bridged span as an opening, then snap near-touching endpoints at junctions.",
+    "examplePrompts": [
+      "Trace the walls from the a-wall CAD layer",
+      "Convert the AutoCAD wall linework into Snaptrude walls",
+      "Extract wall centrelines with thickness from the imported DWG",
+      "Find the glazing runs on the a-glazing layer\n\n# Example\n```ts\nconst [cad] = await snaptrude.core.io.underlay.list()\nconst r = await snaptrude.core.io.underlay.extractCenterlines(cad, \"a-wall\")\nif (r) {\nconst items = r.centerlines.map((c) => ({\nprofile: [c.start, c.end],\nthickness: c.thickness,\n}))\nconsole.log(`${items.length} walls, ${r.unpaired.length} unpaired faces`)\n}\n```"
+    ],
+    "argsType": "UnderlayHandle",
+    "resultType": "PluginCadCenterlinesResult | null"
+  },
   {
     "path": "core.io.underlay.getBounds",
     "namespace": "core.io.underlay",
@@ -2933,6 +2959,17 @@
     "argsType": "UnderlayHandle",
     "resultType": "BBoxComponents | null"
   },
+  {
+    "path": "core.io.underlay.getCadLayerGeometry",
+    "namespace": "core.io.underlay",
+    "summary": "Read one original AutoCAD layer's retained line and arc geometry in **Snaptrude world space** and Snaptrude internal units. Results are paged so large drawings can be inspected without returning the whole DWG at once.",
+    "examplePrompts": [
+      "Read the wall geometry from the A-WALL layer in this CAD underlay",
+      "Get the next 500 curves from the structural CAD layer\n\n# Example\n```ts\nconst page = await snaptrude.core.io.underlay.getCadLayerGeometry(\ncad,\n\"A-WALL\",\n{ offset: 0, limit: 500 },\n)\nif (page) console.log(`${page.curves.length} of ${page.total} curves`)\n```"
+    ],
+    "argsType": "UnderlayHandle",
+    "resultType": "PluginCadLayerGeometryPage | null"
+  },
   {
     "path": "core.io.underlay.getOpacity",
     "namespace": "core.io.underlay",
@@ -2972,6 +3009,17 @@
     "argsType": "number",
     "resultType": "UnderlayHandle[]"
   },
+  {
+    "path": "core.io.underlay.listCadLayers",
+    "namespace": "core.io.underlay",
+    "summary": "List the distinct original AutoCAD layer names retained by a placed CAD underlay. Returns `[]` for non-CAD underlays, legacy imports created before source-layer retention, missing underlays, or CAD drawings without layer tags.",
+    "examplePrompts": [
+      "List the original AutoCAD layers in this imported drawing",
+      "Which CAD layers are available in this underlay?\n\n# Example\n```ts\nconst layers = await snaptrude.core.io.underlay.listCadLayers(cad)\nconsole.log(layers)\n```"
+    ],
+    "argsType": "UnderlayHandle",
+    "resultType": "string[]"
+  },
   {
     "path": "core.io.underlay.resetScale",
     "namespace": "core.io.underlay",
@@ -4274,6 +4322,18 @@
     "argsType": "BrepHandle",
     "resultType": "ComponentHandle"
   },
+  {
+    "path": "design.create.opening",
+    "namespace": "design.create",
+    "summary": "Place a catalog **door or window** into a host wall with optional size overrides.",
+    "examplePrompts": [
+      "Add a 1m wide door to this wall here",
+      "Place a window with a 0.9m sill height on the selected wall"
+    ],
+    "argsType": "PluginDesignCreateOpeningOptions",
+    "resultType": "ComponentHandle",
+    "performance": "Single-opening creator — use it for one hosted opening. A plural API is intentionally unavailable until host placement can be atomic. # Example ```ts const opening = await snaptrude.design.create.opening({ kind: \"window\", catalogId: windowType.id, hostWall: wall, position: await snaptrude.core.math.vec3.new(3, 0, 5), width: 1.2, height: 1.5, sillHeight: 0.9, }) ```"
+  },
   {
     "path": "design.create.referenceLines",
     "namespace": "design.create",
@@ -5471,6 +5531,19 @@
     "argsType": "ComponentHandle",
     "resultType": "ContourHandle | null"
   },
+  {
+    "path": "design.query.storeyOutline",
+    "namespace": "design.query",
+    "summary": "Compute the plan **outline of what is built on a storey** — the union of the storey's wall (by default) footprints as polygons-with-holes. This is the footprint-from-the-built-model query: by the time slabs are needed the walls exist, and the engine's own solids (snapped, joined and mitred at creation) are the cleanest wall network available — no CAD re-tracing.",
+    "examplePrompts": [
+      "What is the building footprint on the ground floor?",
+      "Create a floor slab covering the whole storey",
+      "Get the outline of the walls on storey 1",
+      "How much area do the ground-floor walls enclose?\n\n# Example\n```ts\nconst r = await snaptrude.design.query.storeyOutline({ storey: 1 })\nconst main = r.footprints.find((f) => f.enclosed)\nif (main) {\nconst profile = await snaptrude.core.geom.create.profileFromLinePoints(\nmain.outline.map((p) => ({ x: p.x, y: 0, z: p.z })),\n)\n// → design.create.slab with the profile's contour\n}\n```"
+    ],
+    "argsType": "PluginStoreyOutlineOptions",
+    "resultType": "PluginStoreyOutlineResult"
+  },
   {
     "path": "design.selection.add",
     "namespace": "design.selection",
@@ -7551,6 +7624,17 @@
     "argsType": null,
     "resultType": "PluginProgramSiteNorthAngleResult"
   },
+  {
+    "path": "program.site.getSiteAnalysis",
+    "namespace": "program.site",
+    "summary": "Read the persisted Site Analysis sheet for the active proposal.",
+    "examplePrompts": [
+      "Read the current Site Analysis sheet",
+      "What zoning constraints are recorded for this proposal?\n\n# Example\n```ts\nconst analysis = await snaptrude.program.site.getSiteAnalysis()\nif (analysis) console.log(analysis.sheetName, analysis.rows)\n```"
+    ],
+    "argsType": null,
+    "resultType": "PluginProgramSiteAnalysisResult"
+  },
   {
     "path": "program.site.getTimezone",
     "namespace": "program.site",
@@ -7615,6 +7699,17 @@
     "argsType": null,
     "resultType": "PluginProgramSiteListPolygonsResult"
   },
+  {
+    "path": "program.site.updateSiteAnalysis",
+    "namespace": "program.site",
+    "summary": "Merge sourced site/zoning constraints into the active proposal's persisted Site Analysis sheet.",
+    "examplePrompts": [
+      "Save these zoning constraints to Site Analysis",
+      "Update the FAR and setbacks in the Site Analysis sheet\n\n# Example\n```ts\nconst result = await snaptrude.program.site.updateSiteAnalysis([\n{ category: \"FAR\", description: \"Floor Area Ratio\", quantity: 3.5, unit: \"ratio\" },\n{ category: \"Set backs\", description: \"Front setbacks\", quantity: 6, unit: \"m\" },\n])\nconsole.log(result.sheetName, result.updatedRows, result.appendedRows)\n```"
+    ],
+    "argsType": "PluginSiteAnalysisRow[]",
+    "resultType": "PluginProgramSiteAnalysisUpdateResult"
+  },
   {
     "path": "program.spreadsheet.addChart",
     "namespace": "program.spreadsheet",