@snaptrude/plugin-core 0.0.0-dev-20260908074328 → 0.0.0-dev-20260921132444

package/src/api/design/query/index.ts

@@ -11,6 +11,7 @@ import { PluginStaircasePreset } from "../create"
 import { PluginDesignQueryGeometryApi } from "./geometry"
 import { PluginDesignQuerySpacesApi } from "./spaces"
 import { PluginDesignQueryReferenceLinesApi } from "./referenceLines"
+import { PluginDesignQueryGridsApi } from "./grids"
 
 // ---------------------------------------------------------------------------
 // Entity type vocabulary
@@ -42,6 +43,7 @@ import { PluginDesignQueryReferenceLinesApi } from "./referenceLines"
  * | `"mullion"` | Curtain-wall mullion |
  * | `"panel"` | Curtain-wall panel |
  * | `"parametricComponent"` | A placed parametric family instance (native or Revit-imported). Its geometry is rebuilt from `design.family` parameters, so read and drive it through `design.family.getParameters` / `setParameters` rather than editing its meshes. |
+ * | `"grid"` | Structural grid group |
  */
 export const PluginEntityType = z.enum([
   "wall",
@@ -62,6 +64,7 @@ export const PluginEntityType = z.enum([
   "mullion",
   "panel",
   "parametricComponent",
+  "grid",
 ])
 export type PluginEntityType = z.infer<typeof PluginEntityType>
 
@@ -175,7 +178,6 @@ export type PluginDesignQueryComponentsArgs = z.infer<
  * | `isLocked` | `boolean` | Lock flag |
  * | `isHidden` | `boolean` | User-hidden flag |
  * | `isSelected` | `boolean` | Current selection state |
- * | `isVisible` | `boolean` | Whether the entity currently has a visible representation on canvas (user hide flag AND LOD/mode gating both considered); read-only |
  * | `boundingBox` | {@linkcode BBoxComponents} | World-space AABB |
  * | `adjacency` | `{ spaceId: string; value: number }[]` | Adjacency relationships (spaces/masses only). `value`: `2` = Direct (required), `1` = Indirect or physical contact, `-1` = Restricted; `0` entries are filtered out. `[]` when adjacency has never been computed — see `program.adjacency.compute`. |
  */
@@ -195,7 +197,6 @@ export const PluginEntityProperties = z
     isLocked: z.boolean(),
     isHidden: z.boolean(),
     isSelected: z.boolean(),
-    isVisible: z.boolean(),
     boundingBox: BBoxComponents,
     adjacency: z.array(z.object({ spaceId: z.string(), value: z.number() })),
   })
@@ -308,6 +309,8 @@ export abstract class PluginDesignQueryApi {
   public abstract spaces: PluginDesignQuerySpacesApi
   /** Reference-line-specific reads. See {@linkcode PluginDesignQueryReferenceLinesApi}. */
   public abstract referenceLines: PluginDesignQueryReferenceLinesApi
+  /** Structural-grid-specific reads. See {@linkcode PluginDesignQueryGridsApi}. */
+  public abstract grids: PluginDesignQueryGridsApi
 
   constructor() {}
 
@@ -725,6 +728,27 @@ export abstract class PluginDesignQueryApi {
     filter?: PluginEntityFilter,
   ): PluginApiReturn<ComponentHandle[]>
 
+  /**
+   * List all the structural grids (grid groups) in the project, optionally
+   * filtered by storey, building, selection state, or region.
+   *
+   * @param filter - an optional {@linkcode PluginEntityFilter}
+   * @returns grid-group {@linkcode ComponentHandle}`[]`
+   *
+   * @examplePrompt List all the structural grids in the model
+   * @examplePrompt How many grids are on the ground floor?
+   * @examplePrompt Show the grids on this storey
+   * @examplePrompt Which grids are currently selected?
+   *
+   * # Example
+   * ```ts
+   * const groundFloorGrids = await snaptrude.design.query.listGrids({ storeys: [1] })
+   * ```
+   */
+  public abstract listGrids(
+    filter?: PluginEntityFilter,
+  ): PluginApiReturn<ComponentHandle[]>
+
   // ── single-entity access & identity ─────────────────────────────────────────
 
   /**
@@ -1149,3 +1173,4 @@ export type PluginStoreyOutlineResult = z.infer<
 export * from "./geometry"
 export * from "./spaces"
 export * from "./referenceLines"
+export * from "./grids"

package/src/api/design/query/spaces.ts

@@ -124,41 +124,6 @@ export abstract class PluginDesignQuerySpacesApi {
   public abstract getEnclosure(
     space: ComponentHandle,
   ): PluginApiReturn<PluginSpaceEnclosure | null>
-
-  /**
-   * List the space's **engine-generated BIM components** — the walls, floors
-   * and slabs the parametric engine derived from this space, grouped by kind.
-   *
-   * Unlike {@linkcode getEnclosure} (a geometric best-effort match), this read
-   * reports the engine's own derivation records, so every returned handle is a
-   * component the engine created *for this space*.
-   *
-   * The derived set is NOT stable across writes: a merge/split/rebuild of the
-   * space graph retires members and creates successors — re-query after any
-   * write that touches the space. This is the churn-recovery anchor: when a
-   * cached derived handle goes stale, call this again to pick up the current
-   * set.
-   *
-   * @param space - The space (room mass) to read
-   * @returns the generated component handles, grouped by kind
-   *   ({@linkcode PluginSpaceGeneratedBim}); a group is `[]` when the engine
-   *   derived nothing of that kind
-   * @throws If the space does not exist or the component is not a space/mass
-   *
-   * @examplePrompt Which walls did this room generate?
-   * @examplePrompt List the BIM components derived from the selected space
-   * @examplePrompt Get the floors and slabs that belong to this room
-   *
-   * # Example
-   * ```ts
-   * const [space] = await snaptrude.design.query.listSpaces()
-   * const bim = await snaptrude.design.query.spaces.listGeneratedBim(space)
-   * console.log(`${bim.walls.length} walls, ${bim.floors.length} floors`)
-   * ```
-   */
-  public abstract listGeneratedBim(
-    space: ComponentHandle,
-  ): PluginApiReturn<PluginSpaceGeneratedBim>
 }
 
 /**
@@ -308,36 +273,3 @@ export const PluginSpaceEnclosure = z.object({
   adjacentSpaces: z.array(PluginAdjacentSpace),
 })
 export type PluginSpaceEnclosure = z.infer<typeof PluginSpaceEnclosure>
-
-/**
- * Arguments for {@linkcode PluginDesignQuerySpacesApi.listGeneratedBim}.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `space` | {@linkcode ComponentHandle} | The space (room mass) to read |
- */
-export const PluginDesignQuerySpacesListGeneratedBimArgs = z.object({
-  space: ComponentHandle,
-})
-export type PluginDesignQuerySpacesListGeneratedBimArgs = z.infer<
-  typeof PluginDesignQuerySpacesListGeneratedBimArgs
->
-
-/**
- * Result of {@linkcode PluginDesignQuerySpacesApi.listGeneratedBim} — the
- * space's engine-generated BIM component handles, grouped by kind. The set
- * changes whenever a write merges/splits/rebuilds the space graph — re-query
- * after writes rather than caching it.
- *
- * | Property | Type | Description |
- * |---|---|---|
- * | `walls` | {@linkcode ComponentHandle}`[]` | Walls the engine derived from the space |
- * | `floors` | {@linkcode ComponentHandle}`[]` | Floors the engine derived from the space |
- * | `slabs` | {@linkcode ComponentHandle}`[]` | Slabs the engine derived from the space |
- */
-export const PluginSpaceGeneratedBim = z.object({
-  walls: z.array(ComponentHandle),
-  floors: z.array(ComponentHandle),
-  slabs: z.array(ComponentHandle),
-})
-export type PluginSpaceGeneratedBim = z.infer<typeof PluginSpaceGeneratedBim>

package/src/api/design/update/index.ts

@@ -15,6 +15,7 @@ import {
   PluginBuildableEnvelopeVerticalCap,
   PluginBuildableEnvelopeUpdateResult,
 } from "../../entity/buildableEnvelope"
+import { PluginGridStyleOptions } from "../create/grids"
 
 /**
  * Sparse property updates for a space. Only provided fields change.
@@ -238,6 +239,27 @@ export type PluginDesignSetStoreyArgs = z.infer<
   typeof PluginDesignSetStoreyArgs
 >
 
+/**
+ * The sparse GROUP-LEVEL patch accepted by {@linkcode PluginDesignUpdateApi.grid}.
+ * Only provided fields change. Wing- and line-level updates live on the grids
+ * entity family: `design.grids.updateWings` / `design.grids.updateLines`.
+ */
+export const PluginGridPatch = z.object({
+  angle: z.number().finite().optional(),
+  props: PluginGridStyleOptions.optional(),
+  storeyVisibility: z
+    .array(z.object({ storey: z.number().int(), visible: z.boolean() }))
+    .optional(),
+})
+export type PluginGridPatch = z.infer<typeof PluginGridPatch>
+
+/** Arguments for {@linkcode PluginDesignUpdateApi.grid}. */
+export const PluginDesignUpdateGridArgs = z.object({
+  grid: ComponentHandle,
+  patch: PluginGridPatch,
+})
+export type PluginDesignUpdateGridArgs = z.infer<typeof PluginDesignUpdateGridArgs>
+
 /**
  * `snaptrude.design.update` — edit existing scene entities (properties + geometry).
  *
@@ -290,6 +312,37 @@ export abstract class PluginDesignUpdateApi {
     label: string,
   ): PluginApiReturn<boolean>
 
+  /**
+   * Update a structural grid's **group-level** fields with a sparse patch —
+   * default line styling, absolute angle, and per-storey 2D visibility. Only
+   * provided fields change. Wing- and line-level updates live on the grids
+   * entity family: {@linkcode PluginDesignGridsApi.updateWings} /
+   * {@linkcode PluginDesignGridsApi.updateLines}.
+   *
+   * Every change routes through the exact setters the native panel uses —
+   * each changed field commits its own undoable command, identical to editing
+   * that field in the panel. `angle` is an absolute target in degrees (CCW
+   * about +Y).
+   *
+   * @param grid - The grid group to update
+   * @param patch - The sparse {@linkcode PluginGridPatch}
+   * @returns `true` once applied
+   *
+   * @examplePrompt Rotate the grid to 45 degrees
+   * @examplePrompt Make this grid's lines dashed and grey
+   * @examplePrompt Hide this grid on storey 3's plan
+   *
+   * # Example
+   * ```ts
+   * const [grid] = await snaptrude.design.query.listGrids()
+   * await snaptrude.design.update.grid(grid, { angle: 45, props: { style: "DASHED" } })
+   * ```
+   */
+  public abstract grid(
+    grid: ComponentHandle,
+    patch: PluginGridPatch,
+  ): PluginApiReturn<boolean>
+
   /**
    * Update a single space (room) — change its properties (room label, space
    * type, mass type, area class, department) and/or replace its geometry by

package/src/api/entity/space.ts

@@ -434,7 +434,6 @@ export type PluginSpaceUpdateArgs = z.infer<typeof PluginSpaceUpdateArgs>
  * | `massType` | `string?` | Updated mass type (if changed) |
  * | `spaceType` | `string?` | Updated space type (if changed) |
  * | `departmentId` | `string \| null?` | Updated department ID (if changed) |
- * | `rebuilt` | `boolean?` | `true` when a geometry update rebuilt the space's derived BIM — hosted children were re-created and the previous derived handles are retired (re-query them) |
  */
 export const PluginSpaceUpdateResult = z.object({
   spaceId: z.string(),
@@ -443,7 +442,6 @@ export const PluginSpaceUpdateResult = z.object({
   spaceType: z.string().optional(),
   areaClass: PluginAreaClass.optional(),
   departmentId: z.string().nullable().optional(),
-  rebuilt: z.boolean().optional(),
 })
 
 export type PluginSpaceUpdateResult = z.infer<typeof PluginSpaceUpdateResult>

package/src/api/presentation/placedViews.ts

@@ -1,6 +1,6 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../types"
-import { PluginSheetPosition, PluginViewLod } from "./sheets"
+import { PluginSheetPosition } from "./sheets"
 
 /**
  * Placed views — the view shapes already laid out on the Present canvas.
@@ -613,23 +613,6 @@ export abstract class PluginPresentationPlacedViewsApi {
     shapeId: string,
     enabled: boolean,
   ): PluginApiReturn<void>
-
-  /**
-   * Set the level of detail a placed view renders at — `"design"` (the
-   * Design-mode massing representation) or `"bim"` (the detailed BIM
-   * representation). Views only. Undoable. Requires Present mode to be open.
-   *
-   * @param shapeId - The placed view shape.
-   * @param lod - Target level of detail.
-   * @throws If Present mode is not open or `shapeId` is not a placed view.
-   *
-   * @examplePrompt Switch this placed view to the BIM level of detail
-   * @examplePrompt Show the massing version of the placed plan
-   */
-  public abstract setLod(
-    shapeId: string,
-    lod: PluginViewLod,
-  ): PluginApiReturn<void>
 }
 
 /** A point in crop space — fractions (0–1) of the uncropped view. */
@@ -674,8 +657,6 @@ export type PluginPlacedViewCrop = z.infer<typeof PluginPlacedViewCrop>
  * | `rotation` | `number` | Rotation in radians, `[0, 2π)` (nonzero only for 3D views — 2D views cannot rotate; set with `setRotation`) |
  * | `crop` | {@linkcode PluginPlacedViewCrop}` \| null` | Crop window (`null` when uncropped) |
  * | `isUnlinked` | `boolean` | Whether the source proposal was removed (an unlinked view no longer refreshes) |
- * | `lod` | {@linkcode PluginViewLod}? | Level of detail the view renders at (`"design"` massing / `"bim"` detail); absent on views that predate LOD variants (set with `setLod`) |
- * | `inactiveBuildingMask` | `boolean`? | Whether inactive proposal buildings are masked (the `setMask` toggle); absent when never set (masked by default) |
  */
 export const PluginPlacedView = z.object({
   shapeId: z.string(),
@@ -689,8 +670,6 @@ export const PluginPlacedView = z.object({
   rotation: z.number(),
   crop: PluginPlacedViewCrop.nullable(),
   isUnlinked: z.boolean(),
-  lod: PluginViewLod.optional(),
-  inactiveBuildingMask: z.boolean().optional(),
 })
 export type PluginPlacedView = z.infer<typeof PluginPlacedView>
 
@@ -1139,10 +1118,3 @@ export const PluginPlacedViewsSetMaskArgs = z.object({
   enabled: z.boolean(),
 })
 export type PluginPlacedViewsSetMaskArgs = z.infer<typeof PluginPlacedViewsSetMaskArgs>
-
-/** Arguments for {@link PluginPresentationPlacedViewsApi.setLod}. */
-export const PluginPlacedViewsSetLodArgs = z.object({
-  shapeId: z.string().min(1),
-  lod: PluginViewLod,
-})
-export type PluginPlacedViewsSetLodArgs = z.infer<typeof PluginPlacedViewsSetLodArgs>

package/src/api/presentation/sheets.ts

@@ -172,10 +172,9 @@ export abstract class PluginPresentationSheetsApi {
    * @param sheetId - The id of the sheet to place onto.
    * @param viewId - The id of the saved view to place.
    * @param options - Optional `position` ({@linkcode PluginSheetPosition}) —
-   *   where to place it (sheet centre when omitted) — `scale` — a standard
+   *   where to place it (sheet centre when omitted) — and `scale` — a standard
    *   scale value for the project's unit system (2D/site-plan views only;
-   *   auto-fit when omitted) — and `lod` ({@linkcode PluginViewLod}) — the LOD
-   *   of the placed view (default: the product's Design default).
+   *   auto-fit when omitted).
    * @returns A {@linkcode PluginPresentationSheetsPlaceResult} with the created
    *   `shapeId`.
    * @throws If Present mode is not open, the sheet/view id is invalid, `scale`
@@ -198,11 +197,7 @@ export abstract class PluginPresentationSheetsApi {
   public abstract place(
     sheetId: string,
     viewId: string,
-    options?: {
-      position?: PluginSheetPosition
-      scale?: number
-      lod?: PluginViewLod
-    },
+    options?: { position?: PluginSheetPosition; scale?: number },
   ): PluginApiReturn<PluginPresentationSheetsPlaceResult>
 
   /**
@@ -413,15 +408,6 @@ export const PluginSheetPosition = z.object({
 })
 export type PluginSheetPosition = z.infer<typeof PluginSheetPosition>
 
-/**
- * The level of detail a placed view renders at: `"design"` (the Design-mode
- * massing representation) or `"bim"` (the detailed BIM representation).
- * Shared by `sheets.place` and `placedViews.*` (defined here because
- * `placedViews` already imports from this module).
- */
-export const PluginViewLod = z.enum(["design", "bim"])
-export type PluginViewLod = z.infer<typeof PluginViewLod>
-
 /** Result of {@linkcode PluginPresentationSheetsApi.list}. */
 export const PluginPresentationSheetsListResult = z.object({
   sheets: z.array(PluginPresentationSheet),
@@ -483,14 +469,12 @@ export type PluginPresentationSheetsSetMarginArgs = z.infer<
  * | `viewId` | `string` | The saved view to place |
  * | `position` | {@linkcode PluginSheetPosition}` \| undefined` | Where to place it (sheet centre when omitted) |
  * | `scale` | `number \| undefined` | Standard scale value for the project's unit system (2D/site-plan views only; auto-fit to the closest standard scale when omitted) |
- * | `lod` | {@linkcode PluginViewLod}` \| undefined` | LOD of the placed view (default: the product's Design default) |
  */
 export const PluginPresentationSheetsPlaceArgs = z.object({
   sheetId: z.string(),
   viewId: z.string(),
   position: PluginSheetPosition.optional(),
   scale: z.number().positive().optional(),
-  lod: PluginViewLod.optional(),
 })
 export type PluginPresentationSheetsPlaceArgs = z.infer<
   typeof PluginPresentationSheetsPlaceArgs

package/src/api/program/departments.ts

@@ -7,7 +7,7 @@ import { ComponentHandle } from "../../handles"
  * Program departments — read the department groupings of the active program.
  *
  * In program mode a **department** is a named, colored grouping of spaces with an
- * optional area **target**. This is the program-planning view of departments
+ * optional gross area **target** and a unit **count** target. This is the program-planning view of departments
  * (their identity, color, and target area); the underlying space geometry is read
  * and edited through the geometry namespaces, not here.
  *
@@ -203,6 +203,33 @@ export abstract class PluginProgramDepartmentsApi {
     units?: PluginAreaUnit,
   ): PluginApiReturn<PluginProgramDepartmentsSetTargetAreaResult>
 
+  /**
+   * Set a department's target unit count.
+   *
+   * The number of units (program blocks) the department is planned for — the
+   * count twin of {@linkcode PluginProgramDepartmentsApi.setTargetArea}, stored
+   * beside the gross area target on the department. Read it back from
+   * {@linkcode PluginProgramDepartmentsApi.get} (`targetCount`).
+   *
+   * @param departmentId - The id of the department whose count to set.
+   * @param targetCount - The target number of units (a non-negative integer).
+   * @returns The updated {@linkcode PluginProgramDepartment} with its `units`.
+   * @throws If no department has the given id.
+   *
+   * @examplePrompt Set the Bedrooms department unit count to 12
+   * @examplePrompt The program needs 4 clinic blocks — update the department count
+   * @examplePrompt Update the target count for department dep_123
+   *
+   * # Example
+   * ```ts
+   * await snaptrude.program.departments.setTargetCount("dep_123", 12)
+   * ```
+   */
+  public abstract setTargetCount(
+    departmentId: string,
+    targetCount: number,
+  ): PluginApiReturn<PluginProgramDepartmentsSetTargetCountResult>
+
   /**
    * Delete a department.
    *
@@ -239,13 +266,15 @@ export abstract class PluginProgramDepartmentsApi {
  * | `id` | `string` | Unique department id |
  * | `name` | `string` | Display name |
  * | `color` | `string` | CSS hex color string (e.g. `"#b5e1dc"`) |
- * | `targetArea` | `number \| null` | Target area in the response's `units`, or `null` if no target is set |
+ * | `targetArea` | `number \| null` | Gross target area in the response's `units`, or `null` if no target is set |
+ * | `targetCount` | `number` | Target number of units / program blocks (`0` when unset) |
  */
 export const PluginProgramDepartment = z.object({
   id: z.string(),
   name: z.string(),
   color: z.string(),
   targetArea: z.number().nullable(),
+  targetCount: z.number(),
 })
 export type PluginProgramDepartment = z.infer<typeof PluginProgramDepartment>
 
@@ -434,6 +463,29 @@ export type PluginProgramDepartmentsSetTargetAreaResult = z.infer<
   typeof PluginProgramDepartmentsSetTargetAreaResult
 >
 
+/**
+ * Arguments for {@linkcode PluginProgramDepartmentsApi.setTargetCount}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `departmentId` | `string` | The id of the department whose count to set |
+ * | `targetCount` | `number` | Target number of units (non-negative integer) |
+ */
+export const PluginProgramDepartmentsSetTargetCountArgs = z.object({
+  departmentId: z.string(),
+  targetCount: z.number().int().nonnegative(),
+})
+export type PluginProgramDepartmentsSetTargetCountArgs = z.infer<
+  typeof PluginProgramDepartmentsSetTargetCountArgs
+>
+
+/** Result of {@linkcode PluginProgramDepartmentsApi.setTargetCount} — the updated record with `units`. */
+export const PluginProgramDepartmentsSetTargetCountResult =
+  PluginProgramDepartmentRecord
+export type PluginProgramDepartmentsSetTargetCountResult = z.infer<
+  typeof PluginProgramDepartmentsSetTargetCountResult
+>
+
 /**
  * Arguments for {@linkcode PluginProgramDepartmentsApi.delete}.
  *

package/src/api/program/index.ts

@@ -7,22 +7,26 @@ import { PluginProgramSiteApi } from "./site"
 import { PluginProgramCoresApi } from "./cores"
 import { PluginProgramClassificationApi } from "./classification"
 import { PluginProgramAreasApi } from "./areas"
+import { PluginProgramMetadataApi } from "./metadata"
+import { PluginProgramLabelsApi } from "./labels"
 
 /**
  * Program-mode planning APIs.
  *
  * The program is the space-planning layer: department groupings with area targets,
- * the metrics that track allocated area against those targets, and the reports
- * that render program/takeoff data to spreadsheet sheets. Reads describe the
- * *plan* (intent + targets); the geometry that realizes the plan is authored
- * through the geometry namespaces.
+ * the labels (program rows) inside them, the metrics that track allocated area
+ * against those targets, and the reports that render program/takeoff data to
+ * spreadsheet sheets. Reads describe the *plan* (intent + targets); the geometry
+ * that realizes the plan is authored through the geometry namespaces.
  *
  * - {@linkcode PluginProgramApi.departments} — Read & edit program departments (groupings + targets)
+ * - {@linkcode PluginProgramApi.labels} — Read & edit program labels (program rows: per-type area/count targets)
+ * - {@linkcode PluginProgramApi.metadata} — Read & edit program metadata (custom columns) on spaces
  * - {@linkcode PluginProgramApi.adjacency} — Read & compute the department/space adjacency matrix
  * - {@linkcode PluginProgramApi.layout} — Arrange/pack spaces in the envelope
  * - {@linkcode PluginProgramApi.metrics} — Read the area-program summary
  * - {@linkcode PluginProgramApi.areas} — FAR / built-up-area rollup and groupings
- * - {@linkcode PluginProgramApi.spreadsheet} — Render program data to sheets and read it back
+ * - {@linkcode PluginProgramApi.spreadsheet} — Render program data to sheets, custom grouped sheets, read back
  * - {@linkcode PluginProgramApi.site} — Read site/plot context and read/update Site Analysis
  * - {@linkcode PluginProgramApi.cores} — Read & predicate vertical-circulation cores (reads only)
  * - {@linkcode PluginProgramApi.classification} — Classification catalog + display tags
@@ -32,6 +36,10 @@ import { PluginProgramAreasApi } from "./areas"
 export abstract class PluginProgramApi {
   /** Program departments — groupings, area targets, and space assignment. See {@linkcode PluginProgramDepartmentsApi}. */
   public abstract departments: PluginProgramDepartmentsApi
+  /** Program labels — the program rows with per-type area/count targets. See {@linkcode PluginProgramLabelsApi}. */
+  public abstract labels: PluginProgramLabelsApi
+  /** Program metadata — custom columns and their per-space values. See {@linkcode PluginProgramMetadataApi}. */
+  public abstract metadata: PluginProgramMetadataApi
   /** Adjacency matrix — read & compute proximity relationships. See {@linkcode PluginProgramAdjacencyApi}. */
   public abstract adjacency: PluginProgramAdjacencyApi
   /** Arrange/pack spaces in the envelope (async job family). See {@linkcode PluginProgramLayoutApi}. */
@@ -40,7 +48,7 @@ export abstract class PluginProgramApi {
   public abstract metrics: PluginProgramMetricsApi
   /** FAR / built-up-area rollup and groupings. See {@linkcode PluginProgramAreasApi}. */
   public abstract areas: PluginProgramAreasApi
-  /** Spreadsheet reports — render tables to sheets, export, list, read back. See {@linkcode PluginProgramSpreadsheetApi}. */
+  /** Spreadsheet reports — render tables to sheets, custom grouped sheets, export, read back. See {@linkcode PluginProgramSpreadsheetApi}. */
   public abstract spreadsheet: PluginProgramSpreadsheetApi
   /** Site/plot context and persisted Site Analysis. See {@linkcode PluginProgramSiteApi}. */
   public abstract site: PluginProgramSiteApi
@@ -61,3 +69,5 @@ export * from "./site"
 export * from "./cores"
 export * from "./classification"
 export * from "./areas"
+export * from "./metadata"
+export * from "./labels"