@snaptrude/plugin-core 0.3.0 → 0.5.0

package/src/api/core/geom/query/edge.ts

@@ -0,0 +1,130 @@
+import * as z from "zod"
+import { PluginApiReturn } from "../../../../types"
+import { EdgeHandle, VertexHandle, HalfEdgeHandle, FaceHandle, CurveHandle } from "../../../../handles"
+
+/**
+ * Edge queries — read a single BREP edge's topology and geometry (all-handle model,
+ * §11). An {@linkcode EdgeHandle} is minted by walking from a brep/face/vertex handle;
+ * it is session-ephemeral and goes stale on undo/redo/re-topologize.
+ *
+ * Accessed via `snaptrude.core.geom.query.edge`.
+ */
+export abstract class PluginGeomQueryEdgeApi {
+  constructor() {}
+
+  /**
+   * Get the index of an edge within its brep.
+   * @param edge The edge to query
+   * @returns The index as a `number` (`-1` if unindexed)
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [edge] = await snaptrude.core.geom.query.brep.listEdges(brep)
+   *   const index = await snaptrude.core.geom.query.edge.getIndex(edge)
+   * }
+   * ```
+   */
+  public abstract getIndex(edge: EdgeHandle): PluginApiReturn<number>
+
+  /**
+   * Get the primary half-edge of an edge.
+   * @param edge The edge to query
+   * @returns The half-edge as a {@linkcode HalfEdgeHandle}, or `null` if uninitialized
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [edge] = await snaptrude.core.geom.query.brep.listEdges(brep)
+   *   const halfEdge = await snaptrude.core.geom.query.edge.getHalfEdge(edge)
+   *   if (halfEdge) {
+   *     const face = await snaptrude.core.geom.query.halfedge.getFace(halfEdge)
+   *   }
+   * }
+   * ```
+   */
+  public abstract getHalfEdge(edge: EdgeHandle): PluginApiReturn<HalfEdgeHandle | null>
+
+  /**
+   * List the two endpoint vertices of an edge.
+   * @param edge The edge to query
+   * @returns The endpoints as {@linkcode VertexHandle}`[]`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [edge] = await snaptrude.core.geom.query.brep.listEdges(brep)
+   *   const [a, b] = await snaptrude.core.geom.query.edge.listVertices(edge)
+   *   const start = await snaptrude.core.geom.query.vertex.getPosition(brep, a)
+   *   const end = await snaptrude.core.geom.query.vertex.getPosition(brep, b)
+   * }
+   * ```
+   */
+  public abstract listVertices(edge: EdgeHandle): PluginApiReturn<VertexHandle[]>
+
+  /**
+   * Get the underlying curve geometry of an edge (a line or arc).
+   * @param edge The edge to query
+   * @returns The curve as a {@linkcode CurveHandle}, or `null` if it is a circle or unset
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [edge] = await snaptrude.core.geom.query.brep.listEdges(brep)
+   *   const curve = await snaptrude.core.geom.query.edge.getCurve(edge)
+   *   if (curve) {
+   *     const length = await snaptrude.core.geom.query.curve.getLength(curve)
+   *   }
+   * }
+   * ```
+   */
+  public abstract getCurve(edge: EdgeHandle): PluginApiReturn<CurveHandle | null>
+
+  /**
+   * List the faces bordering an edge (one or two).
+   * @param edge The edge to query
+   * @returns The bordering faces as {@linkcode FaceHandle}`[]`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [edge] = await snaptrude.core.geom.query.brep.listEdges(brep)
+   *   const faces = await snaptrude.core.geom.query.edge.listFaces(edge)
+   *   console.log(faces.length === 1 ? "boundary edge" : "interior edge")
+   * }
+   * ```
+   */
+  public abstract listFaces(edge: EdgeHandle): PluginApiReturn<FaceHandle[]>
+}
+
+const edgeArg = z.object({ edge: EdgeHandle })
+
+/** Arguments for {@linkcode PluginGeomQueryEdgeApi.getIndex}. `{ edge: EdgeHandle }` */
+export const PluginGeomQueryEdgeGetIndexArgs = edgeArg
+export type PluginGeomQueryEdgeGetIndexArgs = z.infer<typeof PluginGeomQueryEdgeGetIndexArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryEdgeApi.getHalfEdge}. `{ edge: EdgeHandle }` */
+export const PluginGeomQueryEdgeGetHalfEdgeArgs = edgeArg
+export type PluginGeomQueryEdgeGetHalfEdgeArgs = z.infer<typeof PluginGeomQueryEdgeGetHalfEdgeArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryEdgeApi.listVertices}. `{ edge: EdgeHandle }` */
+export const PluginGeomQueryEdgeListVerticesArgs = edgeArg
+export type PluginGeomQueryEdgeListVerticesArgs = z.infer<typeof PluginGeomQueryEdgeListVerticesArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryEdgeApi.getCurve}. `{ edge: EdgeHandle }` */
+export const PluginGeomQueryEdgeGetCurveArgs = edgeArg
+export type PluginGeomQueryEdgeGetCurveArgs = z.infer<typeof PluginGeomQueryEdgeGetCurveArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryEdgeApi.listFaces}. `{ edge: EdgeHandle }` */
+export const PluginGeomQueryEdgeListFacesArgs = edgeArg
+export type PluginGeomQueryEdgeListFacesArgs = z.infer<typeof PluginGeomQueryEdgeListFacesArgs>

package/src/api/core/geom/query/face.ts

@@ -0,0 +1,403 @@
+import * as z from "zod"
+import { PluginApiReturn } from "../../../../types"
+import {
+  BrepHandle,
+  FaceHandle,
+  EdgeHandle,
+  VertexHandle,
+  HalfEdgeHandle,
+  Vec3Components,
+} from "../../../../handles"
+
+/**
+ * Face queries — read the topology and boundary geometry of a single BREP face
+ * (all-handle model, §11). A {@linkcode FaceHandle} is minted by walking from a
+ * {@linkcode BrepHandle}; it is session-ephemeral and goes stale on
+ * undo/redo/re-topologize.
+ *
+ * Traversals mint fresh child topology handles; position reads return
+ * {@linkcode Vec3Components}. Holes are modelled per-loop: {@linkcode PluginGeomQueryFaceApi.listHoles}
+ * returns one seed half-edge per hole, and {@linkcode PluginGeomQueryFaceApi.listHoleHalfEdges}
+ * returns the full (flat) half-edge loop of one hole by index. No query mutates its inputs.
+ *
+ * Accessed via `snaptrude.core.geom.query.face`.
+ */
+export abstract class PluginGeomQueryFaceApi {
+  constructor() {}
+
+  /**
+   * Get the index of a face within its brep.
+   * @param face The face to query
+   * @returns The index as a `number` (`-1` if unindexed)
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const index = await snaptrude.core.geom.query.face.getIndex(face)
+   * }
+   * ```
+   */
+  public abstract getIndex(face: FaceHandle): PluginApiReturn<number>
+
+  /**
+   * Get the raw (unmapped) material index of a face.
+   * @param face The face to query
+   * @returns The material index as a `number`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const materialIndex = await snaptrude.core.geom.query.face.getMaterialIndex(face)
+   * }
+   * ```
+   */
+  public abstract getMaterialIndex(face: FaceHandle): PluginApiReturn<number>
+
+  /**
+   * Get a seed half-edge of a face's outer loop.
+   * @param face The face to query
+   * @returns The half-edge as a {@linkcode HalfEdgeHandle}, or `null` for a degenerate face
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const seed = await snaptrude.core.geom.query.face.getHalfEdge(face)
+   *   if (seed) {
+   *     const next = await snaptrude.core.geom.query.halfedge.getNext(seed)
+   *   }
+   * }
+   * ```
+   */
+  public abstract getHalfEdge(face: FaceHandle): PluginApiReturn<HalfEdgeHandle | null>
+
+  /**
+   * List the edges of a face's outer loop.
+   * @param face The face to query
+   * @returns The edges as {@linkcode EdgeHandle}`[]`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const edges = await snaptrude.core.geom.query.face.listEdges(face)
+   * }
+   * ```
+   */
+  public abstract listEdges(face: FaceHandle): PluginApiReturn<EdgeHandle[]>
+
+  /**
+   * List the half-edges of a face's outer loop.
+   * @param face The face to query
+   * @returns The half-edges as {@linkcode HalfEdgeHandle}`[]`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const halfEdges = await snaptrude.core.geom.query.face.listHalfEdges(face)
+   * }
+   * ```
+   */
+  public abstract listHalfEdges(face: FaceHandle): PluginApiReturn<HalfEdgeHandle[]>
+
+  /**
+   * List the vertices of a face's outer loop.
+   * @param face The face to query
+   * @returns The vertices as {@linkcode VertexHandle}`[]`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const vertices = await snaptrude.core.geom.query.face.listVertices(face)
+   * }
+   * ```
+   */
+  public abstract listVertices(face: FaceHandle): PluginApiReturn<VertexHandle[]>
+
+  /**
+   * List a face's holes as one seed half-edge per hole loop.
+   * @param face The face to query
+   * @returns The hole seeds as {@linkcode HalfEdgeHandle}`[]`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const holeSeeds = await snaptrude.core.geom.query.face.listHoles(face)
+   *   console.log("holes in this face:", holeSeeds.length)
+   * }
+   * ```
+   */
+  public abstract listHoles(face: FaceHandle): PluginApiReturn<HalfEdgeHandle[]>
+
+  /**
+   * Get the number of holes in a face.
+   * @param face The face to query
+   * @returns The hole count as a `number`
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const holeCount = await snaptrude.core.geom.query.face.getHoleCount(face)
+   * }
+   * ```
+   */
+  public abstract getHoleCount(face: FaceHandle): PluginApiReturn<number>
+
+  /**
+   * List the half-edge loop of one hole of a face (by hole index).
+   * @param face The face to query
+   * @param holeIndex Index of the hole (`0..getHoleCount-1`)
+   * @returns The hole's half-edges as {@linkcode HalfEdgeHandle}`[]` (`[]` if the index is out of range)
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const holeCount = await snaptrude.core.geom.query.face.getHoleCount(face)
+   *   if (holeCount > 0) {
+   *     const loop = await snaptrude.core.geom.query.face.listHoleHalfEdges(face, 0)
+   *   }
+   * }
+   * ```
+   */
+  public abstract listHoleHalfEdges(
+    face: FaceHandle,
+    holeIndex: number,
+  ): PluginApiReturn<HalfEdgeHandle[]>
+
+  /**
+   * Test whether a face has any holes.
+   * @param face The face to query
+   * @returns `true` if the face has at least one hole, otherwise `false`
+   *
+   * @examplePrompt Does this face have any holes cut into it?
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const pierced = await snaptrude.core.geom.query.face.hasHoles(face)
+   * }
+   * ```
+   */
+  public abstract hasHoles(face: FaceHandle): PluginApiReturn<boolean>
+
+  /**
+   * Get the seed half-edge of the hole loop containing a given half-edge.
+   * @param face The face to query
+   * @param halfEdge The half-edge to locate
+   * @returns The hole seed as a {@linkcode HalfEdgeHandle}, or `null` if not in any hole
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const [he] = await snaptrude.core.geom.query.face.listHoleHalfEdges(face, 0)
+   *   if (he) {
+   *     const seed = await snaptrude.core.geom.query.face.getHoleContainingHalfEdge(face, he)
+   *   }
+   * }
+   * ```
+   */
+  public abstract getHoleContainingHalfEdge(
+    face: FaceHandle,
+    halfEdge: HalfEdgeHandle,
+  ): PluginApiReturn<HalfEdgeHandle | null>
+
+  /**
+   * List the positions of a face's outer-loop vertices (needs the parent brep for coordinates).
+   * @param face The face to query
+   * @param brep The parent brep (source of vertex coordinates)
+   * @returns The positions as {@linkcode Vec3Components}`[]`
+   *
+   * @examplePrompt What are the corner coordinates of this face?
+   * @examplePrompt Get the boundary points of the selected face
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const corners = await snaptrude.core.geom.query.face.listVertexPositions(face, brep)
+   *   for (const p of corners) console.log(p.x, p.y, p.z)
+   * }
+   * ```
+   */
+  public abstract listVertexPositions(
+    face: FaceHandle,
+    brep: BrepHandle,
+  ): PluginApiReturn<Vec3Components[]>
+
+  /**
+   * List the tessellated boundary points of a face's outer loop (arcs sampled,
+   * sense-corrected). Not cardinality-equal to {@linkcode PluginGeomQueryFaceApi.listVertexPositions}.
+   * @param face The face to query
+   * @returns The boundary points as {@linkcode Vec3Components}`[]`
+   *
+   * @examplePrompt Trace the outline of this face including its curved edges
+   *
+   * # Example
+   * ```ts
+   * const [wall] = await snaptrude.design.query.listWalls()
+   * const brep = await snaptrude.design.query.geometry.getBrep(wall)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const outline = await snaptrude.core.geom.query.face.listVertexPositionsWithCurves(face)
+   * }
+   * ```
+   */
+  public abstract listVertexPositionsWithCurves(
+    face: FaceHandle,
+  ): PluginApiReturn<Vec3Components[]>
+
+  /**
+   * List the faces adjacent to a face (sharing an edge). Boundary edges are skipped.
+   * @param face The face to query
+   * @returns The adjacent faces as {@linkcode FaceHandle}`[]`
+   *
+   * @examplePrompt Which faces are next to this one?
+   * @examplePrompt Find the faces that share an edge with the selected face
+   *
+   * # Example
+   * ```ts
+   * const [mass] = await snaptrude.design.query.listMasses()
+   * const brep = await snaptrude.design.query.geometry.getBrep(mass)
+   * if (brep) {
+   *   const [face] = await snaptrude.core.geom.query.brep.listFaces(brep)
+   *   const neighbours = await snaptrude.core.geom.query.face.listAdjacentFaces(face)
+   * }
+   * ```
+   */
+  public abstract listAdjacentFaces(face: FaceHandle): PluginApiReturn<FaceHandle[]>
+}
+
+const faceArg = z.object({ face: FaceHandle })
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.getIndex}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceGetIndexArgs = faceArg
+export type PluginGeomQueryFaceGetIndexArgs = z.infer<typeof PluginGeomQueryFaceGetIndexArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.getMaterialIndex}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceGetMaterialIndexArgs = faceArg
+export type PluginGeomQueryFaceGetMaterialIndexArgs = z.infer<
+  typeof PluginGeomQueryFaceGetMaterialIndexArgs
+>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.getHalfEdge}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceGetHalfEdgeArgs = faceArg
+export type PluginGeomQueryFaceGetHalfEdgeArgs = z.infer<typeof PluginGeomQueryFaceGetHalfEdgeArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.listEdges}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceListEdgesArgs = faceArg
+export type PluginGeomQueryFaceListEdgesArgs = z.infer<typeof PluginGeomQueryFaceListEdgesArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.listHalfEdges}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceListHalfEdgesArgs = faceArg
+export type PluginGeomQueryFaceListHalfEdgesArgs = z.infer<
+  typeof PluginGeomQueryFaceListHalfEdgesArgs
+>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.listVertices}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceListVerticesArgs = faceArg
+export type PluginGeomQueryFaceListVerticesArgs = z.infer<typeof PluginGeomQueryFaceListVerticesArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.listHoles}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceListHolesArgs = faceArg
+export type PluginGeomQueryFaceListHolesArgs = z.infer<typeof PluginGeomQueryFaceListHolesArgs>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.getHoleCount}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceGetHoleCountArgs = faceArg
+export type PluginGeomQueryFaceGetHoleCountArgs = z.infer<typeof PluginGeomQueryFaceGetHoleCountArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomQueryFaceApi.listHoleHalfEdges}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `face` | {@linkcode FaceHandle} | The face to query |
+ * | `holeIndex` | `number` | Index of the hole (`0..getHoleCount-1`) |
+ */
+export const PluginGeomQueryFaceListHoleHalfEdgesArgs = z.object({
+  face: FaceHandle,
+  holeIndex: z.number(),
+})
+export type PluginGeomQueryFaceListHoleHalfEdgesArgs = z.infer<
+  typeof PluginGeomQueryFaceListHoleHalfEdgesArgs
+>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.hasHoles}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceHasHolesArgs = faceArg
+export type PluginGeomQueryFaceHasHolesArgs = z.infer<typeof PluginGeomQueryFaceHasHolesArgs>
+
+/**
+ * Arguments for {@linkcode PluginGeomQueryFaceApi.getHoleContainingHalfEdge}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `face` | {@linkcode FaceHandle} | The face to query |
+ * | `halfEdge` | {@linkcode HalfEdgeHandle} | The half-edge to locate |
+ */
+export const PluginGeomQueryFaceGetHoleContainingHalfEdgeArgs = z.object({
+  face: FaceHandle,
+  halfEdge: HalfEdgeHandle,
+})
+export type PluginGeomQueryFaceGetHoleContainingHalfEdgeArgs = z.infer<
+  typeof PluginGeomQueryFaceGetHoleContainingHalfEdgeArgs
+>
+
+/**
+ * Arguments for {@linkcode PluginGeomQueryFaceApi.listVertexPositions}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `face` | {@linkcode FaceHandle} | The face to query |
+ * | `brep` | {@linkcode BrepHandle} | The parent brep (source of vertex coordinates) |
+ */
+export const PluginGeomQueryFaceListVertexPositionsArgs = z.object({
+  face: FaceHandle,
+  brep: BrepHandle,
+})
+export type PluginGeomQueryFaceListVertexPositionsArgs = z.infer<
+  typeof PluginGeomQueryFaceListVertexPositionsArgs
+>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.listVertexPositionsWithCurves}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceListVertexPositionsWithCurvesArgs = faceArg
+export type PluginGeomQueryFaceListVertexPositionsWithCurvesArgs = z.infer<
+  typeof PluginGeomQueryFaceListVertexPositionsWithCurvesArgs
+>
+
+/** Arguments for {@linkcode PluginGeomQueryFaceApi.listAdjacentFaces}. `{ face: FaceHandle }` */
+export const PluginGeomQueryFaceListAdjacentFacesArgs = faceArg
+export type PluginGeomQueryFaceListAdjacentFacesArgs = z.infer<
+  typeof PluginGeomQueryFaceListAdjacentFacesArgs
+>