@snaptrude/plugin-core 0.9.17 → 0.9.18-edgesetbacks-20261021.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (219) hide show
  1. package/AGENTS.md +231 -231
  2. package/CHANGELOG.md +408 -408
  3. package/CLAUDE.md +11 -11
  4. package/api-manifest.json +1428 -712
  5. package/dist/api/analysis/daylight.d.ts +5 -5
  6. package/dist/api/analysis/solar.d.ts +2 -2
  7. package/dist/api/core/camera/index.d.ts +29 -0
  8. package/dist/api/core/camera/index.d.ts.map +1 -1
  9. package/dist/api/core/geom/create/index.d.ts +7 -1
  10. package/dist/api/core/geom/create/index.d.ts.map +1 -1
  11. package/dist/api/core/geom/update/contour.d.ts +8 -2
  12. package/dist/api/core/geom/update/contour.d.ts.map +1 -1
  13. package/dist/api/core/storeys/index.d.ts +5 -2
  14. package/dist/api/core/storeys/index.d.ts.map +1 -1
  15. package/dist/api/core/zoom/index.d.ts +13 -0
  16. package/dist/api/core/zoom/index.d.ts.map +1 -1
  17. package/dist/api/design/bim.d.ts +299 -0
  18. package/dist/api/design/bim.d.ts.map +1 -0
  19. package/dist/api/design/boolean/index.d.ts +2 -0
  20. package/dist/api/design/boolean/index.d.ts.map +1 -1
  21. package/dist/api/design/catalog.d.ts +320 -0
  22. package/dist/api/design/catalog.d.ts.map +1 -0
  23. package/dist/api/design/create/bulk-items.d.ts +65 -25
  24. package/dist/api/design/create/bulk-items.d.ts.map +1 -1
  25. package/dist/api/design/create/index.d.ts +299 -100
  26. package/dist/api/design/create/index.d.ts.map +1 -1
  27. package/dist/api/design/create/opening-fields.d.ts +13 -12
  28. package/dist/api/design/create/opening-fields.d.ts.map +1 -1
  29. package/dist/api/design/delete/index.d.ts +1 -0
  30. package/dist/api/design/delete/index.d.ts.map +1 -1
  31. package/dist/api/design/doors/index.d.ts +18 -24
  32. package/dist/api/design/doors/index.d.ts.map +1 -1
  33. package/dist/api/design/family.d.ts +813 -35
  34. package/dist/api/design/family.d.ts.map +1 -1
  35. package/dist/api/design/index.d.ts +16 -0
  36. package/dist/api/design/index.d.ts.map +1 -1
  37. package/dist/api/design/networks.d.ts +1703 -0
  38. package/dist/api/design/networks.d.ts.map +1 -0
  39. package/dist/api/design/query/grids.d.ts +2 -2
  40. package/dist/api/design/query/index.d.ts +42 -32
  41. package/dist/api/design/query/index.d.ts.map +1 -1
  42. package/dist/api/design/selection/index.d.ts +10 -10
  43. package/dist/api/design/types/index.d.ts +40 -24
  44. package/dist/api/design/types/index.d.ts.map +1 -1
  45. package/dist/api/design/update/index.d.ts +111 -6
  46. package/dist/api/design/update/index.d.ts.map +1 -1
  47. package/dist/api/design/windows/index.d.ts +8 -8
  48. package/dist/api/design/windows/index.d.ts.map +1 -1
  49. package/dist/api/entity/buildableEnvelope.d.ts +84 -2
  50. package/dist/api/entity/buildableEnvelope.d.ts.map +1 -1
  51. package/dist/api/presentation/aiInspiration.d.ts +10 -10
  52. package/dist/api/presentation/annotate.d.ts +38 -22
  53. package/dist/api/presentation/annotate.d.ts.map +1 -1
  54. package/dist/api/presentation/drawingContract.d.ts +32 -0
  55. package/dist/api/presentation/drawingContract.d.ts.map +1 -0
  56. package/dist/api/presentation/drawings.d.ts +3523 -0
  57. package/dist/api/presentation/drawings.d.ts.map +1 -0
  58. package/dist/api/presentation/export.d.ts +23 -5
  59. package/dist/api/presentation/export.d.ts.map +1 -1
  60. package/dist/api/presentation/index.d.ts +32 -12
  61. package/dist/api/presentation/index.d.ts.map +1 -1
  62. package/dist/api/presentation/placedViews.d.ts +106 -6
  63. package/dist/api/presentation/placedViews.d.ts.map +1 -1
  64. package/dist/api/presentation/shapes.d.ts +2 -2
  65. package/dist/api/presentation/sheets.d.ts +175 -19
  66. package/dist/api/presentation/sheets.d.ts.map +1 -1
  67. package/dist/api/presentation/viewPresets.d.ts +222 -0
  68. package/dist/api/presentation/viewPresets.d.ts.map +1 -0
  69. package/dist/api/presentation/views.d.ts +141 -8
  70. package/dist/api/presentation/views.d.ts.map +1 -1
  71. package/dist/api/presentation/walkthroughs.d.ts +6 -6
  72. package/dist/errors/codes.d.ts +3 -1
  73. package/dist/errors/codes.d.ts.map +1 -1
  74. package/dist/index.cjs +3831 -2444
  75. package/dist/index.cjs.map +1 -1
  76. package/dist/index.js +3705 -2444
  77. package/dist/index.js.map +1 -1
  78. package/package.json +1 -1
  79. package/scripts/check-dist-fresh.mjs +22 -22
  80. package/scripts/generate-manifest.mjs +243 -238
  81. package/scripts/generate-manifest.test.mjs +303 -303
  82. package/src/api/analysis/daylight.ts +470 -470
  83. package/src/api/analysis/heatmaps.ts +683 -683
  84. package/src/api/analysis/illuminance.ts +155 -155
  85. package/src/api/analysis/index.ts +61 -61
  86. package/src/api/analysis/shadows.ts +183 -183
  87. package/src/api/analysis/solar.ts +237 -237
  88. package/src/api/analysis/sunlightHours.ts +211 -211
  89. package/src/api/analysis/sunpath.ts +83 -83
  90. package/src/api/analysis/weather.ts +179 -179
  91. package/src/api/core/buildings.ts +485 -485
  92. package/src/api/core/camera/index.ts +696 -667
  93. package/src/api/core/comment/index.ts +376 -376
  94. package/src/api/core/geom/create/index.ts +2139 -2133
  95. package/src/api/core/geom/delete/index.ts +84 -84
  96. package/src/api/core/geom/index.ts +35 -35
  97. package/src/api/core/geom/query/arc.ts +169 -169
  98. package/src/api/core/geom/query/brep.ts +621 -621
  99. package/src/api/core/geom/query/circle.ts +404 -404
  100. package/src/api/core/geom/query/contour.ts +540 -540
  101. package/src/api/core/geom/query/curve.ts +1102 -1102
  102. package/src/api/core/geom/query/edge.ts +130 -130
  103. package/src/api/core/geom/query/face.ts +508 -508
  104. package/src/api/core/geom/query/halfedge.ts +210 -210
  105. package/src/api/core/geom/query/index.ts +63 -63
  106. package/src/api/core/geom/query/profile.ts +473 -473
  107. package/src/api/core/geom/query/vertex.ts +205 -205
  108. package/src/api/core/geom/update/contour.ts +323 -317
  109. package/src/api/core/geom/update/curve.ts +209 -209
  110. package/src/api/core/geom/update/index.ts +29 -29
  111. package/src/api/core/geom/update/profile.ts +379 -379
  112. package/src/api/core/groups.ts +521 -521
  113. package/src/api/core/handles/index.ts +234 -234
  114. package/src/api/core/history/index.ts +84 -84
  115. package/src/api/core/index.ts +99 -99
  116. package/src/api/core/io/export/index.ts +126 -126
  117. package/src/api/core/io/import/index.ts +504 -504
  118. package/src/api/core/io/index.ts +42 -42
  119. package/src/api/core/io/job/index.ts +140 -140
  120. package/src/api/core/io/query/index.ts +71 -71
  121. package/src/api/core/io/terrain/index.ts +360 -360
  122. package/src/api/core/io/underlay/index.ts +705 -705
  123. package/src/api/core/layers.ts +540 -540
  124. package/src/api/core/math/index.ts +20 -20
  125. package/src/api/core/math/quat.ts +172 -172
  126. package/src/api/core/math/vec3.ts +179 -179
  127. package/src/api/core/mode/index.ts +108 -108
  128. package/src/api/core/project/index.ts +479 -479
  129. package/src/api/core/proposals/index.ts +570 -570
  130. package/src/api/core/storeys/index.ts +311 -308
  131. package/src/api/core/storeys/layers.ts +339 -339
  132. package/src/api/core/tags.ts +911 -911
  133. package/src/api/core/units/index.ts +164 -164
  134. package/src/api/core/user.ts +46 -46
  135. package/src/api/core/zoom/index.ts +64 -51
  136. package/src/api/design/bim.ts +210 -0
  137. package/src/api/design/boolean/index.ts +181 -179
  138. package/src/api/design/catalog.ts +203 -0
  139. package/src/api/design/create/bulk-items.ts +294 -254
  140. package/src/api/design/create/grids.ts +137 -137
  141. package/src/api/design/create/index.ts +2178 -1980
  142. package/src/api/design/create/opening-fields.ts +40 -37
  143. package/src/api/design/delete/index.ts +75 -74
  144. package/src/api/design/dimensions.ts +453 -453
  145. package/src/api/design/doors/index.ts +516 -500
  146. package/src/api/design/edit/index.ts +54 -54
  147. package/src/api/design/erase/index.ts +151 -151
  148. package/src/api/design/family.ts +1342 -704
  149. package/src/api/design/furniture/index.ts +319 -319
  150. package/src/api/design/grids.ts +237 -237
  151. package/src/api/design/index.ts +304 -274
  152. package/src/api/design/lock.ts +69 -69
  153. package/src/api/design/materials/index.ts +608 -608
  154. package/src/api/design/networks.ts +607 -0
  155. package/src/api/design/query/geometry/index.ts +319 -319
  156. package/src/api/design/query/grids.ts +197 -197
  157. package/src/api/design/query/index.ts +1236 -1226
  158. package/src/api/design/query/referenceLines.ts +52 -52
  159. package/src/api/design/query/spaces.ts +275 -275
  160. package/src/api/design/selection/index.ts +273 -273
  161. package/src/api/design/shared.ts +40 -40
  162. package/src/api/design/transform/index.ts +254 -254
  163. package/src/api/design/types/index.ts +163 -156
  164. package/src/api/design/update/index.ts +1096 -983
  165. package/src/api/design/visibility.ts +143 -143
  166. package/src/api/design/windows/index.ts +351 -333
  167. package/src/api/entity/buildableEnvelope.ts +397 -322
  168. package/src/api/entity/index.ts +30 -30
  169. package/src/api/entity/referenceLine.ts +235 -235
  170. package/src/api/entity/space.ts +612 -612
  171. package/src/api/entity/story.ts +517 -517
  172. package/src/api/index.ts +47 -47
  173. package/src/api/presentation/aiInspiration.ts +1116 -1116
  174. package/src/api/presentation/annotate.ts +417 -385
  175. package/src/api/presentation/camera.ts +289 -289
  176. package/src/api/presentation/diagrams.ts +194 -194
  177. package/src/api/presentation/drawingContract.ts +70 -0
  178. package/src/api/presentation/drawings.ts +1179 -0
  179. package/src/api/presentation/export.ts +134 -108
  180. package/src/api/presentation/import.ts +159 -159
  181. package/src/api/presentation/index.ts +160 -135
  182. package/src/api/presentation/placedViews.ts +1211 -1120
  183. package/src/api/presentation/sections.ts +420 -420
  184. package/src/api/presentation/shapes.ts +274 -274
  185. package/src/api/presentation/sheets.ts +746 -585
  186. package/src/api/presentation/slideshow.ts +134 -134
  187. package/src/api/presentation/tables.ts +84 -84
  188. package/src/api/presentation/viewPresets.ts +241 -0
  189. package/src/api/presentation/views.ts +742 -673
  190. package/src/api/presentation/walkthroughs.ts +1201 -1201
  191. package/src/api/program/adjacency.ts +164 -164
  192. package/src/api/program/areas.ts +408 -408
  193. package/src/api/program/classification.ts +138 -138
  194. package/src/api/program/cores.ts +83 -83
  195. package/src/api/program/departments.ts +517 -517
  196. package/src/api/program/index.ts +73 -73
  197. package/src/api/program/labels.ts +332 -332
  198. package/src/api/program/layout.ts +422 -422
  199. package/src/api/program/metadata.ts +364 -364
  200. package/src/api/program/metrics.ts +120 -120
  201. package/src/api/program/site.ts +748 -748
  202. package/src/api/program/spreadsheet.ts +2698 -2698
  203. package/src/api/workspace/index.ts +612 -612
  204. package/src/errors/codes.ts +143 -136
  205. package/src/errors/envelope.ts +75 -75
  206. package/src/errors/index.ts +21 -21
  207. package/src/errors/plugin-error.ts +134 -134
  208. package/src/handles.ts +297 -297
  209. package/src/host-utils.ts +67 -67
  210. package/src/index.ts +7 -7
  211. package/src/massParameters.ops.ts +246 -246
  212. package/src/massParameters.ts +427 -427
  213. package/src/types.ts +16 -16
  214. package/test/drawingContract.test.mjs +288 -0
  215. package/test/errors.test.mjs +185 -184
  216. package/test/massParameters.test.mjs +952 -952
  217. package/test/presentationViewSettings.test.mjs +85 -0
  218. package/tsconfig.json +22 -22
  219. package/tsup.config.ts +12 -12
@@ -0,0 +1,299 @@
1
+ import * as z from "zod";
2
+ import { ComponentHandle } from "../../handles";
3
+ import type { PluginApiReturn } from "../../types";
4
+ /** Read scope. Omit spaces to inspect the active proposal's sketch spaces. */
5
+ export declare const PluginBimContextArgs: z.ZodObject<{
6
+ spaces: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>>;
7
+ }, z.core.$strict>;
8
+ export type PluginBimContextArgs = z.infer<typeof PluginBimContextArgs>;
9
+ /** Directed graph edge. Side A lies along world-up × curve-direction; side B is opposite.
10
+ * Region IDs are snapshot identifiers, not component handles. Null means no adjacent region.
11
+ */
12
+ export declare const PluginBimEdge: z.ZodObject<{
13
+ id: z.ZodString;
14
+ startNodeId: z.ZodNullable<z.ZodString>;
15
+ endNodeId: z.ZodNullable<z.ZodString>;
16
+ startMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
17
+ endMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
18
+ lengthMm: z.ZodNumber;
19
+ heightMm: z.ZodNumber;
20
+ sideA: z.ZodNullable<z.ZodString>;
21
+ sideB: z.ZodNullable<z.ZodString>;
22
+ wall: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
23
+ supported: z.ZodBoolean;
24
+ }, z.core.$strip>;
25
+ export type PluginBimEdge = z.infer<typeof PluginBimEdge>;
26
+ /** Construction context is detached. Revision covers geometry, room metadata and construction state. */
27
+ export declare const PluginBimContext: z.ZodObject<{
28
+ revision: z.ZodString;
29
+ proposalId: z.ZodString;
30
+ units: z.ZodLiteral<"mm">;
31
+ spaces: z.ZodArray<z.ZodObject<{
32
+ component: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
33
+ label: z.ZodString;
34
+ storey: z.ZodNumber;
35
+ eligible: z.ZodBoolean;
36
+ reason: z.ZodOptional<z.ZodString>;
37
+ }, z.core.$strip>>;
38
+ regions: z.ZodArray<z.ZodObject<{
39
+ id: z.ZodString;
40
+ spaces: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
41
+ }, z.core.$strip>>;
42
+ nodes: z.ZodArray<z.ZodObject<{
43
+ id: z.ZodString;
44
+ positionMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
45
+ }, z.core.$strip>>;
46
+ edges: z.ZodArray<z.ZodObject<{
47
+ id: z.ZodString;
48
+ startNodeId: z.ZodNullable<z.ZodString>;
49
+ endNodeId: z.ZodNullable<z.ZodString>;
50
+ startMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
51
+ endMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
52
+ lengthMm: z.ZodNumber;
53
+ heightMm: z.ZodNumber;
54
+ sideA: z.ZodNullable<z.ZodString>;
55
+ sideB: z.ZodNullable<z.ZodString>;
56
+ wall: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
57
+ supported: z.ZodBoolean;
58
+ }, z.core.$strip>>;
59
+ }, z.core.$strip>;
60
+ export type PluginBimContext = z.infer<typeof PluginBimContext>;
61
+ /** Plan-local key selects either an existing construction or a new project-only native recipe.
62
+ * Bundles use the native DSL's SU/unit-expression rules; values overrides use mm/degrees.
63
+ */
64
+ export declare const PluginBimConstruction: z.ZodUnion<readonly [z.ZodObject<{
65
+ key: z.ZodString;
66
+ reference: z.ZodUnion<readonly [z.ZodObject<{
67
+ id: z.ZodString;
68
+ version: z.ZodNumber;
69
+ }, z.core.$strict>, z.ZodString]>;
70
+ }, z.core.$strict>, z.ZodObject<{
71
+ key: z.ZodString;
72
+ bundle: z.ZodObject<{
73
+ root: z.ZodRecord<z.ZodString, z.ZodUnknown>;
74
+ deps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
75
+ network: z.ZodOptional<z.ZodObject<{
76
+ schemaVersion: z.ZodLiteral<1>;
77
+ role: z.ZodEnum<{
78
+ pipe: "pipe";
79
+ duct: "duct";
80
+ wire: "wire";
81
+ cable: "cable";
82
+ conduit: "conduit";
83
+ cableDuct: "cableDuct";
84
+ cableTray: "cableTray";
85
+ connector: "connector";
86
+ equipment: "equipment";
87
+ }>;
88
+ lengthParameter: z.ZodOptional<z.ZodString>;
89
+ ports: z.ZodArray<z.ZodObject<{
90
+ id: z.ZodString;
91
+ position: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
92
+ direction: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
93
+ size: z.ZodString;
94
+ height: z.ZodOptional<z.ZodString>;
95
+ widthDirection: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
96
+ systems: z.ZodArray<z.ZodString>;
97
+ }, z.core.$strict>>;
98
+ }, z.core.$strict>>;
99
+ }, z.core.$strip>;
100
+ }, z.core.$strict>]>;
101
+ export type PluginBimConstruction = z.infer<typeof PluginBimConstruction>;
102
+ /** Every unwalled edge in the selected scope needs exactly one assignment.
103
+ * The first authored layer faces sideA unless reversed. Alignment sets the initial core-centre offset.
104
+ * Later parameter edits preserve the offset and reject invalid core alignment.
105
+ */
106
+ export declare const PluginBimWallAssignment: z.ZodObject<{
107
+ edgeId: z.ZodString;
108
+ construction: z.ZodString;
109
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
110
+ reversed: z.ZodBoolean;
111
+ alignment: z.ZodLiteral<"coreCentre">;
112
+ }, z.core.$strict>;
113
+ export type PluginBimWallAssignment = z.infer<typeof PluginBimWallAssignment>;
114
+ export declare const PluginBimPrepareArgs: z.ZodObject<{
115
+ revision: z.ZodString;
116
+ spaces: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
117
+ constructions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
118
+ key: z.ZodString;
119
+ reference: z.ZodUnion<readonly [z.ZodObject<{
120
+ id: z.ZodString;
121
+ version: z.ZodNumber;
122
+ }, z.core.$strict>, z.ZodString]>;
123
+ }, z.core.$strict>, z.ZodObject<{
124
+ key: z.ZodString;
125
+ bundle: z.ZodObject<{
126
+ root: z.ZodRecord<z.ZodString, z.ZodUnknown>;
127
+ deps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
128
+ network: z.ZodOptional<z.ZodObject<{
129
+ schemaVersion: z.ZodLiteral<1>;
130
+ role: z.ZodEnum<{
131
+ pipe: "pipe";
132
+ duct: "duct";
133
+ wire: "wire";
134
+ cable: "cable";
135
+ conduit: "conduit";
136
+ cableDuct: "cableDuct";
137
+ cableTray: "cableTray";
138
+ connector: "connector";
139
+ equipment: "equipment";
140
+ }>;
141
+ lengthParameter: z.ZodOptional<z.ZodString>;
142
+ ports: z.ZodArray<z.ZodObject<{
143
+ id: z.ZodString;
144
+ position: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
145
+ direction: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
146
+ size: z.ZodString;
147
+ height: z.ZodOptional<z.ZodString>;
148
+ widthDirection: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
149
+ systems: z.ZodArray<z.ZodString>;
150
+ }, z.core.$strict>>;
151
+ }, z.core.$strict>>;
152
+ }, z.core.$strip>;
153
+ }, z.core.$strict>]>>;
154
+ walls: z.ZodArray<z.ZodObject<{
155
+ edgeId: z.ZodString;
156
+ construction: z.ZodString;
157
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
158
+ reversed: z.ZodBoolean;
159
+ alignment: z.ZodLiteral<"coreCentre">;
160
+ }, z.core.$strict>>;
161
+ }, z.core.$strict>;
162
+ export type PluginBimPrepareArgs = z.infer<typeof PluginBimPrepareArgs>;
163
+ /** Expected recipe/plan failures are diagnostics. No scene or library change occurs during prepare. */
164
+ export declare const PluginBimPreparation: z.ZodObject<{
165
+ ok: z.ZodBoolean;
166
+ preparationId: z.ZodOptional<z.ZodString>;
167
+ diagnostics: z.ZodArray<z.ZodObject<{
168
+ path: z.ZodString;
169
+ message: z.ZodString;
170
+ }, z.core.$strip>>;
171
+ }, z.core.$strip>;
172
+ export type PluginBimPreparation = z.infer<typeof PluginBimPreparation>;
173
+ export declare const PluginBimCreateArgs: z.ZodObject<{
174
+ preparationId: z.ZodString;
175
+ }, z.core.$strict>;
176
+ /** Source IDs identify removed sketch spaces, not live handles. Successful storeys share one undo step.
177
+ * Failed storeys remain spaces. Cancellation rolls back the whole conversion. Persistence is queued
178
+ * through normal model commands; this result is not a durable server-save acknowledgement.
179
+ */
180
+ export declare const PluginBimResult: z.ZodObject<{
181
+ status: z.ZodEnum<{
182
+ created: "created";
183
+ cancelled: "cancelled";
184
+ partial: "partial";
185
+ unchanged: "unchanged";
186
+ }>;
187
+ convertedSpaceIds: z.ZodArray<z.ZodString>;
188
+ created: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
189
+ kept: z.ZodArray<z.ZodObject<{
190
+ space: z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>;
191
+ reason: z.ZodString;
192
+ }, z.core.$strip>>;
193
+ }, z.core.$strip>;
194
+ export type PluginBimResult = z.infer<typeof PluginBimResult>;
195
+ /** Plan-local vertex. Attach to a context node or to a fraction of a directed straight edge.
196
+ * New positions use world mm, Y-up. Attachments resolve on graph axes, not visible wall faces.
197
+ */
198
+ export declare const PluginBimUpdateNode: z.ZodUnion<readonly [z.ZodObject<{
199
+ id: z.ZodString;
200
+ positionMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
201
+ }, z.core.$strict>, z.ZodObject<{
202
+ id: z.ZodString;
203
+ attach: z.ZodObject<{
204
+ nodeId: z.ZodString;
205
+ }, z.core.$strict>;
206
+ }, z.core.$strict>, z.ZodObject<{
207
+ id: z.ZodString;
208
+ attach: z.ZodObject<{
209
+ edgeId: z.ZodString;
210
+ t: z.ZodNumber;
211
+ }, z.core.$strict>;
212
+ }, z.core.$strict>]>;
213
+ export type PluginBimUpdateNode = z.infer<typeof PluginBimUpdateNode>;
214
+ /** Additive partition graph, not replacement or raw PG2 CRUD. Endpoints reference plan-local nodes.
215
+ * Each free node must meet at least two planned walls; an open end requires an explicit attachment.
216
+ * Heights and positions use mm. All recipes, endpoints and revisions resolve before any mutation.
217
+ */
218
+ export declare const PluginBimUpdateGraph: z.ZodObject<{
219
+ revision: z.ZodString;
220
+ proposalId: z.ZodString;
221
+ nodes: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
222
+ id: z.ZodString;
223
+ positionMm: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
224
+ }, z.core.$strict>, z.ZodObject<{
225
+ id: z.ZodString;
226
+ attach: z.ZodObject<{
227
+ nodeId: z.ZodString;
228
+ }, z.core.$strict>;
229
+ }, z.core.$strict>, z.ZodObject<{
230
+ id: z.ZodString;
231
+ attach: z.ZodObject<{
232
+ edgeId: z.ZodString;
233
+ t: z.ZodNumber;
234
+ }, z.core.$strict>;
235
+ }, z.core.$strict>]>>;
236
+ walls: z.ZodArray<z.ZodObject<{
237
+ id: z.ZodString;
238
+ start: z.ZodString;
239
+ end: z.ZodString;
240
+ family: z.ZodUnion<readonly [z.ZodObject<{
241
+ id: z.ZodString;
242
+ version: z.ZodNumber;
243
+ }, z.core.$strict>, z.ZodString]>;
244
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
245
+ heightMm: z.ZodNumber;
246
+ reversed: z.ZodBoolean;
247
+ alignment: z.ZodLiteral<"coreCentre">;
248
+ }, z.core.$strict>>;
249
+ }, z.core.$strict>;
250
+ export type PluginBimUpdateGraph = z.infer<typeof PluginBimUpdateGraph>;
251
+ /** One native transaction. Regions are the final active-proposal regions, not predicted contours.
252
+ * Commands queue persistence; success is not a durable server-save acknowledgement.
253
+ */
254
+ export declare const PluginBimUpdateResult: z.ZodObject<{
255
+ created: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
256
+ updated: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
257
+ removed: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
258
+ walls: z.ZodArray<z.ZodObject<{
259
+ id: z.ZodString;
260
+ components: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
261
+ }, z.core.$strip>>;
262
+ regions: z.ZodArray<z.ZodObject<{
263
+ id: z.ZodString;
264
+ floor: z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
265
+ }, z.core.$strip>>;
266
+ }, z.core.$strip>;
267
+ export type PluginBimUpdateResult = z.infer<typeof PluginBimUpdateResult>;
268
+ /** Agent-driven BIM construction and partition updates through native PG2 topology. */
269
+ export declare abstract class PluginDesignBimApi {
270
+ /** Read room adjacency and native conversion eligibility in the active proposal.
271
+ * @param options Optional explicit spaces; filters edges but keeps adjacent room metadata.
272
+ * @returns Rooms, directed boundaries in mm, eligibility and revision.
273
+ * @examplePrompt Inspect the rooms on each side of these sketch wall boundaries
274
+ */
275
+ abstract getContext(options?: PluginBimContextArgs): PluginApiReturn<PluginBimContext>;
276
+ /** Stage a complete wall-construction assignment. A new prepare replaces this plugin's prior plan.
277
+ * @param plan Exact context revision, selected spaces, constructions and edge assignments.
278
+ * @returns Diagnostics or an opaque preparation ID, scoped to the caller and current project.
279
+ * @examplePrompt Validate wall layer assignments before converting sketch rooms to BIM
280
+ */
281
+ abstract prepare(plan: PluginBimPrepareArgs): PluginApiReturn<PluginBimPreparation>;
282
+ /** Execute native Sketch-to-BIM. Revalidates scope, catalogue access and construction before mutation.
283
+ * Uses native progress/cancel controls and worker cancellation. Floors/roofs retain project defaults.
284
+ * @param preparationId ID returned by prepare. Consumed once; stale or foreign IDs throw PRECONDITION_FAILED.
285
+ * @returns Created component handles and explicit converted/kept outcomes, including partial success.
286
+ * @examplePrompt Convert these sketch rooms to BIM with wall layers chosen for each room boundary
287
+ */
288
+ abstract create(preparationId: string): PluginApiReturn<PluginBimResult>;
289
+ /** Add a partition graph with explicit connectivity and chosen wall families in one undo step.
290
+ * Validation is part of this call. PG2 splits intersections and generates floors with native lineage.
291
+ * Does not move/delete existing edges, infer face snapping, or change catalogue definitions.
292
+ * @param graphJson JSON-encoded PluginBimUpdateGraph from the latest getContext revision.
293
+ * @returns Created/updated/removed components, wall mappings and resulting regions. Invalid or stale
294
+ * plans throw before mutation; failed construction rolls back. Read context after an unknown result.
295
+ * @examplePrompt Add bathroom partitions attached to these existing graph boundaries
296
+ */
297
+ abstract update(graphJson: string): PluginApiReturn<PluginBimUpdateResult>;
298
+ }
299
+ //# sourceMappingURL=bim.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bim.d.ts","sourceRoot":"","sources":["../../../src/api/design/bim.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAYlD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB;;kBAEtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;iBAYxB,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AAEzD,wGAAwG;AACxG,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgB3B,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBAGhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;kBAQzB,CAAA;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE,uGAAuG;AACvG,eAAO,MAAM,oBAAoB;;;;;;;iBAI/B,CAAA;AACF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AACvE,eAAO,MAAM,mBAAmB;;kBAA2C,CAAA;AAE3E;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;iBAK1B,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;oBAW9B,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAErE;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuBtB,CAAA;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;iBAMhC,CAAA;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE,uFAAuF;AACvF,8BAAsB,kBAAkB;IACtC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CACjB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,eAAe,CAAC,gBAAgB,CAAC;IAEpC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CACd,IAAI,EAAE,oBAAoB,GACzB,eAAe,CAAC,oBAAoB,CAAC;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAAC,eAAe,CAAC;IAExE;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CAAC,qBAAqB,CAAC;CAC3E"}
@@ -53,6 +53,8 @@ export declare abstract class PluginDesignBooleanApi {
53
53
  * boolean (CSG) subtraction that carves the tools' volume out of the target and
54
54
  * commits the remainder as a single undoable step.
55
55
  *
56
+ * Masses only. Slabs, floors and roofs take holes through `design.create.void`.
57
+ *
56
58
  * ORDER-SENSITIVE: the host seeds `[target, ...tools]`; index 0 is the arg brep,
57
59
  * the rest are tool breps. `deleted` includes the target AND every tool;
58
60
  * `created` is the remainder mass(es).
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/boolean/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAc,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,sBAAsB;;IAG1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,KAAK,CACnB,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,cAAc,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;aACa,QAAQ,CACtB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,eAAe,EAAE,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,cAAc,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;aACa,SAAS,CACvB,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,cAAc,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;iBAEzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B;;;;;iBAGvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;;;;iBAI1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC;;;;;iBAG3C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/api/design/boolean/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAc,MAAM,kBAAkB,CAAA;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE1C;;;;;;;;;;;;;;;;;;GAkBG;AACH,8BAAsB,sBAAsB;;IAG1C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,KAAK,CACnB,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,cAAc,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;aACa,QAAQ,CACtB,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,eAAe,EAAE,EACxB,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,cAAc,CAAC;IAElC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;aACa,SAAS,CACvB,UAAU,EAAE,eAAe,EAAE,EAC7B,OAAO,CAAC,EAAE,cAAc,GACvB,eAAe,CAAC,cAAc,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;;iBAEzB,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA;AAE3D;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B;;;;;iBAGvC,CAAA;AACF,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAA;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B;;;;;;iBAI1C,CAAA;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAA;AAE7F;;;;;;;GAOG;AACH,eAAO,MAAM,gCAAgC;;;;;iBAG3C,CAAA;AACF,MAAM,MAAM,gCAAgC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAA"}
@@ -0,0 +1,320 @@
1
+ import * as z from "zod";
2
+ import type { PluginApiReturn } from "../../types";
3
+ /** Exact saved family identity. A label or a selected Draw type is not an identity. */
4
+ export declare const PluginSavedFamilyReference: z.ZodObject<{
5
+ id: z.ZodString;
6
+ version: z.ZodNumber;
7
+ }, z.core.$strict>;
8
+ export type PluginSavedFamilyReference = z.infer<typeof PluginSavedFamilyReference>;
9
+ /** Public overrides: physical lengths use mm, angles use degrees. Omitted values retain defaults. */
10
+ export declare const PluginFamilyValues: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>;
11
+ export type PluginFamilyValues = z.infer<typeof PluginFamilyValues>;
12
+ /** Native construction uses a saved family or a project assembly token from the catalogue. */
13
+ export declare const PluginConstructionType: z.ZodUnion<readonly [z.ZodObject<{
14
+ id: z.ZodString;
15
+ version: z.ZodNumber;
16
+ }, z.core.$strict>, z.ZodString]>;
17
+ export type PluginConstructionType = z.infer<typeof PluginConstructionType>;
18
+ /** Family owns its layers/section. Geometry owns the footprint/axis; it is never a values override. */
19
+ export declare const PluginFamilyPlacement: z.ZodObject<{
20
+ type: z.ZodUnion<readonly [z.ZodObject<{
21
+ id: z.ZodString;
22
+ version: z.ZodNumber;
23
+ }, z.core.$strict>, z.ZodString]>;
24
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
25
+ }, z.core.$strict>;
26
+ export type PluginFamilyPlacement = z.infer<typeof PluginFamilyPlacement>;
27
+ /** Sparse native family edit. Omitted type keeps the component's exact saved reference. */
28
+ export declare const PluginFamilyUpdates: z.ZodObject<{
29
+ type: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
30
+ id: z.ZodString;
31
+ version: z.ZodNumber;
32
+ }, z.core.$strict>, z.ZodString]>>;
33
+ values: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>>;
34
+ }, z.core.$strict>;
35
+ export type PluginFamilyUpdates = z.infer<typeof PluginFamilyUpdates>;
36
+ export declare const PluginFamilyFloorOptions: z.ZodObject<{
37
+ type: z.ZodUnion<readonly [z.ZodObject<{
38
+ id: z.ZodString;
39
+ version: z.ZodNumber;
40
+ }, z.core.$strict>, z.ZodString]>;
41
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
42
+ position: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../..").Handle<"vec3">, string>>>;
43
+ }, z.core.$strict>;
44
+ export type PluginFamilyFloorOptions = z.infer<typeof PluginFamilyFloorOptions>;
45
+ export declare const PluginFamilySlabOptions: z.ZodObject<{
46
+ type: z.ZodUnion<readonly [z.ZodObject<{
47
+ id: z.ZodString;
48
+ version: z.ZodNumber;
49
+ }, z.core.$strict>, z.ZodString]>;
50
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
51
+ direction: z.ZodOptional<z.ZodEnum<{
52
+ up: "up";
53
+ down: "down";
54
+ }>>;
55
+ }, z.core.$strict>;
56
+ export type PluginFamilySlabOptions = z.infer<typeof PluginFamilySlabOptions>;
57
+ export declare const PluginFamilyCeilingOptions: z.ZodObject<{
58
+ type: z.ZodUnion<readonly [z.ZodObject<{
59
+ id: z.ZodString;
60
+ version: z.ZodNumber;
61
+ }, z.core.$strict>, z.ZodString]>;
62
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
63
+ heightFromFloor: z.ZodOptional<z.ZodNumber>;
64
+ }, z.core.$strict>;
65
+ export type PluginFamilyCeilingOptions = z.infer<typeof PluginFamilyCeilingOptions>;
66
+ export declare const PluginFamilyContourArgs: z.ZodObject<{
67
+ contour: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../..").Handle<"contour">, string>>;
68
+ options: z.ZodObject<{
69
+ type: z.ZodUnion<readonly [z.ZodObject<{
70
+ id: z.ZodString;
71
+ version: z.ZodNumber;
72
+ }, z.core.$strict>, z.ZodString]>;
73
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
74
+ }, z.core.$strict>;
75
+ }, z.core.$strip>;
76
+ export declare const PluginFamilyAxisArgs: z.ZodObject<{
77
+ axis: z.ZodPipe<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodString>, z.ZodTransform<import("../..").Handle<"line">, string>>;
78
+ options: z.ZodObject<{
79
+ type: z.ZodUnion<readonly [z.ZodObject<{
80
+ id: z.ZodString;
81
+ version: z.ZodNumber;
82
+ }, z.core.$strict>, z.ZodString]>;
83
+ values: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodNumber, z.ZodString, z.ZodBoolean]>>>;
84
+ }, z.core.$strict>;
85
+ }, z.core.$strip>;
86
+ /** Inventory includes architectural recipes, ordinary PCs, and the existing placement libraries. */
87
+ export declare const PluginCatalogKind: z.ZodEnum<{
88
+ component: "component";
89
+ floor: "floor";
90
+ wall: "wall";
91
+ ceiling: "ceiling";
92
+ slab: "slab";
93
+ roof: "roof";
94
+ furniture: "furniture";
95
+ door: "door";
96
+ window: "window";
97
+ beam: "beam";
98
+ column: "column";
99
+ }>;
100
+ export type PluginCatalogKind = z.infer<typeof PluginCatalogKind>;
101
+ export declare const PluginCatalogReference: z.ZodUnion<readonly [z.ZodObject<{
102
+ id: z.ZodString;
103
+ version: z.ZodNumber;
104
+ }, z.core.$strict>, z.ZodString]>;
105
+ export type PluginCatalogReference = z.infer<typeof PluginCatalogReference>;
106
+ /** Read-only capability record. Availability is checked again on every mutation. */
107
+ export declare const PluginCatalogEntry: z.ZodObject<{
108
+ reference: z.ZodUnion<readonly [z.ZodObject<{
109
+ id: z.ZodString;
110
+ version: z.ZodNumber;
111
+ }, z.core.$strict>, z.ZodString]>;
112
+ label: z.ZodString;
113
+ kind: z.ZodEnum<{
114
+ component: "component";
115
+ floor: "floor";
116
+ wall: "wall";
117
+ ceiling: "ceiling";
118
+ slab: "slab";
119
+ roof: "roof";
120
+ furniture: "furniture";
121
+ door: "door";
122
+ window: "window";
123
+ beam: "beam";
124
+ column: "column";
125
+ }>;
126
+ source: z.ZodEnum<{
127
+ native: "native";
128
+ revit: "revit";
129
+ project: "project";
130
+ asset: "asset";
131
+ }>;
132
+ createMethods: z.ZodArray<z.ZodString>;
133
+ updateMethods: z.ZodArray<z.ZodString>;
134
+ requirements: z.ZodArray<z.ZodString>;
135
+ unsupportedReason: z.ZodOptional<z.ZodString>;
136
+ parameters: z.ZodOptional<z.ZodArray<z.ZodObject<{
137
+ key: z.ZodString;
138
+ label: z.ZodString;
139
+ type: z.ZodEnum<{
140
+ boolean: "boolean";
141
+ enum: "enum";
142
+ length: "length";
143
+ text: "text";
144
+ integer: "integer";
145
+ }>;
146
+ unit: z.ZodOptional<z.ZodEnum<{
147
+ mm: "mm";
148
+ degrees: "degrees";
149
+ }>>;
150
+ default: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
151
+ min: z.ZodOptional<z.ZodNumber>;
152
+ max: z.ZodOptional<z.ZodNumber>;
153
+ options: z.ZodOptional<z.ZodArray<z.ZodString>>;
154
+ drivesGeometry: z.ZodBoolean;
155
+ readOnly: z.ZodBoolean;
156
+ formulaDriven: z.ZodBoolean;
157
+ isInstance: z.ZodBoolean;
158
+ }, z.core.$strip>>>;
159
+ geometryParameters: z.ZodArray<z.ZodString>;
160
+ network: z.ZodOptional<z.ZodObject<{
161
+ schemaVersion: z.ZodLiteral<1>;
162
+ role: z.ZodEnum<{
163
+ pipe: "pipe";
164
+ duct: "duct";
165
+ wire: "wire";
166
+ cable: "cable";
167
+ conduit: "conduit";
168
+ cableDuct: "cableDuct";
169
+ cableTray: "cableTray";
170
+ connector: "connector";
171
+ equipment: "equipment";
172
+ }>;
173
+ lengthParameter: z.ZodOptional<z.ZodString>;
174
+ ports: z.ZodArray<z.ZodObject<{
175
+ id: z.ZodString;
176
+ position: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
177
+ direction: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
178
+ size: z.ZodString;
179
+ height: z.ZodOptional<z.ZodString>;
180
+ widthDirection: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
181
+ systems: z.ZodArray<z.ZodString>;
182
+ }, z.core.$strict>>;
183
+ }, z.core.$strict>>;
184
+ construction: z.ZodOptional<z.ZodObject<{
185
+ root: z.ZodRecord<z.ZodString, z.ZodUnknown>;
186
+ deps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
187
+ network: z.ZodOptional<z.ZodObject<{
188
+ schemaVersion: z.ZodLiteral<1>;
189
+ role: z.ZodEnum<{
190
+ pipe: "pipe";
191
+ duct: "duct";
192
+ wire: "wire";
193
+ cable: "cable";
194
+ conduit: "conduit";
195
+ cableDuct: "cableDuct";
196
+ cableTray: "cableTray";
197
+ connector: "connector";
198
+ equipment: "equipment";
199
+ }>;
200
+ lengthParameter: z.ZodOptional<z.ZodString>;
201
+ ports: z.ZodArray<z.ZodObject<{
202
+ id: z.ZodString;
203
+ position: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
204
+ direction: z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>;
205
+ size: z.ZodString;
206
+ height: z.ZodOptional<z.ZodString>;
207
+ widthDirection: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString, z.ZodString], null>>;
208
+ systems: z.ZodArray<z.ZodString>;
209
+ }, z.core.$strict>>;
210
+ }, z.core.$strict>>;
211
+ }, z.core.$strip>>;
212
+ }, z.core.$strip>;
213
+ export type PluginCatalogEntry = z.infer<typeof PluginCatalogEntry>;
214
+ export declare const PluginCatalogListArgs: z.ZodObject<{
215
+ kind: z.ZodOptional<z.ZodEnum<{
216
+ component: "component";
217
+ floor: "floor";
218
+ wall: "wall";
219
+ ceiling: "ceiling";
220
+ slab: "slab";
221
+ roof: "roof";
222
+ furniture: "furniture";
223
+ door: "door";
224
+ window: "window";
225
+ beam: "beam";
226
+ column: "column";
227
+ }>>;
228
+ }, z.core.$strip>;
229
+ export declare const PluginCatalogGetArgs: z.ZodObject<{
230
+ reference: z.ZodUnion<readonly [z.ZodObject<{
231
+ id: z.ZodString;
232
+ version: z.ZodNumber;
233
+ }, z.core.$strict>, z.ZodString]>;
234
+ }, z.core.$strip>;
235
+ /** Search metadata is extensible. A slash separates category path segments. */
236
+ export declare const PluginCatalogSearchArgs: z.ZodObject<{
237
+ query: z.ZodOptional<z.ZodString>;
238
+ category: z.ZodOptional<z.ZodString>;
239
+ limit: z.ZodOptional<z.ZodNumber>;
240
+ cursor: z.ZodOptional<z.ZodString>;
241
+ }, z.core.$strict>;
242
+ export type PluginCatalogSearchArgs = z.infer<typeof PluginCatalogSearchArgs>;
243
+ /** Browse one hierarchy level without enumerating families or fetching recipe bodies. */
244
+ export declare const PluginCatalogListCategoriesArgs: z.ZodObject<{
245
+ parent: z.ZodOptional<z.ZodString>;
246
+ after: z.ZodOptional<z.ZodString>;
247
+ limit: z.ZodOptional<z.ZodNumber>;
248
+ }, z.core.$strict>;
249
+ export type PluginCatalogListCategoriesArgs = z.infer<typeof PluginCatalogListCategoriesArgs>;
250
+ /** Metadata only: the category does not establish placement capabilities or recipe validity. */
251
+ export declare const PluginCatalogCategory: z.ZodObject<{
252
+ categoryPath: z.ZodArray<z.ZodString>;
253
+ hasChildren: z.ZodBoolean;
254
+ }, z.core.$strip>;
255
+ export type PluginCatalogCategory = z.infer<typeof PluginCatalogCategory>;
256
+ /** Metadata only. Read get(reference) to validate a selected family and inspect placement methods. */
257
+ export declare const PluginCatalogSummary: z.ZodObject<{
258
+ reference: z.ZodUnion<readonly [z.ZodObject<{
259
+ id: z.ZodString;
260
+ version: z.ZodNumber;
261
+ }, z.core.$strict>, z.ZodString]>;
262
+ label: z.ZodString;
263
+ categoryPath: z.ZodArray<z.ZodString>;
264
+ description: z.ZodString;
265
+ source: z.ZodEnum<{
266
+ native: "native";
267
+ revit: "revit";
268
+ project: "project";
269
+ asset: "asset";
270
+ }>;
271
+ }, z.core.$strip>;
272
+ export type PluginCatalogSummary = z.infer<typeof PluginCatalogSummary>;
273
+ export declare const PluginCatalogSearchResult: z.ZodObject<{
274
+ items: z.ZodArray<z.ZodObject<{
275
+ reference: z.ZodUnion<readonly [z.ZodObject<{
276
+ id: z.ZodString;
277
+ version: z.ZodNumber;
278
+ }, z.core.$strict>, z.ZodString]>;
279
+ label: z.ZodString;
280
+ categoryPath: z.ZodArray<z.ZodString>;
281
+ description: z.ZodString;
282
+ source: z.ZodEnum<{
283
+ native: "native";
284
+ revit: "revit";
285
+ project: "project";
286
+ asset: "asset";
287
+ }>;
288
+ }, z.core.$strip>>;
289
+ nextCursor: z.ZodNullable<z.ZodString>;
290
+ }, z.core.$strip>;
291
+ export type PluginCatalogSearchResult = z.infer<typeof PluginCatalogSearchResult>;
292
+ /** Shared read surface over existing libraries. Does not publish, register, or place definitions. */
293
+ export declare abstract class PluginDesignCatalogApi {
294
+ /**
295
+ * Discover categories from accessible saved families and current project constructions.
296
+ * Omit parent for roots; pass a slash-separated returned path for its direct children.
297
+ * This metadata read does not fetch recipes, include unsaved drafts or legacy mesh inventories,
298
+ * or establish capabilities. Use search then get before placement. Names retain their case.
299
+ * @param args Parent path, exclusive after-name, and page limit (default 50, maximum 100).
300
+ * For another page at the same parent, pass the last item's final categoryPath segment as after.
301
+ * @returns Categories in Unicode code-point order, with descendant flags. Stop when a page has
302
+ * fewer than limit items. Live pagination is not a snapshot. Metadata-service failures reject.
303
+ */
304
+ abstract listCategories(args?: PluginCatalogListCategoriesArgs): PluginApiReturn<PluginCatalogCategory[]>;
305
+ /**
306
+ * Search accessible saved-family and project-construction metadata without downloading recipes.
307
+ * Categories are data, not an SDK enum. Legacy mesh inventories and unsaved drafts are excluded.
308
+ * Inspect selected references with get before placement; a search match does not prove validity
309
+ * or supported behavior. Pagination reads live data, not a snapshot. Failures reject.
310
+ * @param args Text/category filters, page limit (default 20, maximum 50), and opaque cursor.
311
+ * @returns Compact metadata and continuation. Continue until nextCursor is null or a suitable
312
+ * family is found. Concurrent changes can leave an empty page with continuation.
313
+ */
314
+ abstract search(args?: PluginCatalogSearchArgs): PluginApiReturn<PluginCatalogSearchResult>;
315
+ /** @param kind Optional element filter. @returns Accessible entries and their supported API paths. */
316
+ abstract list(kind?: PluginCatalogKind): PluginApiReturn<PluginCatalogEntry[]>;
317
+ /** @param reference Exact reference from search or list. @returns The current entry, or null when unavailable. */
318
+ abstract get(reference: PluginCatalogReference): PluginApiReturn<PluginCatalogEntry | null>;
319
+ }
320
+ //# sourceMappingURL=catalog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/api/design/catalog.ts"],"names":[],"mappings":"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"}