@iwsdk/vite-plugin-dev 0.4.1 → 0.5.0

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.
package/README.md CHANGED
@@ -8,6 +8,7 @@ Vite plugin for IWSDK development — XR emulation, AI agent tooling, and Playwr
8
8
  - 🏠 **Synthetic Environments** — Optional room-scale environments for AR testing
9
9
  - 🤖 **AI Agent Tooling** — MCP-based tools for Claude Code, Cursor, Copilot, and Codex
10
10
  - 🖥️ **Managed Browser** — Playwright browser for screenshots and console capture
11
+ - 🔒 **Development HTTPS** — Cached self-signed certificate without modifying the OS trust store
11
12
  - 🔧 **Zero Config** — Works out of the box with sensible defaults
12
13
 
13
14
  ## Installation
@@ -61,18 +62,19 @@ iwsdkDev({
61
62
  // AI agent configuration — omit to disable entirely
62
63
  ai: {
63
64
  // Usage mode:
64
- // 'agent' - headless Playwright, fixed viewport, no DevUI (default)
65
- // 'oversight' - visible Playwright, freely resizable, no DevUI
66
- // 'collaborate' - visible Playwright, freely resizable, DevUI on
67
- mode: 'agent',
68
-
69
- // Which AI tools to generate MCP config for
70
- tools: ['claude'], // default
65
+ // 'collaborate' - visible Playwright, freely resizable, DevUI on (default)
66
+ // 'agent' - headless Playwright, fixed viewport, no DevUI
67
+ mode: 'collaborate',
71
68
 
72
69
  // Screenshot size constraint (viewport in agent mode, downscale bound otherwise)
73
70
  screenshotSize: { width: 800, height: 800 }, // default
74
71
  },
75
72
 
73
+ // HTTPS is enabled by default. The managed browser accepts this untrusted
74
+ // local certificate automatically; physical headsets retain their warning.
75
+ // Set `false` for HTTP, or pass generation options such as `domains`.
76
+ https: true,
77
+
76
78
  // Enable verbose logging
77
79
  verbose: false, // default
78
80
  });
@@ -99,7 +101,7 @@ iwsdkDev({
99
101
  });
100
102
  ```
101
103
 
102
- ### AI Agent Mode (default)
104
+ ### AI Agent Mode
103
105
 
104
106
  ```javascript
105
107
  iwsdkDev({
@@ -108,7 +110,7 @@ iwsdkDev({
108
110
  });
109
111
  ```
110
112
 
111
- ### Collaborate Mode (human + agent share session)
113
+ ### Collaborate Mode (default; human + agent share session)
112
114
 
113
115
  ```javascript
114
116
  iwsdkDev({
@@ -117,15 +119,6 @@ iwsdkDev({
117
119
  });
118
120
  ```
119
121
 
120
- ### Oversight Mode (watch the agent)
121
-
122
- ```javascript
123
- iwsdkDev({
124
- emulator: { device: 'metaQuest3' },
125
- ai: { mode: 'oversight' },
126
- });
127
- ```
128
-
129
122
  ### AI Disabled
130
123
 
131
124
  ```javascript
package/client.d.ts ADDED
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+
8
+ declare module 'virtual:iwsdk-project' {
9
+ const projectOptions: import('@iwsdk/core').WorldOptions;
10
+ export const manifest: import('@iwsdk/core/project').IwsdkProjectManifestV1;
11
+ export default projectOptions;
12
+ }
@@ -0,0 +1,365 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ export declare function getEditorSessionModuleImport(): string;
8
+ export declare function getEditorWorkspaceModuleImport(): string;
9
+ export declare function getCoreModuleImport(): string;
10
+ export declare function getSceneCompositionModuleImport(): string;
11
+ export declare function getOrbitControlsModuleImport(): string;
12
+ export declare function getTransformControlsModuleImport(): string;
13
+ export declare function getViewportGizmoModuleImport(): string;
14
+ export declare function createEditorRuntimeModuleSource(editorSessionImport: string, coreImport: string, assetManifestImport?: string, componentManifestImport?: string, orbitControlsImport?: string, transformControlsImport?: string, viewportGizmoImport?: string, lucideIconNodes?: {
15
+ Box: (string | {
16
+ fill: string;
17
+ height: number;
18
+ stroke: string;
19
+ 'stroke-linecap': string;
20
+ 'stroke-linejoin': string;
21
+ 'stroke-width': number;
22
+ viewBox: string;
23
+ width: number;
24
+ xmlns: string;
25
+ } | (string | {
26
+ d: string;
27
+ })[][])[];
28
+ CheckCheck: (string | {
29
+ fill: string;
30
+ height: number;
31
+ stroke: string;
32
+ 'stroke-linecap': string;
33
+ 'stroke-linejoin': string;
34
+ 'stroke-width': number;
35
+ viewBox: string;
36
+ width: number;
37
+ xmlns: string;
38
+ } | (string | {
39
+ d: string;
40
+ })[][])[];
41
+ Boxes: (string | {
42
+ fill: string;
43
+ height: number;
44
+ stroke: string;
45
+ 'stroke-linecap': string;
46
+ 'stroke-linejoin': string;
47
+ 'stroke-width': number;
48
+ viewBox: string;
49
+ width: number;
50
+ xmlns: string;
51
+ } | (string | {
52
+ d: string;
53
+ })[][])[];
54
+ Check: (string | {
55
+ fill: string;
56
+ height: number;
57
+ stroke: string;
58
+ 'stroke-linecap': string;
59
+ 'stroke-linejoin': string;
60
+ 'stroke-width': number;
61
+ viewBox: string;
62
+ width: number;
63
+ xmlns: string;
64
+ } | (string | {
65
+ d: string;
66
+ })[][])[];
67
+ ChevronDown: (string | {
68
+ fill: string;
69
+ height: number;
70
+ stroke: string;
71
+ 'stroke-linecap': string;
72
+ 'stroke-linejoin': string;
73
+ 'stroke-width': number;
74
+ viewBox: string;
75
+ width: number;
76
+ xmlns: string;
77
+ } | (string | {
78
+ d: string;
79
+ })[][])[];
80
+ ChevronRight: (string | {
81
+ fill: string;
82
+ height: number;
83
+ stroke: string;
84
+ 'stroke-linecap': string;
85
+ 'stroke-linejoin': string;
86
+ 'stroke-width': number;
87
+ viewBox: string;
88
+ width: number;
89
+ xmlns: string;
90
+ } | (string | {
91
+ d: string;
92
+ })[][])[];
93
+ Eye: (string | {
94
+ fill: string;
95
+ height: number;
96
+ stroke: string;
97
+ 'stroke-linecap': string;
98
+ 'stroke-linejoin': string;
99
+ 'stroke-width': number;
100
+ viewBox: string;
101
+ width: number;
102
+ xmlns: string;
103
+ } | ((string | {
104
+ d: string;
105
+ })[] | (string | {
106
+ cx: string;
107
+ cy: string;
108
+ r: string;
109
+ })[])[])[];
110
+ EyeOff: (string | {
111
+ fill: string;
112
+ height: number;
113
+ stroke: string;
114
+ 'stroke-linecap': string;
115
+ 'stroke-linejoin': string;
116
+ 'stroke-width': number;
117
+ viewBox: string;
118
+ width: number;
119
+ xmlns: string;
120
+ } | (string | {
121
+ d: string;
122
+ })[][])[];
123
+ Focus: (string | {
124
+ fill: string;
125
+ height: number;
126
+ stroke: string;
127
+ 'stroke-linecap': string;
128
+ 'stroke-linejoin': string;
129
+ 'stroke-width': number;
130
+ viewBox: string;
131
+ width: number;
132
+ xmlns: string;
133
+ } | ((string | {
134
+ cx: string;
135
+ cy: string;
136
+ r: string;
137
+ })[] | (string | {
138
+ d: string;
139
+ })[])[])[];
140
+ Lock: (string | {
141
+ fill: string;
142
+ height: number;
143
+ stroke: string;
144
+ 'stroke-linecap': string;
145
+ 'stroke-linejoin': string;
146
+ 'stroke-width': number;
147
+ viewBox: string;
148
+ width: number;
149
+ xmlns: string;
150
+ } | ((string | {
151
+ width: string;
152
+ height: string;
153
+ x: string;
154
+ y: string;
155
+ rx: string;
156
+ ry: string;
157
+ })[] | (string | {
158
+ d: string;
159
+ })[])[])[];
160
+ Unlock: (string | {
161
+ fill: string;
162
+ height: number;
163
+ stroke: string;
164
+ 'stroke-linecap': string;
165
+ 'stroke-linejoin': string;
166
+ 'stroke-width': number;
167
+ viewBox: string;
168
+ width: number;
169
+ xmlns: string;
170
+ } | ((string | {
171
+ width: string;
172
+ height: string;
173
+ x: string;
174
+ y: string;
175
+ rx: string;
176
+ ry: string;
177
+ })[] | (string | {
178
+ d: string;
179
+ })[])[])[];
180
+ Globe2: (string | {
181
+ fill: string;
182
+ height: number;
183
+ stroke: string;
184
+ 'stroke-linecap': string;
185
+ 'stroke-linejoin': string;
186
+ 'stroke-width': number;
187
+ viewBox: string;
188
+ width: number;
189
+ xmlns: string;
190
+ } | ((string | {
191
+ d: string;
192
+ })[] | (string | {
193
+ cx: string;
194
+ cy: string;
195
+ r: string;
196
+ })[])[])[];
197
+ Magnet: (string | {
198
+ fill: string;
199
+ height: number;
200
+ stroke: string;
201
+ 'stroke-linecap': string;
202
+ 'stroke-linejoin': string;
203
+ 'stroke-width': number;
204
+ viewBox: string;
205
+ width: number;
206
+ xmlns: string;
207
+ } | (string | {
208
+ d: string;
209
+ })[][])[];
210
+ Move3D: (string | {
211
+ fill: string;
212
+ height: number;
213
+ stroke: string;
214
+ 'stroke-linecap': string;
215
+ 'stroke-linejoin': string;
216
+ 'stroke-width': number;
217
+ viewBox: string;
218
+ width: number;
219
+ xmlns: string;
220
+ } | (string | {
221
+ d: string;
222
+ })[][])[];
223
+ Pencil: (string | {
224
+ fill: string;
225
+ height: number;
226
+ stroke: string;
227
+ 'stroke-linecap': string;
228
+ 'stroke-linejoin': string;
229
+ 'stroke-width': number;
230
+ viewBox: string;
231
+ width: number;
232
+ xmlns: string;
233
+ } | (string | {
234
+ d: string;
235
+ })[][])[];
236
+ Plus: (string | {
237
+ fill: string;
238
+ height: number;
239
+ stroke: string;
240
+ 'stroke-linecap': string;
241
+ 'stroke-linejoin': string;
242
+ 'stroke-width': number;
243
+ viewBox: string;
244
+ width: number;
245
+ xmlns: string;
246
+ } | (string | {
247
+ d: string;
248
+ })[][])[];
249
+ X: (string | {
250
+ fill: string;
251
+ height: number;
252
+ stroke: string;
253
+ 'stroke-linecap': string;
254
+ 'stroke-linejoin': string;
255
+ 'stroke-width': number;
256
+ viewBox: string;
257
+ width: number;
258
+ xmlns: string;
259
+ } | (string | {
260
+ d: string;
261
+ })[][])[];
262
+ Redo2: (string | {
263
+ fill: string;
264
+ height: number;
265
+ stroke: string;
266
+ 'stroke-linecap': string;
267
+ 'stroke-linejoin': string;
268
+ 'stroke-width': number;
269
+ viewBox: string;
270
+ width: number;
271
+ xmlns: string;
272
+ } | (string | {
273
+ d: string;
274
+ })[][])[];
275
+ RefreshCcw: (string | {
276
+ fill: string;
277
+ height: number;
278
+ stroke: string;
279
+ 'stroke-linecap': string;
280
+ 'stroke-linejoin': string;
281
+ 'stroke-width': number;
282
+ viewBox: string;
283
+ width: number;
284
+ xmlns: string;
285
+ } | (string | {
286
+ d: string;
287
+ })[][])[];
288
+ RotateCcw: (string | {
289
+ fill: string;
290
+ height: number;
291
+ stroke: string;
292
+ 'stroke-linecap': string;
293
+ 'stroke-linejoin': string;
294
+ 'stroke-width': number;
295
+ viewBox: string;
296
+ width: number;
297
+ xmlns: string;
298
+ } | (string | {
299
+ d: string;
300
+ })[][])[];
301
+ Rotate3D: (string | {
302
+ fill: string;
303
+ height: number;
304
+ stroke: string;
305
+ 'stroke-linecap': string;
306
+ 'stroke-linejoin': string;
307
+ 'stroke-width': number;
308
+ viewBox: string;
309
+ width: number;
310
+ xmlns: string;
311
+ } | (string | {
312
+ d: string;
313
+ })[][])[];
314
+ Save: (string | {
315
+ fill: string;
316
+ height: number;
317
+ stroke: string;
318
+ 'stroke-linecap': string;
319
+ 'stroke-linejoin': string;
320
+ 'stroke-width': number;
321
+ viewBox: string;
322
+ width: number;
323
+ xmlns: string;
324
+ } | (string | {
325
+ d: string;
326
+ })[][])[];
327
+ Scale3D: (string | {
328
+ fill: string;
329
+ height: number;
330
+ stroke: string;
331
+ 'stroke-linecap': string;
332
+ 'stroke-linejoin': string;
333
+ 'stroke-width': number;
334
+ viewBox: string;
335
+ width: number;
336
+ xmlns: string;
337
+ } | ((string | {
338
+ d: string;
339
+ })[] | (string | {
340
+ cx: string;
341
+ cy: string;
342
+ r: string;
343
+ })[])[])[];
344
+ Undo2: (string | {
345
+ fill: string;
346
+ height: number;
347
+ stroke: string;
348
+ 'stroke-linecap': string;
349
+ 'stroke-linejoin': string;
350
+ 'stroke-width': number;
351
+ viewBox: string;
352
+ width: number;
353
+ xmlns: string;
354
+ } | (string | {
355
+ d: string;
356
+ })[][])[];
357
+ }, sceneCompositionImport?: string, editorWorkspaceImport?: string): string;
358
+ export declare function createEditorShellHtml(injectionVirtualId: string, editorRuntimeVirtualId: string, editorStylesheetVirtualId: string, documentUrl: string, options?: {
359
+ projectFilesUrl?: string;
360
+ publishUrl?: string;
361
+ reviewCapturesUrl?: string;
362
+ reviewsUrl?: string;
363
+ runtimePreflightUrl?: string;
364
+ sceneFilesUrl?: string;
365
+ }): string;
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ export declare const EDITOR_SHELL_CSS: string;
@@ -0,0 +1,67 @@
1
+ /**
2
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
3
+ *
4
+ * This source code is licensed under the MIT license found in the
5
+ * LICENSE file in the root directory of this source tree.
6
+ */
7
+ import { type Signal } from '@preact/signals-core';
8
+ type WorkspaceView = 'runtime' | 'editor';
9
+ export interface EditorWorkspaceSnapshot {
10
+ assetCount: number;
11
+ builtInSelection: string | null;
12
+ dirty: boolean;
13
+ dirtyStatus: string;
14
+ ghostedNodeIds: string[];
15
+ hiddenNodeIds: string[];
16
+ lockedNodeIds: string[];
17
+ loading: boolean;
18
+ loadingProgress: number;
19
+ loadingStatus: string;
20
+ nodeCount: number;
21
+ nodes: any[];
22
+ rootSelected: boolean;
23
+ sceneAssets: any[];
24
+ scenePath: string | null;
25
+ selectedNodeIds: string[];
26
+ soloNodeId: string | null;
27
+ statusStrip: string;
28
+ transformMode: 'translate' | 'rotate' | 'scale';
29
+ transformSnapEnabled: boolean;
30
+ transformSpace: 'local' | 'world';
31
+ view: WorkspaceView;
32
+ }
33
+ export interface EditorWorkspaceController {
34
+ addAsset?(assetId: string): void;
35
+ addEntity?(): void;
36
+ moveNode?(nodeId: string, parentId: string | null, parent?: {
37
+ type: 'player-space';
38
+ target: string;
39
+ }): void;
40
+ openNodeContextMenu?(nodeId: string, point: {
41
+ x: number;
42
+ y: number;
43
+ }): void;
44
+ redo?(): void;
45
+ reloadPage?(): void;
46
+ selectNode?(nodeId: string, modifiers: {
47
+ ctrlKey: boolean;
48
+ metaKey: boolean;
49
+ shiftKey: boolean;
50
+ }): void;
51
+ selectBuiltin?(target: string): void;
52
+ selectRoot?(): void;
53
+ setTransformMode?(mode: 'translate' | 'rotate' | 'scale'): void;
54
+ setTransformSpace?(space: 'local' | 'world'): void;
55
+ setView?(view: WorkspaceView): void;
56
+ toggleNodeExpanded?(nodeId: string): void;
57
+ toggleNodeVisibility?(nodeId: string): void;
58
+ toggleTransformSnap?(): void;
59
+ undo?(): void;
60
+ }
61
+ export interface EditorWorkspaceMount {
62
+ state: Signal<EditorWorkspaceSnapshot>;
63
+ unmount(): void;
64
+ update(patch: Partial<EditorWorkspaceSnapshot>): void;
65
+ }
66
+ export declare function mountEditorWorkspace(root: HTMLElement, controller: EditorWorkspaceController, initial?: Partial<EditorWorkspaceSnapshot>): EditorWorkspaceMount;
67
+ export {};