@vcp-dev/contracts 0.10.11 → 0.10.12

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 (20) hide show
  1. package/dist/colorway-distinctness.js +1 -1
  2. package/dist/connect-dynamic-collection.d.ts +2 -0
  3. package/dist/design-token-block.d.ts +119 -0
  4. package/dist/design-token-block.js +2 -0
  5. package/dist/design-tokens.d.ts +16 -6
  6. package/dist/design-tokens.js +1 -1
  7. package/dist/external-site-edit.d.ts +403 -0
  8. package/dist/globals-css-edit-guard.d.ts +15 -0
  9. package/dist/index.d.ts +64 -48
  10. package/dist/index.js +11 -1
  11. package/dist/launcher-prompt-templates.d.ts +2 -2
  12. package/dist/page-template.d.ts +2 -1
  13. package/dist/site-design-notes.d.ts +49 -0
  14. package/dist/site-edit-command-result.d.ts +2 -0
  15. package/dist/site-edit-version.d.ts +1 -1
  16. package/dist/site-migration-progress.d.ts +78 -0
  17. package/dist/site-permissions.d.ts +43 -0
  18. package/dist/site-workflow.d.ts +6 -0
  19. package/dist/workspace-design-apply.d.ts +47 -1
  20. package/package.json +6 -1
package/dist/external-site-edit.d.ts CHANGED
@@ -73,6 +73,245 @@ export declare const CreateExternalSiteEditRequestSchema: z.ZodObject<{
73
73
  thread_title: z.ZodOptional<z.ZodString>;
74
74
  }, z.core.$strict>;
75
75
  export type CreateExternalSiteEditRequest = z.infer<typeof CreateExternalSiteEditRequestSchema>;
76
+ /**
77
+ * 本次改站影响了哪些页面与区块。设计见
78
+ * docs/superpowers/specs/2026-09-23-external-site-edit-changes-design.md §4。
79
+ *
80
+ * 只描述语义身份，**不带文件路径与代码内容**——`.strict()` 同时防止有人把路径
81
+ * 塞成额外字段带出去。
82
+ */
83
+ export declare const ExternalSiteEditChangeKindSchema: z.ZodEnum<{
84
+ added: "added";
85
+ modified: "modified";
86
+ deleted: "deleted";
87
+ }>;
88
+ export type ExternalSiteEditChangeKind = z.infer<typeof ExternalSiteEditChangeKindSchema>;
89
+ export declare const ExternalSiteEditPageTypeSchema: z.ZodEnum<{
90
+ landing_page: "landing_page";
91
+ general_page: "general_page";
92
+ detail_page: "detail_page";
93
+ }>;
94
+ export type ExternalSiteEditPageType = z.infer<typeof ExternalSiteEditPageTypeSchema>;
95
+ export declare const ExternalSiteEditSiteWideKindSchema: z.ZodEnum<{
96
+ header: "header";
97
+ footer: "footer";
98
+ styles: "styles";
99
+ layout: "layout";
100
+ }>;
101
+ export type ExternalSiteEditSiteWideKind = z.infer<typeof ExternalSiteEditSiteWideKindSchema>;
102
+ export declare const ExternalSiteEditSiteWideChangeSchema: z.ZodObject<{
103
+ kind: z.ZodEnum<{
104
+ header: "header";
105
+ footer: "footer";
106
+ styles: "styles";
107
+ layout: "layout";
108
+ }>;
109
+ change: z.ZodEnum<{
110
+ added: "added";
111
+ modified: "modified";
112
+ deleted: "deleted";
113
+ }>;
114
+ }, z.core.$strict>;
115
+ /** agent 内部接口的输出：只有快照能算出的部分，不含 CMS id 与区块名称。 */
116
+ export declare const SnapshotEditSectionChangeSchema: z.ZodObject<{
117
+ block_id: z.ZodString;
118
+ type: z.ZodString;
119
+ change: z.ZodEnum<{
120
+ added: "added";
121
+ modified: "modified";
122
+ deleted: "deleted";
123
+ }>;
124
+ }, z.core.$strict>;
125
+ export declare const SnapshotEditPageChangeSchema: z.ZodObject<{
126
+ sections: z.ZodArray<z.ZodObject<{
127
+ block_id: z.ZodString;
128
+ type: z.ZodString;
129
+ change: z.ZodEnum<{
130
+ added: "added";
131
+ modified: "modified";
132
+ deleted: "deleted";
133
+ }>;
134
+ }, z.core.$strict>>;
135
+ slug: z.ZodString;
136
+ title: z.ZodString;
137
+ page_type: z.ZodEnum<{
138
+ landing_page: "landing_page";
139
+ general_page: "general_page";
140
+ detail_page: "detail_page";
141
+ }>;
142
+ change: z.ZodEnum<{
143
+ added: "added";
144
+ modified: "modified";
145
+ deleted: "deleted";
146
+ }>;
147
+ }, z.core.$strict>;
148
+ export declare const SnapshotEditChangesSchema: z.ZodObject<{
149
+ site_wide: z.ZodArray<z.ZodObject<{
150
+ kind: z.ZodEnum<{
151
+ header: "header";
152
+ footer: "footer";
153
+ styles: "styles";
154
+ layout: "layout";
155
+ }>;
156
+ change: z.ZodEnum<{
157
+ added: "added";
158
+ modified: "modified";
159
+ deleted: "deleted";
160
+ }>;
161
+ }, z.core.$strict>>;
162
+ unclassified_count: z.ZodNumber;
163
+ pages: z.ZodArray<z.ZodObject<{
164
+ sections: z.ZodArray<z.ZodObject<{
165
+ block_id: z.ZodString;
166
+ type: z.ZodString;
167
+ change: z.ZodEnum<{
168
+ added: "added";
169
+ modified: "modified";
170
+ deleted: "deleted";
171
+ }>;
172
+ }, z.core.$strict>>;
173
+ slug: z.ZodString;
174
+ title: z.ZodString;
175
+ page_type: z.ZodEnum<{
176
+ landing_page: "landing_page";
177
+ general_page: "general_page";
178
+ detail_page: "detail_page";
179
+ }>;
180
+ change: z.ZodEnum<{
181
+ added: "added";
182
+ modified: "modified";
183
+ deleted: "deleted";
184
+ }>;
185
+ }, z.core.$strict>>;
186
+ }, z.core.$strict>;
187
+ export type SnapshotEditChanges = z.infer<typeof SnapshotEditChangesSchema>;
188
+ /** 对外结构：在快照结果上补 CMS 页面 id 与区块名称。 */
189
+ export declare const ExternalSiteEditSectionChangeSchema: z.ZodObject<{
190
+ label: z.ZodString;
191
+ block_id: z.ZodString;
192
+ type: z.ZodString;
193
+ change: z.ZodEnum<{
194
+ added: "added";
195
+ modified: "modified";
196
+ deleted: "deleted";
197
+ }>;
198
+ }, z.core.$strict>;
199
+ export declare const ExternalSiteEditPageChangeSchema: z.ZodObject<{
200
+ sections: z.ZodArray<z.ZodObject<{
201
+ label: z.ZodString;
202
+ block_id: z.ZodString;
203
+ type: z.ZodString;
204
+ change: z.ZodEnum<{
205
+ added: "added";
206
+ modified: "modified";
207
+ deleted: "deleted";
208
+ }>;
209
+ }, z.core.$strict>>;
210
+ slug: z.ZodString;
211
+ title: z.ZodString;
212
+ page_type: z.ZodEnum<{
213
+ landing_page: "landing_page";
214
+ general_page: "general_page";
215
+ detail_page: "detail_page";
216
+ }>;
217
+ change: z.ZodEnum<{
218
+ added: "added";
219
+ modified: "modified";
220
+ deleted: "deleted";
221
+ }>;
222
+ page_id: z.ZodNullable<z.ZodNumber>;
223
+ }, z.core.$strict>;
224
+ export declare const ExternalSiteEditChangesSchema: z.ZodObject<{
225
+ site_wide: z.ZodArray<z.ZodObject<{
226
+ kind: z.ZodEnum<{
227
+ header: "header";
228
+ footer: "footer";
229
+ styles: "styles";
230
+ layout: "layout";
231
+ }>;
232
+ change: z.ZodEnum<{
233
+ added: "added";
234
+ modified: "modified";
235
+ deleted: "deleted";
236
+ }>;
237
+ }, z.core.$strict>>;
238
+ unclassified_count: z.ZodNumber;
239
+ pages: z.ZodArray<z.ZodObject<{
240
+ sections: z.ZodArray<z.ZodObject<{
241
+ label: z.ZodString;
242
+ block_id: z.ZodString;
243
+ type: z.ZodString;
244
+ change: z.ZodEnum<{
245
+ added: "added";
246
+ modified: "modified";
247
+ deleted: "deleted";
248
+ }>;
249
+ }, z.core.$strict>>;
250
+ slug: z.ZodString;
251
+ title: z.ZodString;
252
+ page_type: z.ZodEnum<{
253
+ landing_page: "landing_page";
254
+ general_page: "general_page";
255
+ detail_page: "detail_page";
256
+ }>;
257
+ change: z.ZodEnum<{
258
+ added: "added";
259
+ modified: "modified";
260
+ deleted: "deleted";
261
+ }>;
262
+ page_id: z.ZodNullable<z.ZodNumber>;
263
+ }, z.core.$strict>>;
264
+ }, z.core.$strict>;
265
+ export type ExternalSiteEditChanges = z.infer<typeof ExternalSiteEditChangesSchema>;
266
+ export declare const EMPTY_EXTERNAL_SITE_EDIT_CHANGES: ExternalSiteEditChanges;
267
+ /** api → agent：`POST /v1/agent/workspace/:site_id/edit-changes`。 */
268
+ export declare const ComputeSnapshotEditChangesRequestSchema: z.ZodObject<{
269
+ base_snapshot_id: z.ZodUUID;
270
+ target_snapshot_id: z.ZodUUID;
271
+ }, z.core.$strict>;
272
+ export type ComputeSnapshotEditChangesRequest = z.infer<typeof ComputeSnapshotEditChangesRequestSchema>;
273
+ export declare const ComputeSnapshotEditChangesResponseSchema: z.ZodObject<{
274
+ data: z.ZodObject<{
275
+ site_wide: z.ZodArray<z.ZodObject<{
276
+ kind: z.ZodEnum<{
277
+ header: "header";
278
+ footer: "footer";
279
+ styles: "styles";
280
+ layout: "layout";
281
+ }>;
282
+ change: z.ZodEnum<{
283
+ added: "added";
284
+ modified: "modified";
285
+ deleted: "deleted";
286
+ }>;
287
+ }, z.core.$strict>>;
288
+ unclassified_count: z.ZodNumber;
289
+ pages: z.ZodArray<z.ZodObject<{
290
+ sections: z.ZodArray<z.ZodObject<{
291
+ block_id: z.ZodString;
292
+ type: z.ZodString;
293
+ change: z.ZodEnum<{
294
+ added: "added";
295
+ modified: "modified";
296
+ deleted: "deleted";
297
+ }>;
298
+ }, z.core.$strict>>;
299
+ slug: z.ZodString;
300
+ title: z.ZodString;
301
+ page_type: z.ZodEnum<{
302
+ landing_page: "landing_page";
303
+ general_page: "general_page";
304
+ detail_page: "detail_page";
305
+ }>;
306
+ change: z.ZodEnum<{
307
+ added: "added";
308
+ modified: "modified";
309
+ deleted: "deleted";
310
+ }>;
311
+ }, z.core.$strict>>;
312
+ }, z.core.$strict>;
313
+ }, z.core.$strict>;
314
+ export type ComputeSnapshotEditChangesResponse = z.infer<typeof ComputeSnapshotEditChangesResponseSchema>;
76
315
  /**
77
316
  * 任务描述符。提交接口与查询接口共用。
78
317
  *
@@ -130,6 +369,47 @@ export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
130
369
  created_at: z.ZodString;
131
370
  started_at: z.ZodNullable<z.ZodString>;
132
371
  finished_at: z.ZodNullable<z.ZodString>;
372
+ changes: z.ZodDefault<z.ZodNullable<z.ZodObject<{
373
+ site_wide: z.ZodArray<z.ZodObject<{
374
+ kind: z.ZodEnum<{
375
+ header: "header";
376
+ footer: "footer";
377
+ styles: "styles";
378
+ layout: "layout";
379
+ }>;
380
+ change: z.ZodEnum<{
381
+ added: "added";
382
+ modified: "modified";
383
+ deleted: "deleted";
384
+ }>;
385
+ }, z.core.$strict>>;
386
+ unclassified_count: z.ZodNumber;
387
+ pages: z.ZodArray<z.ZodObject<{
388
+ sections: z.ZodArray<z.ZodObject<{
389
+ label: z.ZodString;
390
+ block_id: z.ZodString;
391
+ type: z.ZodString;
392
+ change: z.ZodEnum<{
393
+ added: "added";
394
+ modified: "modified";
395
+ deleted: "deleted";
396
+ }>;
397
+ }, z.core.$strict>>;
398
+ slug: z.ZodString;
399
+ title: z.ZodString;
400
+ page_type: z.ZodEnum<{
401
+ landing_page: "landing_page";
402
+ general_page: "general_page";
403
+ detail_page: "detail_page";
404
+ }>;
405
+ change: z.ZodEnum<{
406
+ added: "added";
407
+ modified: "modified";
408
+ deleted: "deleted";
409
+ }>;
410
+ page_id: z.ZodNullable<z.ZodNumber>;
411
+ }, z.core.$strict>>;
412
+ }, z.core.$strict>>>;
133
413
  }, z.core.$strict>;
134
414
  export type ExternalSiteEditTask = z.infer<typeof ExternalSiteEditTaskSchema>;
135
415
  export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
@@ -184,6 +464,47 @@ export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
184
464
  created_at: z.ZodString;
185
465
  started_at: z.ZodNullable<z.ZodString>;
186
466
  finished_at: z.ZodNullable<z.ZodString>;
467
+ changes: z.ZodDefault<z.ZodNullable<z.ZodObject<{
468
+ site_wide: z.ZodArray<z.ZodObject<{
469
+ kind: z.ZodEnum<{
470
+ header: "header";
471
+ footer: "footer";
472
+ styles: "styles";
473
+ layout: "layout";
474
+ }>;
475
+ change: z.ZodEnum<{
476
+ added: "added";
477
+ modified: "modified";
478
+ deleted: "deleted";
479
+ }>;
480
+ }, z.core.$strict>>;
481
+ unclassified_count: z.ZodNumber;
482
+ pages: z.ZodArray<z.ZodObject<{
483
+ sections: z.ZodArray<z.ZodObject<{
484
+ label: z.ZodString;
485
+ block_id: z.ZodString;
486
+ type: z.ZodString;
487
+ change: z.ZodEnum<{
488
+ added: "added";
489
+ modified: "modified";
490
+ deleted: "deleted";
491
+ }>;
492
+ }, z.core.$strict>>;
493
+ slug: z.ZodString;
494
+ title: z.ZodString;
495
+ page_type: z.ZodEnum<{
496
+ landing_page: "landing_page";
497
+ general_page: "general_page";
498
+ detail_page: "detail_page";
499
+ }>;
500
+ change: z.ZodEnum<{
501
+ added: "added";
502
+ modified: "modified";
503
+ deleted: "deleted";
504
+ }>;
505
+ page_id: z.ZodNullable<z.ZodNumber>;
506
+ }, z.core.$strict>>;
507
+ }, z.core.$strict>>>;
187
508
  }, z.core.$strict>;
188
509
  }, z.core.$strict>;
189
510
  export type CreateExternalSiteEditResponse = z.infer<typeof CreateExternalSiteEditResponseSchema>;
@@ -239,6 +560,47 @@ export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
239
560
  created_at: z.ZodString;
240
561
  started_at: z.ZodNullable<z.ZodString>;
241
562
  finished_at: z.ZodNullable<z.ZodString>;
563
+ changes: z.ZodDefault<z.ZodNullable<z.ZodObject<{
564
+ site_wide: z.ZodArray<z.ZodObject<{
565
+ kind: z.ZodEnum<{
566
+ header: "header";
567
+ footer: "footer";
568
+ styles: "styles";
569
+ layout: "layout";
570
+ }>;
571
+ change: z.ZodEnum<{
572
+ added: "added";
573
+ modified: "modified";
574
+ deleted: "deleted";
575
+ }>;
576
+ }, z.core.$strict>>;
577
+ unclassified_count: z.ZodNumber;
578
+ pages: z.ZodArray<z.ZodObject<{
579
+ sections: z.ZodArray<z.ZodObject<{
580
+ label: z.ZodString;
581
+ block_id: z.ZodString;
582
+ type: z.ZodString;
583
+ change: z.ZodEnum<{
584
+ added: "added";
585
+ modified: "modified";
586
+ deleted: "deleted";
587
+ }>;
588
+ }, z.core.$strict>>;
589
+ slug: z.ZodString;
590
+ title: z.ZodString;
591
+ page_type: z.ZodEnum<{
592
+ landing_page: "landing_page";
593
+ general_page: "general_page";
594
+ detail_page: "detail_page";
595
+ }>;
596
+ change: z.ZodEnum<{
597
+ added: "added";
598
+ modified: "modified";
599
+ deleted: "deleted";
600
+ }>;
601
+ page_id: z.ZodNullable<z.ZodNumber>;
602
+ }, z.core.$strict>>;
603
+ }, z.core.$strict>>>;
242
604
  }, z.core.$strict>;
243
605
  }, z.core.$strict>;
244
606
  export type GetExternalSiteEditResponse = z.infer<typeof GetExternalSiteEditResponseSchema>;
@@ -281,6 +643,47 @@ export declare const ExternalSiteEditCallbackPayloadSchema: z.ZodObject<{
281
643
  build_verified: z.ZodNullable<z.ZodBoolean>;
282
644
  retryable: z.ZodBoolean;
283
645
  finished_at: z.ZodString;
646
+ changes: z.ZodDefault<z.ZodNullable<z.ZodObject<{
647
+ site_wide: z.ZodArray<z.ZodObject<{
648
+ kind: z.ZodEnum<{
649
+ header: "header";
650
+ footer: "footer";
651
+ styles: "styles";
652
+ layout: "layout";
653
+ }>;
654
+ change: z.ZodEnum<{
655
+ added: "added";
656
+ modified: "modified";
657
+ deleted: "deleted";
658
+ }>;
659
+ }, z.core.$strict>>;
660
+ unclassified_count: z.ZodNumber;
661
+ pages: z.ZodArray<z.ZodObject<{
662
+ sections: z.ZodArray<z.ZodObject<{
663
+ label: z.ZodString;
664
+ block_id: z.ZodString;
665
+ type: z.ZodString;
666
+ change: z.ZodEnum<{
667
+ added: "added";
668
+ modified: "modified";
669
+ deleted: "deleted";
670
+ }>;
671
+ }, z.core.$strict>>;
672
+ slug: z.ZodString;
673
+ title: z.ZodString;
674
+ page_type: z.ZodEnum<{
675
+ landing_page: "landing_page";
676
+ general_page: "general_page";
677
+ detail_page: "detail_page";
678
+ }>;
679
+ change: z.ZodEnum<{
680
+ added: "added";
681
+ modified: "modified";
682
+ deleted: "deleted";
683
+ }>;
684
+ page_id: z.ZodNullable<z.ZodNumber>;
685
+ }, z.core.$strict>>;
686
+ }, z.core.$strict>>>;
284
687
  }, z.core.$strict>;
285
688
  export type ExternalSiteEditCallbackPayload = z.infer<typeof ExternalSiteEditCallbackPayloadSchema>;
286
689
  export declare const ExternalSiteEditCallbackAckSchema: z.ZodObject<{
package/dist/globals-css-edit-guard.d.ts ADDED
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Guardrails run before persisting a user-edited `app/globals.css`. They stop
3
+ * the editor from silently corrupting the machine-readable regions that later
4
+ * stages (materializer rewrite, subsite localization, design panel read) all
5
+ * depend on — the markers must stay paired, no declared token name may
6
+ * disappear, and the file must still be syntactically balanced.
7
+ */
8
+ export type GlobalsCssEditErrorCode = "GLOBALS_CSS_TOKEN_BLOCK_MISSING" | "GLOBALS_CSS_TOKEN_BLOCK_MALFORMED" | "GLOBALS_CSS_TOKEN_REMOVED" | "GLOBALS_CSS_NOTES_UNPAIRED" | "GLOBALS_CSS_UNBALANCED";
9
+ export declare function checkGlobalsCssEdit(previous: string, next: string): {
10
+ ok: true;
11
+ } | {
12
+ ok: false;
13
+ code: GlobalsCssEditErrorCode;
14
+ message: string;
15
+ };