@snaptrude/plugin-core 1.1.0-dev.20261025.1 → 1.1.0-pbr-20261026.1

package/src/api/design/networks.ts

@@ -1,6 +1,5 @@
 import * as z from "zod"
 import type { PluginApiReturn } from "../../types"
-import { Vec3Handle } from "../../handles"
 
 const id = z.string().regex(/^[A-Za-z][A-Za-z0-9_-]{0,79}$/)
 const vector = z.tuple([
@@ -413,47 +412,6 @@ export const NetworkCreateArgs = NetworkValidateArgs.extend({
   requestId: z.string().uuid(),
 })
 export const NetworkGetArgs = z.object({ graphId: z.string().uuid() }).strict()
-/** Displacement components are world millimetres, Y up, not Snaptrude units. */
-export const NetworkMoveEdgeArgs = NetworkGetArgs.extend({
-  expectedRevision: z.number().int().positive(),
-  edgeId: id,
-  displacement: Vec3Handle,
-  requestId: z.string().uuid(),
-}).strict()
-export type NetworkMoveEdgeArgs = z.input<typeof NetworkMoveEdgeArgs>
-
-export const NetworkMoveEdgeResult = z.object({
-  graphId: z.string().uuid(),
-  revision: z.number().int().positive(),
-  affectedComponentIds: z.array(z.string().min(1)),
-  alreadyApplied: z.boolean(),
-  /** Queue acceptance does not acknowledge durable storage. */
-  saveStatus: z.enum(["queued", "existing"]),
-}).strict()
-export type NetworkMoveEdgeResult = z.infer<typeof NetworkMoveEdgeResult>
-
-/** Immutable receipts survive undo. Retrying a move never executes it again. */
-export const NetworkEditReceipt = z.object({
-  requestId: z.string().uuid(),
-  fingerprint: z.string().max(1000),
-  revision: z.number().int().positive(),
-  affectedComponentIds: z.array(z.string().min(1)).max(1000),
-}).strict()
-export type NetworkEditReceipt = z.infer<typeof NetworkEditReceipt>
-
-/** Each intentional apply/undo/redo has its own identity. Retries reuse it. */
-export const NetworkTransition = z.object({
-  id: z.string().uuid(),
-  expectedRevision: z.number().int().positive(),
-  forward: z.boolean(),
-}).strict()
-export type NetworkTransition = z.infer<typeof NetworkTransition>
-
-export const NetworkTransitionReceipt = NetworkTransition.extend({
-  requestId: z.string().uuid(),
-  revision: z.number().int().positive(),
-}).strict()
-export type NetworkTransitionReceipt = z.infer<typeof NetworkTransitionReceipt>
 export const NetworkContextArgs = z
   .object({
     offset: z.number().int().nonnegative().default(0),
@@ -516,12 +474,10 @@ export type NetworkComponentBinding = z.infer<typeof NetworkComponentBinding>
 export interface SavedNetworkGraph {
   id: string
   domain: NetworkDomain
-  revision: number
+  revision: 1
   requestId: string
   document: NetworkGraphDocument
   components: NetworkComponentBinding[]
-  edits?: NetworkEditReceipt[]
-  transitions?: NetworkTransitionReceipt[]
 }
 export interface NetworkCreateResult {
   graphId: string
@@ -646,22 +602,6 @@ export abstract class PluginDomainNetworkApi {
 /** Electrical equipment, physical routes and logical circuits, constructed from agent-authored intent. */
 export abstract class PluginElectricalApi extends PluginDomainNetworkApi {}
 /** Plumbing equipment and routed pipe networks, constructed from agent-authored intent. */
-export abstract class PluginPlumbingApi extends PluginDomainNetworkApi {
-  /** Offset one straight pipe perpendicular to its axis between two rigid 90-degree elbows.
-   * Resize adjacent pipes through instance length parameters. Out-of-plane offsets add
-   * one pinned elbow and straight pipe per affected end, preserving fixed outer ports
-   * and existing component identities. Rigid fittings only rotate and translate.
-   * Reject axial sliding, moving tees, constrained fittings,
-   * scene drift, stale revisions, and infeasible family geometry before mutation.
-   * @param args Graph/edge identity, current revision, displacement handle in world mm,
-   * and a unique retry identity. Identical retries return the original receipt after undo too.
-   * @returns Affected component IDs and revision in one undoable, queued transaction.
-   * @example
-   * const displacement = await snaptrude.core.math.vec3.new(0, 300, 0)
-   * await snaptrude.design.plumbing.moveEdge({ graphId, edgeId, expectedRevision,
-   *   displacement, requestId: crypto.randomUUID() })
-   */
-  abstract moveEdge(args: NetworkMoveEdgeArgs): PluginApiReturn<NetworkMoveEdgeResult>
-}
+export abstract class PluginPlumbingApi extends PluginDomainNetworkApi {}
 /** Family-backed air-side HVAC networks. The agent authors engineering intent; the host constructs it. */
 export abstract class PluginMechanicalApi extends PluginDomainNetworkApi {}

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

@@ -1,8 +1,9 @@
 import * as z from "zod"
 import { PluginApiReturn } from "../../../types"
-import { ComponentHandle } from "../../../handles"
+import { ComponentHandle, MaterialHandle } from "../../../handles"
 import { PluginDesignChangeResult } from "../lock"
 import { PluginObjectCatalogGroup, PluginObjectCatalogItem } from "../doors"
+import { PluginMaterialSpec } from "../materials"
 
 /**
  * `snaptrude.design.windows` — window-specific reads. Creation lives at
@@ -22,6 +23,33 @@ import { PluginObjectCatalogGroup, PluginObjectCatalogItem } from "../doors"
 export abstract class PluginDesignWindowsApi {
   constructor() {}
 
+  /**
+   * Paint only the window's authored glazing, preserving its frame. Families change
+   * with linked copies; legacy catalogue types change every instance of that type.
+   * Undoable; refuses locked linked/type members or out-of-proposal targets.
+   * @param window Window whose glazing to paint
+   * @param material Handle or spec; preserve the exact listPresets name for PBR glass
+   * @returns Components affected, including linked/type instances
+   * @examplePrompt Use clear glass for this window without changing its frame
+   */
+  public abstract setGlazing(
+    window: ComponentHandle,
+    material: MaterialHandle | PluginMaterialSpec,
+  ): PluginApiReturn<PluginDesignChangeResult>
+
+  /**
+   * Paint only non-glazing slots (frames, sashes, hardware), never the clear panes.
+   * Scope, locking and undo match setGlazing and design.materials.applyToSlot.
+   * @param window Window whose frame to paint
+   * @param material Handle or spec, e.g. `{ name: preset.name }` from listPresets
+   * @returns Components affected, including linked/type instances
+   * @examplePrompt Use brushed metal for this window's frame without changing the glass
+   */
+  public abstract setFrame(
+    window: ComponentHandle,
+    material: MaterialHandle | PluginMaterialSpec,
+  ): PluginApiReturn<PluginDesignChangeResult>
+
   /**
    * Get the type name of a window — the label that identifies which kind of
    * window the instance is, as shown in its properties.
@@ -310,6 +338,15 @@ export type PluginDesignWindowSetHeightArgs = z.infer<
   typeof PluginDesignWindowSetHeightArgs
 >
 
+/** Arguments for setGlazing / setFrame; both preserve the other authored slot kind. */
+export const PluginDesignWindowSetSlotArgs = z.object({
+  window: ComponentHandle,
+  material: z.union([MaterialHandle, PluginMaterialSpec]),
+})
+export type PluginDesignWindowSetSlotArgs = z.infer<
+  typeof PluginDesignWindowSetSlotArgs
+>
+
 // ---------------------------------------------------------------------------
 // catalog (shared DTOs defined in ../doors, re-exported here for symmetry)
 // ---------------------------------------------------------------------------