@uniformdev/canvas 20.74.6-alpha.1 → 20.74.7-alpha.3

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/dist/index.d.mts CHANGED
@@ -9,7 +9,7 @@ import { Options } from 'p-throttle';
9
9
  import { LinkAttributesConfiguration, RichTextBuiltInElement as RichTextBuiltInElement$1, RichTextBuiltInFormat as RichTextBuiltInFormat$1, RichTextParamConfiguration as RichTextParamConfiguration$1, ParameterRichTextValue } from '@uniformdev/richtext';
10
10
 
11
11
  interface paths$n {
12
- "/api/v1/canvas-definitions": {
12
+ "/api/v1/categories": {
13
13
  parameters: {
14
14
  query?: never;
15
15
  header?: never;
@@ -19,18 +19,7 @@ interface paths$n {
19
19
  get: {
20
20
  parameters: {
21
21
  query: {
22
- /** @description The project ID to get component definitions for */
23
22
  projectId: string;
24
- /** @description Limit the list to one result by ID (response remains an array) */
25
- componentId?: string;
26
- /** @description Number of records to skip */
27
- offset?: number;
28
- /** @description Maximum number of records to return */
29
- limit?: number;
30
- /** @description Whether to fetch system meta-component definitions (personalize, test, etc.) */
31
- includeSystem?: boolean;
32
- /** @description Filter by category ID */
33
- categories?: string[];
34
23
  };
35
24
  header?: never;
36
25
  path?: never;
@@ -45,8 +34,7 @@ interface paths$n {
45
34
  };
46
35
  content: {
47
36
  "application/json": {
48
- /** @description Component definitions that match the query */
49
- componentDefinitions: components$r["schemas"]["ComponentDefinition"][];
37
+ categories: components$r["schemas"]["Category"][];
50
38
  };
51
39
  };
52
40
  };
@@ -57,7 +45,6 @@ interface paths$n {
57
45
  500: components$r["responses"]["InternalServerError"];
58
46
  };
59
47
  };
60
- /** @description Upserts a component definition */
61
48
  put: {
62
49
  parameters: {
63
50
  query?: never;
@@ -68,12 +55,9 @@ interface paths$n {
68
55
  requestBody: {
69
56
  content: {
70
57
  "application/json": {
71
- /**
72
- * Format: uuid
73
- * @description The project ID to upsert the component definition to
74
- */
58
+ /** Format: uuid */
75
59
  projectId: string;
76
- componentDefinition: components$r["schemas"]["ComponentDefinition"];
60
+ categories: components$r["schemas"]["Category"][];
77
61
  };
78
62
  };
79
63
  };
@@ -93,7 +77,6 @@ interface paths$n {
93
77
  };
94
78
  };
95
79
  post?: never;
96
- /** @description Deletes a component definition */
97
80
  delete: {
98
81
  parameters: {
99
82
  query?: never;
@@ -104,12 +87,9 @@ interface paths$n {
104
87
  requestBody: {
105
88
  content: {
106
89
  "application/json": {
107
- /** @description The public ID of the component definition to delete */
108
- componentId: string;
109
- /**
110
- * Format: uuid
111
- * @description The project ID the component definition to delete belongs to
112
- */
90
+ /** Format: uuid */
91
+ categoryId: string;
92
+ /** Format: uuid */
113
93
  projectId: string;
114
94
  };
115
95
  };
@@ -129,37 +109,90 @@ interface paths$n {
129
109
  500: components$r["responses"]["InternalServerError"];
130
110
  };
131
111
  };
132
- /** @description Handles preflight requests. This endpoint allows CORS */
133
- options: {
134
- parameters: {
135
- query?: never;
136
- header?: never;
137
- path?: never;
138
- cookie?: never;
139
- };
140
- requestBody?: never;
141
- responses: {
142
- /** @description OK */
143
- 204: {
144
- headers: {
145
- [name: string]: unknown;
146
- };
147
- content?: never;
148
- };
149
- };
150
- };
112
+ options?: never;
151
113
  head?: never;
152
114
  patch?: never;
153
115
  trace?: never;
154
116
  };
155
117
  }
156
118
  interface components$r {
119
+ schemas: {
120
+ /** @description Category for tagging canvas entities */
121
+ Category: {
122
+ /**
123
+ * Format: uuid
124
+ * @description Unique identifier for the category
125
+ */
126
+ id: string;
127
+ /** @description Display name of the category */
128
+ name: string;
129
+ /**
130
+ * @description Sets the order of the category when displayed in a list with other categories. If not set, the order defaults to alphabetical with any explicitly set orders first in the list
131
+ * @default 0
132
+ */
133
+ order?: number;
134
+ };
135
+ Error: {
136
+ /** @description Error message(s) that occurred while processing the request */
137
+ errorMessage?: string[] | string;
138
+ };
139
+ };
140
+ responses: {
141
+ /** @description Request input validation failed */
142
+ BadRequestError: {
143
+ headers: {
144
+ [name: string]: unknown;
145
+ };
146
+ content: {
147
+ "application/json": components$r["schemas"]["Error"];
148
+ };
149
+ };
150
+ /** @description API key or token was not valid */
151
+ UnauthorizedError: {
152
+ headers: {
153
+ [name: string]: unknown;
154
+ };
155
+ content: {
156
+ "application/json": components$r["schemas"]["Error"];
157
+ };
158
+ };
159
+ /** @description Permission was denied */
160
+ ForbiddenError: {
161
+ headers: {
162
+ [name: string]: unknown;
163
+ };
164
+ content: {
165
+ "application/json": components$r["schemas"]["Error"];
166
+ };
167
+ };
168
+ /** @description Too many requests in allowed time period */
169
+ RateLimitError: {
170
+ headers: {
171
+ [name: string]: unknown;
172
+ };
173
+ content?: never;
174
+ };
175
+ /** @description Execution error occurred */
176
+ InternalServerError: {
177
+ headers: {
178
+ [name: string]: unknown;
179
+ };
180
+ content?: never;
181
+ };
182
+ };
183
+ parameters: never;
184
+ requestBodies: never;
185
+ headers: never;
186
+ pathItems: never;
187
+ }
188
+
189
+ interface components$q {
157
190
  schemas: {
158
191
  /** @description Public ID (used in code). Do not change after creation */
159
192
  PublicIdProperty: string;
160
193
  /** @description The definition of a component parameter */
161
194
  ComponentDefinitionParameter: {
162
- id: components$r["schemas"]["PublicIdProperty"];
195
+ id: components$q["schemas"]["PublicIdProperty"];
163
196
  /** @description Friendly name of the parameter */
164
197
  name: string;
165
198
  /** @description Appears next to the parameter in the Composition editor */
@@ -191,21 +224,9 @@ interface components$r {
191
224
  /** @description The configuration object for the type (type-specific) */
192
225
  typeConfig?: unknown;
193
226
  };
194
- /** @description Permission set for a component definition */
195
- ComponentDefinitionPermission: {
196
- roleId: components$r["schemas"]["PublicIdProperty"];
197
- /**
198
- * @description Permission type for this permission ComponentDefinition:
199
- * read | write | create | delete
200
- * @enum {string}
201
- */
202
- permission: "read" | "write" | "create" | "delete";
203
- /** @description State of the component that this permission applies to */
204
- state: number;
205
- };
206
227
  /** @description The definition of a named component slot that can contain other components */
207
228
  ComponentDefinitionSlot: {
208
- id: components$r["schemas"]["PublicIdProperty"];
229
+ id: components$q["schemas"]["PublicIdProperty"];
209
230
  /** @description Friendly name of the slot */
210
231
  name: string;
211
232
  /** @description A list of component definition public IDs that are allowed in this named slot */
@@ -258,97 +279,155 @@ interface components$r {
258
279
  */
259
280
  regularExpressionMessage?: string;
260
281
  };
261
- /** @description Defines a connection to a dynamic token on a data resource */
262
- DataElementConnectionDefinition: {
263
- /** @description A JSON Pointer expression that defines the data resource dynamic token value */
264
- pointer: string;
282
+ /** @description The definition of a component variant */
283
+ ComponentDefinitionVariant: {
284
+ id: components$q["schemas"]["PublicIdProperty"];
285
+ /** @description Friendly name of the variant */
286
+ name: string;
287
+ };
288
+ /** @description Permission set for a component definition */
289
+ ComponentDefinitionPermission: {
290
+ roleId: components$q["schemas"]["PublicIdProperty"];
265
291
  /**
266
- * @description The syntax used to select the dynamic token to bind to
292
+ * @description Permission type for this permission ComponentDefinition:
293
+ * read | write | create | delete
267
294
  * @enum {string}
268
295
  */
269
- syntax: "jptr";
296
+ permission: "read" | "write" | "create" | "delete";
297
+ /** @description State of the component that this permission applies to */
298
+ state: number;
299
+ };
300
+ /** @description Defines a component type that can live on a Composition */
301
+ ComponentDefinition: {
302
+ id: components$q["schemas"]["PublicIdProperty"];
303
+ /** @description Friendly name of the component definition */
304
+ name: string;
270
305
  /**
271
- * @description The action to take if the dynamic token cannot be resolved
272
- * - t: TOKEN: Removes the failed dynamic token value, leaving the rest of the property value, if any, intact [default]
273
- * NOTE: If the _only_ value in the property is a dynamic token, the property value is removed (as with 'p' below)
274
- * NOTE: If the _failureDefault_ property is also set, that default value will be used instead of removing the token.
275
- * this only applies when the failureAction is 't' or undefined, the default is otherwise ignored
276
- * - p: PROPERTY: Removes the entire property value, including any other dynamic tokens or static values in the property
277
- * - c: COMPONENT: Removes the whole parent component or block that contains the property.
278
- * NOTE: If a 'component' failure occurs on the root component of a composition, or an entry,
279
- * it is treated as an 'a' failure because removing the root means we must remove all
280
- * - a: ALL: Fails the whole entry or composition. This will result in the item returning a 404 from APIs, and being removed from API list responses
281
- * @enum {string}
306
+ * @description Icon name for the component definition (e.g. 'screen')
307
+ * @default screen
282
308
  */
283
- failureAction?: "t" | "p" | "c" | "a";
309
+ icon?: string;
284
310
  /**
285
- * @description How to report when the dynamic token cannot be resolved
286
- * - e: ERROR: Report an error message (this will prevent publishing)
287
- * - w: WARNING: Report a warning message [default]
288
- * - i: INFO: Log an informative message (failure is expected/normal, i.e. optional data)
289
- * @enum {string}
311
+ * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
312
+ * The parameter type must support being used as a title parameter for this to work
313
+ * @default null
290
314
  */
291
- failureLogLevel?: "e" | "w" | "i";
315
+ titleParameter?: string | null;
292
316
  /**
293
- * @description The default value to use if the dynamic token cannot be resolved.
294
- * This is only used if the failureAction is the default (undefined, or explicitly token)
317
+ * @description The public ID of the parameter whose value should be used as a thumbnail for compositions of this component in the UI
318
+ * @default null
295
319
  */
296
- failureDefault?: string;
297
- };
298
- /**
299
- * @deprecated
300
- * @description beta functionality subject to change
301
- */
302
- VisibilityCriteria: {
303
- /** @description The rule type to execute */
304
- rule: string;
320
+ thumbnailParameter?: string | null;
305
321
  /**
306
- * @description The source value of the rule.
307
- * For rules which have multiple classes of match, for example a dynamic input matches on a named DI, the rule is dynamic input and the DI name is the source.
322
+ * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components
323
+ * @default false
308
324
  */
309
- source?: string;
310
- /** @description The rule-definition-specific operator to test against */
311
- op: string;
312
- /** @description The value, or if an array several potential values, to test against. In most rules, multiple values are OR'd together ('any of') but this is not a hard requirement. */
313
- value: string | string[];
314
- };
315
- /**
316
- * @deprecated
317
- * @description beta functionality subject to change
318
- */
319
- VisibilityCriteriaGroup: {
325
+ canBeComposition?: boolean;
326
+ /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries */
327
+ parameters?: components$q["schemas"]["ComponentDefinitionParameter"][];
320
328
  /**
321
- * @description The boolean operator to join the clauses with. Defaults to & if not specified.
322
- * @enum {string}
329
+ * Format: uuid
330
+ * @description Reference to the category this component definition belongs to
331
+ * @default null
323
332
  */
324
- op?: "&" | "|";
325
- clauses: (components$r["schemas"]["VisibilityCriteria"] | components$r["schemas"]["VisibilityCriteriaGroup"])[];
326
- };
327
- /** @description Defines a conditional value for a component parameter */
328
- ComponentParameterConditionalValue: {
329
- when: components$r["schemas"]["VisibilityCriteriaGroup"];
333
+ categoryId?: string | null;
334
+ /** @description Description of the component definition */
335
+ description?: string;
336
+ /** @description Preview image URL for the component definition (shown in the UI) */
337
+ previewImageUrl?: string;
330
338
  /**
331
- * @description The value of the parameter. Any JSON-serializable value is acceptable.
332
- * A value of `null` will cause the parameter value to be removed, if it matches.
339
+ * @description if this component uses team permissions or custom permissions
340
+ * @default true
333
341
  */
334
- value: unknown;
342
+ useTeamPermissions?: boolean;
343
+ /** @description Custom role permissions for this component definition */
344
+ permissions?: components$q["schemas"]["ComponentDefinitionPermission"][];
345
+ /** @description The named slots for this component; placement areas where arrays of other components can be added */
346
+ slots?: components$q["schemas"]["ComponentDefinitionSlot"][];
347
+ slugSettings?: components$q["schemas"]["ComponentDefinitionSlugSettings"];
348
+ /** @description Default component instance value */
349
+ defaults?: components$q["schemas"]["ComponentInstance"] | null;
350
+ /** @description Named variants for this component; enables the creation of visual variants that use the same parameter data */
351
+ variants?: components$q["schemas"]["ComponentDefinitionVariant"][];
352
+ /** @description Created date string for this definition (ignored for writes) */
353
+ created?: string;
354
+ /** @description Last modified date string for this definition (ignored for writes) */
355
+ updated?: string;
335
356
  /**
336
- * @description Unique sequence identifier of the conditional value within the component parameter.
337
- * This value must be unique within the conditional values array, and it should not change after a condition is created.
357
+ * Format: uuid
358
+ * @description ID of the workflow that instances of this component definition will use by default. When not set, no workflow is attached
338
359
  */
339
- id: number;
360
+ workflowId?: string;
361
+ };
362
+ /** @description Defines a content type */
363
+ ContentType: {
364
+ id: components$q["schemas"]["PublicIdProperty"];
365
+ /** @description Friendly name of the content type */
366
+ name: string;
367
+ /**
368
+ * @description The public ID of the field whose value should be used to create a display name for entries of this content type in the UI.
369
+ * The field type must support being used as an entry name for this to work
370
+ */
371
+ entryName?: string | null;
372
+ /**
373
+ * @description The public ID of the field whose value should be used as a thumbnail for entries of this content type in the UI
374
+ * @default null
375
+ */
376
+ thumbnailField?: string | null;
377
+ /** @description The fields for this content type. Fields are key-value pairs that can be text, numbers, JSON objects, etc. */
378
+ fields?: components$q["schemas"]["ComponentDefinitionParameter"][];
379
+ /** @description Description of the content type */
380
+ description?: string;
381
+ /**
382
+ * @description Icon name for the content type (e.g. 'screen')
383
+ * @default file-document
384
+ */
385
+ icon?: string;
386
+ /** @description Created date string for this content type (ignored for writes) */
387
+ created?: string;
388
+ /** @description Last modified date string for this content type (ignored for writes) */
389
+ updated?: string;
390
+ slugSettings?: components$q["schemas"]["ComponentDefinitionSlugSettings"];
391
+ /**
392
+ * @description The definition type of this content type (block or content type)
393
+ * @default contentType
394
+ * @enum {string}
395
+ */
396
+ type?: "contentType" | "block";
397
+ /**
398
+ * @description if this content type uses team permissions or custom permissions
399
+ * @default true
400
+ */
401
+ useTeamPermissions?: boolean;
402
+ /** @description Custom role permissions for this content type */
403
+ permissions?: components$q["schemas"]["ComponentDefinitionPermission"][];
404
+ /**
405
+ * Format: uuid
406
+ * @description ID of the workflow that instances of this content type will use by default. When not set, no workflow is attached
407
+ */
408
+ workflowId?: string;
409
+ /** @description Configurations for previewing an entry on a consuming pattern or composition. */
410
+ previewConfigurations?: components$q["schemas"]["ContentTypePreviewConfiguration"][];
411
+ };
412
+ /** @description Defines a configuration for previewing an entry on a consuming pattern or composition. */
413
+ ContentTypePreviewConfiguration: {
414
+ /**
415
+ * @description The type of preview configuration
416
+ * @enum {string}
417
+ */
418
+ type: "pattern" | "project-map";
419
+ /** @description Display label for the preview configuration */
420
+ label: string;
421
+ /**
422
+ * Format: uuid
423
+ * @description Target preview entity ID (project map node ID or pattern ID)
424
+ */
425
+ id: string;
426
+ /** @description Optional mapping of dynamic input names to their values */
427
+ dynamicInputs?: {
428
+ [key: string]: string;
429
+ };
340
430
  };
341
- /**
342
- * @description Array of alternate values which are based on conditions.
343
- *
344
- * When requested with an explicit locale parameter, or via the route API:
345
- * * Conditions are evaluated sequentially and the first match is used. If a match is found, the conditions are eliminated.
346
- * * If no conditions match, the `value` property is used.
347
- * * If a condition cannot be evaluated yet (i.e. a client-side criteria), it is left alone.
348
- *
349
- * When no locale is passed to a non-route API, conditions are not processed and all conditions are returned.
350
- */
351
- ComponentParameterConditions: components$r["schemas"]["ComponentParameterConditionalValue"][];
352
431
  /** @description Defines an editable parameter on a component */
353
432
  ComponentParameter: {
354
433
  /** @description The value of the parameter. Any JSON-serializable value is acceptable */
@@ -356,7 +435,7 @@ interface components$r {
356
435
  /** @description The type of the parameter. Determines how it is displayed when editing and tells the consumer how to process it */
357
436
  type: string;
358
437
  /** @deprecated */
359
- connectedData?: components$r["schemas"]["DataElementConnectionDefinition"];
438
+ connectedData?: components$q["schemas"]["DataElementConnectionDefinition"];
360
439
  /**
361
440
  * @description Locale-specific values for this parameter. Keys are locale codes, and values are the `value` in that locale.
362
441
  * Note that locales must be registered on the entry/composition `_locales` before being used
@@ -364,25 +443,116 @@ interface components$r {
364
443
  locales?: {
365
444
  [key: string]: unknown;
366
445
  };
367
- conditions?: components$r["schemas"]["ComponentParameterConditions"];
446
+ conditions?: components$q["schemas"]["ComponentParameterConditions"];
368
447
  /** @description Locale-specific conditional values for this parameter. Keys are locale codes, and values are the `conditions` for that locale. */
369
448
  localesConditions?: {
370
- [key: string]: components$r["schemas"]["ComponentParameterConditions"];
449
+ [key: string]: components$q["schemas"]["ComponentParameterConditions"];
371
450
  };
372
451
  };
452
+ /**
453
+ * @description Array of alternate values which are based on conditions.
454
+ *
455
+ * When requested with an explicit locale parameter, or via the route API:
456
+ * * Conditions are evaluated sequentially and the first match is used. If a match is found, the conditions are eliminated.
457
+ * * If no conditions match, the `value` property is used.
458
+ * * If a condition cannot be evaluated yet (i.e. a client-side criteria), it is left alone.
459
+ *
460
+ * When no locale is passed to a non-route API, conditions are not processed and all conditions are returned.
461
+ */
462
+ ComponentParameterConditions: components$q["schemas"]["ComponentParameterConditionalValue"][];
463
+ /** @description Defines a conditional value for a component parameter */
464
+ ComponentParameterConditionalValue: {
465
+ when: components$q["schemas"]["VisibilityCriteriaGroup"];
466
+ /**
467
+ * @description The value of the parameter. Any JSON-serializable value is acceptable.
468
+ * A value of `null` will cause the parameter value to be removed, if it matches.
469
+ */
470
+ value: unknown;
471
+ /**
472
+ * @description Unique sequence identifier of the conditional value within the component parameter.
473
+ * This value must be unique within the conditional values array, and it should not change after a condition is created.
474
+ */
475
+ id: number;
476
+ };
477
+ /**
478
+ * @deprecated
479
+ * @description beta functionality subject to change
480
+ */
481
+ VisibilityCriteriaGroup: {
482
+ /**
483
+ * @description The boolean operator to join the clauses with. Defaults to & if not specified.
484
+ * @enum {string}
485
+ */
486
+ op?: "&" | "|";
487
+ clauses: (components$q["schemas"]["VisibilityCriteria"] | components$q["schemas"]["VisibilityCriteriaGroup"])[];
488
+ };
489
+ /**
490
+ * @deprecated
491
+ * @description beta functionality subject to change
492
+ */
493
+ VisibilityCriteria: {
494
+ /** @description The rule type to execute */
495
+ rule: string;
496
+ /**
497
+ * @description The source value of the rule.
498
+ * For rules which have multiple classes of match, for example a dynamic input matches on a named DI, the rule is dynamic input and the DI name is the source.
499
+ */
500
+ source?: string;
501
+ /** @description The rule-definition-specific operator to test against */
502
+ op: string;
503
+ /** @description The value, or if an array several potential values, to test against. In most rules, multiple values are OR'd together ('any of') but this is not a hard requirement. */
504
+ value: string | string[];
505
+ };
506
+ /** @description Defines a connection to a dynamic token on a data resource */
507
+ DataElementConnectionDefinition: {
508
+ /** @description A JSON Pointer expression that defines the data resource dynamic token value */
509
+ pointer: string;
510
+ /**
511
+ * @description The syntax used to select the dynamic token to bind to
512
+ * @enum {string}
513
+ */
514
+ syntax: "jptr";
515
+ /**
516
+ * @description The action to take if the dynamic token cannot be resolved
517
+ * - t: TOKEN: Removes the failed dynamic token value, leaving the rest of the property value, if any, intact [default]
518
+ * NOTE: If the _only_ value in the property is a dynamic token, the property value is removed (as with 'p' below)
519
+ * NOTE: If the _failureDefault_ property is also set, that default value will be used instead of removing the token.
520
+ * this only applies when the failureAction is 't' or undefined, the default is otherwise ignored
521
+ * - p: PROPERTY: Removes the entire property value, including any other dynamic tokens or static values in the property
522
+ * - c: COMPONENT: Removes the whole parent component or block that contains the property.
523
+ * NOTE: If a 'component' failure occurs on the root component of a composition, or an entry,
524
+ * it is treated as an 'a' failure because removing the root means we must remove all
525
+ * - a: ALL: Fails the whole entry or composition. This will result in the item returning a 404 from APIs, and being removed from API list responses
526
+ * @enum {string}
527
+ */
528
+ failureAction?: "t" | "p" | "c" | "a";
529
+ /**
530
+ * @description How to report when the dynamic token cannot be resolved
531
+ * - e: ERROR: Report an error message (this will prevent publishing)
532
+ * - w: WARNING: Report a warning message [default]
533
+ * - i: INFO: Log an informative message (failure is expected/normal, i.e. optional data)
534
+ * @enum {string}
535
+ */
536
+ failureLogLevel?: "e" | "w" | "i";
537
+ /**
538
+ * @description The default value to use if the dynamic token cannot be resolved.
539
+ * This is only used if the failureAction is the default (undefined, or explicitly token)
540
+ */
541
+ failureDefault?: string;
542
+ };
373
543
  /** @description Defines the shape of a component instance served by the composition API */
374
544
  ComponentInstance: {
375
545
  /** @description Type of the component instance (public_id of its definition) */
376
546
  type: string;
377
547
  /** @description Component parameter values for the component instance */
378
548
  parameters?: {
379
- [key: string]: components$r["schemas"]["ComponentParameter"];
549
+ [key: string]: components$q["schemas"]["ComponentParameter"];
380
550
  };
381
551
  /** @description Public ID of alternate visual appearance for this component, if any selected */
382
552
  variant?: string;
383
553
  /** @description Slots containing any child components */
384
554
  slots?: {
385
- [key: string]: components$r["schemas"]["ComponentInstance"][];
555
+ [key: string]: components$q["schemas"]["ComponentInstance"][];
386
556
  };
387
557
  /**
388
558
  * @description Unique identifier of the component within the composition.
@@ -393,15 +563,15 @@ interface components$r {
393
563
  _id?: string;
394
564
  /** @description Indicates this component instance should be sourced from a pattern library pattern */
395
565
  _pattern?: string;
396
- _dataResources?: components$r["schemas"]["DataResourceDefinitions"];
566
+ _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
397
567
  /**
398
568
  * @description Data definitions coming from a pattern resolved for this component. Merged with _dataResources during resolution.
399
569
  * Means nothing for PUTs; it will be ignored
400
570
  */
401
571
  _patternDataResources?: {
402
- [key: string]: components$r["schemas"]["DataResourceDefinition"];
572
+ [key: string]: components$q["schemas"]["DataResourceDefinition"];
403
573
  };
404
- _patternError?: components$r["schemas"]["PatternError"];
574
+ _patternError?: components$q["schemas"]["PatternError"];
405
575
  /**
406
576
  * @description Defines patch overrides to component IDs that live in the composition.
407
577
  * This can be used to override parameters that are defined on patterns,
@@ -415,14 +585,14 @@ interface components$r {
415
585
  * Future updates that do not break the overrides-applied state of a composition may be made without notice
416
586
  */
417
587
  _overrides?: {
418
- [key: string]: components$r["schemas"]["ComponentOverride"];
588
+ [key: string]: components$q["schemas"]["ComponentOverride"];
419
589
  };
420
590
  /**
421
591
  * @description Overrides coming from a pattern resolved for this component. Merged with _overrides during resolution.
422
592
  * Means nothing for PUTs; it will be ignored
423
593
  */
424
594
  _patternOverrides?: {
425
- [key: string]: components$r["schemas"]["ComponentOverride"];
595
+ [key: string]: components$q["schemas"]["ComponentOverride"];
426
596
  };
427
597
  /**
428
598
  * @description When used on a pattern, defines how the pattern's parameters may be overridden
@@ -431,79 +601,107 @@ interface components$r {
431
601
  * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
432
602
  * Future updates that do not break the overrides-applied state of a composition may be made without notice
433
603
  */
434
- _overridability?: components$r["schemas"]["ComponentOverridability"];
604
+ _overridability?: components$q["schemas"]["ComponentOverridability"];
435
605
  /** @description Array of locales that have data defined. Only set for pattern references or composition defaults */
436
606
  _locales?: string[];
437
607
  };
438
- /** @description Variable values for a data resource */
439
- DataResourceVariables: {
440
- [key: string]: string;
441
- };
442
- /** @description Defines a data resource, which is a named JSON document, usually from an API response, which may be projected onto parameters */
443
- DataResourceDefinition: {
444
- /** @description Public ID of the data type that provides this data */
608
+ /** @description Defines the shape of the root component in a composition */
609
+ RootComponentInstance: {
610
+ /** @description Type of the component instance (public_id of its definition) */
445
611
  type: string;
446
- /** @description Whether this data is a pattern data resource that can be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false */
447
- isPatternParameter?: boolean;
448
- /**
449
- * @description When true, the default data resource of a pattern data parameter (isPatternParameter=true) will be ignored when the pattern is referenced.
450
- * Unless specifically overridden, the pattern data parameter will be provided with a null default value - leaving any data connections to it unresolvable.
451
- * If isPatternParameter is false or undefined, this has no meaning
452
- */
453
- ignorePatternParameterDefault?: boolean;
454
- /**
455
- * @description When true, the data resource does not create an error forcing the choosing of override value when there is no default.
456
- * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
457
- */
458
- optionalPatternParameter?: boolean;
459
- variables?: components$r["schemas"]["DataResourceVariables"];
460
- };
461
- /**
462
- * @description Data definitions attached to this component. The property name is the key of the data in the data document.
463
- * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key)
464
- */
465
- DataResourceDefinitions: {
466
- [key: string]: components$r["schemas"]["DataResourceDefinition"];
467
- };
468
- /**
469
- * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
470
- * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
471
- * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, en published yet.
472
- * Means nothing for PUTs; it will be ignored
473
- * @enum {string}
474
- */
475
- PatternError: "NOTFOUND" | "CYCLIC";
476
- /**
477
- * @description Defines how to override a specific component.
478
- *
479
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
480
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
481
- */
482
- ComponentOverride: {
612
+ /** @description Component parameter values for the component instance */
483
613
  parameters?: {
484
- [key: string]: components$r["schemas"]["ComponentParameter"];
614
+ [key: string]: components$q["schemas"]["ComponentParameter"];
485
615
  };
616
+ /** @description Public ID of alternate visual appearance for this component, if any selected */
617
+ variant?: string;
618
+ /** @description Project map nodes associated with this component. Must pass withProjectMapNodes parameter to be populated */
619
+ projectMapNodes?: components$q["schemas"]["CompositionProjectMapNodeInfo"][];
620
+ /** @description Slots containing any child components */
486
621
  slots?: {
487
- [key: string]: components$r["schemas"]["ComponentInstance"][];
622
+ [key: string]: components$q["schemas"]["ComponentInstance"][];
488
623
  };
489
- variant?: string;
624
+ /** @description The ID of the composition */
625
+ _id: string;
626
+ /** @description Slug pattern of this component */
627
+ _slug?: string | null;
628
+ /** @description Friendly name of this component */
629
+ _name: string;
630
+ /** @description Name of the author of the most recent change */
631
+ _author?: string;
632
+ /** @description Identity subject of the author of the most recent change */
633
+ _authorSubject?: string;
634
+ /** @description Name of the original creator */
635
+ _creator?: string;
636
+ /** @description Identity subject of the original creator */
637
+ _creatorSubject?: string;
638
+ /** @description Indicates this component instance should be sourced from a pattern library pattern */
639
+ _pattern?: string;
490
640
  /**
491
- * @description Overrides data resource definitions for a pattern component.
492
- * Object keys defined under this property override the corresponding keys in the pattern's data resources.
493
- * Overrides defined here replace values in either _dataResources or _patternDataResources on the target component.
641
+ * @description Data definitions coming from a pattern resolved for this component. Merged with _dataResources during resolution.
642
+ * Means nothing for PUTs; it will be ignored
494
643
  */
495
- dataResources?: {
496
- [key: string]: components$r["schemas"]["DataResourceDefinition"];
644
+ _patternDataResources?: {
645
+ [key: string]: components$q["schemas"]["DataResourceDefinition"];
646
+ };
647
+ _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
648
+ _patternError?: components$q["schemas"]["PatternError"];
649
+ /**
650
+ * @description Defines patch overrides to component IDs that live in the composition.
651
+ * This can be used to override parameters that are defined on patterns,
652
+ * including nested patterns, with values that are specific to this composition.
653
+ * The keys in this object are component IDs.
654
+ * Overrides are applied from the top down, so for example if both the composition
655
+ * and a pattern on the composition define an override on a nested pattern,
656
+ * the composition's override replaces the pattern's.
657
+ *
658
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
659
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
660
+ */
661
+ _overrides?: {
662
+ [key: string]: components$q["schemas"]["ComponentOverride"];
663
+ };
664
+ /**
665
+ * @description Overrides coming from a pattern resolved for this component. Merged with _overrides during resolution.
666
+ * Means nothing for PUTs; it will be ignored
667
+ */
668
+ _patternOverrides?: {
669
+ [key: string]: components$q["schemas"]["ComponentOverride"];
497
670
  };
671
+ /**
672
+ * @description When used on a pattern, defines how the pattern's parameters may be overridden
673
+ * by consumers of the pattern.
674
+ *
675
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
676
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
677
+ */
678
+ _overridability?: components$q["schemas"]["ComponentOverridability"];
679
+ /** @description Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
680
+ _locales?: string[];
498
681
  };
499
682
  /**
500
- * @description Whether a parameter is overridable
683
+ * @description Defines how to override a specific component.
501
684
  *
502
685
  * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
503
686
  * Future updates that do not break the overrides-applied state of a composition may be made without notice
504
- * @enum {string}
505
687
  */
506
- OverrideOptions: "yes" | "no";
688
+ ComponentOverride: {
689
+ parameters?: {
690
+ [key: string]: components$q["schemas"]["ComponentParameter"];
691
+ };
692
+ slots?: {
693
+ [key: string]: components$q["schemas"]["ComponentInstance"][];
694
+ };
695
+ variant?: string;
696
+ /**
697
+ * @description Overrides data resource definitions for a pattern component.
698
+ * Object keys defined under this property override the corresponding keys in the pattern's data resources.
699
+ * Overrides defined here replace values in either _dataResources or _patternDataResources on the target component.
700
+ */
701
+ dataResources?: {
702
+ [key: string]: components$q["schemas"]["DataResourceDefinition"];
703
+ };
704
+ };
507
705
  /**
508
706
  * @description Defines how a component on a pattern may have its values overridden.
509
707
  * NOTE: Data resources' overridability is defined in the data resource definition, not here.
@@ -514,7 +712,7 @@ interface components$r {
514
712
  ComponentOverridability: {
515
713
  /** @description Defines component parameter value overrides. Keys are the parameter public ID */
516
714
  parameters?: {
517
- [key: string]: components$r["schemas"]["OverrideOptions"];
715
+ [key: string]: components$q["schemas"]["OverrideOptions"];
518
716
  };
519
717
  /** @description Allows overriding a display variant is allowed if it is defined on the component the pattern is derived from. Default = false */
520
718
  variants?: boolean;
@@ -525,1057 +723,400 @@ interface components$r {
525
723
  */
526
724
  hideLockedParameters?: boolean;
527
725
  };
528
- /** @description The definition of a component variant */
529
- ComponentDefinitionVariant: {
530
- id: components$r["schemas"]["PublicIdProperty"];
531
- /** @description Friendly name of the variant */
532
- name: string;
726
+ /**
727
+ * @description Whether a parameter is overridable
728
+ *
729
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
730
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
731
+ * @enum {string}
732
+ */
733
+ OverrideOptions: "yes" | "no";
734
+ /** @description Additional set of headers, parameters, variables, etc to be used for data resolving in the context like e.g. Unpublished Data. */
735
+ AlternativeDataSourceData: {
736
+ /** @description Base resource URL of the data source. No trailing slash */
737
+ baseUrl: string;
738
+ /** @description HTTP headers to pass with requests to the data source */
739
+ headers?: {
740
+ key: string;
741
+ value: string;
742
+ omitIfEmpty?: boolean;
743
+ }[];
744
+ /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data source, overriding identical keys */
745
+ parameters?: {
746
+ key: string;
747
+ value: string;
748
+ omitIfEmpty?: boolean;
749
+ }[];
750
+ /** @description Variables needed to make calls to the data source */
751
+ variables?: {
752
+ [key: string]: components$q["schemas"]["DataVariableDefinition"];
753
+ };
533
754
  };
534
- /** @description Defines a component type that can live on a Composition */
535
- ComponentDefinition: {
536
- id: components$r["schemas"]["PublicIdProperty"];
537
- /** @description Friendly name of the component definition */
538
- name: string;
755
+ /**
756
+ * @description An instance of a data source (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset").
757
+ * These are created in the UI and shared across a whole project.
758
+ * NOTE: If you acquire a list of data sources or do not have manage permissions, you will receive "SECRET"
759
+ * for all header, parameter, and variable values to obscure the actual encrypted secret value
760
+ */
761
+ DataSource: {
762
+ /** @description Public ID of the data source */
763
+ id: string;
764
+ /** @description Display name of the data source */
765
+ displayName: string;
766
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an installed integration) */
767
+ connectorType: string;
768
+ /** @description Base resource URL of the data source. No trailing slash */
769
+ baseUrl: string;
770
+ /** @description HTTP headers to pass with requests to the data source */
771
+ headers?: {
772
+ key: string;
773
+ value: string;
774
+ }[];
775
+ /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data source, overriding identical keys */
776
+ parameters?: {
777
+ key: string;
778
+ value: string;
779
+ }[];
780
+ /** @description Variables needed to make calls to the data source */
781
+ variables?: {
782
+ [key: string]: components$q["schemas"]["DataVariableDefinition"];
783
+ };
539
784
  /**
540
- * @description Icon name for the component definition (e.g. 'screen')
541
- * @default screen
785
+ * @description Mapping of locale codes to data source locale codes. Keys are Uniform locale codes, values are data source locale codes.
786
+ * If a locale is not mapped, it will be passed through to the data source as-is
542
787
  */
543
- icon?: string;
788
+ localeMapping?: {
789
+ [key: string]: string;
790
+ };
544
791
  /**
545
- * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
546
- * The parameter type must support being used as a title parameter for this to work
547
- * @default null
792
+ * @description If true, data source will require additional credentials to access unpublished data.
793
+ * If false, no additional data source credentials are required and data resources of this data source won't be able to access unpublished data.
548
794
  */
549
- titleParameter?: string | null;
795
+ enableUnpublishedMode?: boolean;
796
+ /** @description Custom configuration accessible to all data connector UIs (data source, data type, and data resource editors) and custom edgehancers. This data should not contain secrets */
797
+ customPublic?: {
798
+ [key: string]: unknown;
799
+ };
800
+ /** @description Custom configuration accessible to the data source editor UI and custom edgehancer that may contain secrets. This cannot be read by the data type or data resource editors */
801
+ custom?: {
802
+ [key: string]: unknown;
803
+ };
804
+ /** @description Different connector detail variants to use in the different contexts like e.g. Unpublished Data */
805
+ variants?: {
806
+ unpublished?: components$q["schemas"]["AlternativeDataSourceData"];
807
+ };
808
+ /** @description Created date of the data source in ISO 8601 format (ignored for writes) */
809
+ created?: string;
810
+ /** @description Last modified date of the data source in ISO 8601 format (ignored for writes) */
811
+ modified?: string;
812
+ /** @description User or API key ID that created the data source (ignored for writes) */
813
+ createdBy?: string;
814
+ /** @description User or API key ID that last modified the data source (ignored for writes) */
815
+ modifiedBy?: string;
816
+ };
817
+ /** @description A specific type of data that a Data Source can provide (i.e. "Recipe", "Recipes List by Tag", "Yelp Reviews of My Restaurant"). These are created in the UI and shared a whole project */
818
+ DataType: {
819
+ /** @description Public ID of the data type */
820
+ id: string;
821
+ /** @description Display name of the data type */
822
+ displayName: string;
823
+ /** @description Public ID of the associated data source */
824
+ dataSourceId: string;
550
825
  /**
551
- * @description The public ID of the parameter whose value should be used as a thumbnail for compositions of this component in the UI
552
- * @default null
826
+ * @description A connector-specific archetype for this data type; used to select UI as well as perform any
827
+ * necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
828
+ * no special UI or processing is required
553
829
  */
554
- thumbnailParameter?: string | null;
830
+ archetype?: string;
831
+ allowedOnComponents?: string[];
832
+ /** @description Resource path, appended to the data source's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have a leading slash */
833
+ path: string;
834
+ /** @description Time-to-live (in seconds) for the resource data cache */
835
+ ttl?: number;
836
+ /** @description A key for the resource data cache purging */
837
+ purgeKey?: string;
838
+ /** @description URL to a custom badge icon for the Uniform dashboard for this data type. If not set falls back to the data connector or integration icons */
839
+ badgeIconUrl?: string;
840
+ /** @description HTTP headers to pass with requests to the data type. Merged with headers from the data source, overriding identical keys */
841
+ headers?: {
842
+ key: string;
843
+ value: string;
844
+ omitIfEmpty?: boolean;
845
+ }[];
846
+ /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data source, overriding identical keys */
847
+ parameters?: {
848
+ key: string;
849
+ value: string;
850
+ omitIfEmpty?: boolean;
851
+ }[];
852
+ /** @description Body to pass with requests to the data type (ignored unless the method is POST) */
853
+ body?: string;
555
854
  /**
556
- * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components
557
- * @default false
855
+ * @description HTTP method to use with requests to the data type
856
+ * @default GET
857
+ * @enum {string}
558
858
  */
559
- canBeComposition?: boolean;
560
- /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries */
561
- parameters?: components$r["schemas"]["ComponentDefinitionParameter"][];
859
+ method: "GET" | "POST" | "HEAD";
860
+ /** @description Variables needed to make calls to the data type. Merged with variables from the data source, overriding identical keys */
861
+ variables?: {
862
+ [key: string]: components$q["schemas"]["DataVariableDefinition"];
863
+ };
864
+ /** @description Custom configuration specific to the data source being defined */
865
+ custom?: {
866
+ [key: string]: unknown;
867
+ };
868
+ /** @description Created date of the data type in ISO 8601 format (ignored for writes) */
869
+ created?: string;
870
+ /** @description Last modified date of the data type in ISO 8601 format (ignored for writes) */
871
+ modified?: string;
872
+ /** @description User or API key ID that created the data type (ignored for writes) */
873
+ createdBy?: string;
874
+ /** @description User or API key ID that last modified the data type (ignored for writes) */
875
+ modifiedBy?: string;
876
+ };
877
+ /** @description Defines the shape of a data variable on a Data Source or Data Type */
878
+ DataVariableDefinition: {
879
+ /** @description Display name of the data variable */
880
+ displayName?: string;
881
+ /** @description Explanatory text that is provided to the data resource editor to explain what this variable does */
882
+ helpText?: string;
562
883
  /**
563
- * Format: uuid
564
- * @description Reference to the category this component definition belongs to
565
- * @default null
884
+ * @description Type of the data variable. Optionally used as a point of reference for custom integrations to decide how to render an editor for a variable
885
+ * @default text
566
886
  */
567
- categoryId?: string | null;
568
- /** @description Description of the component definition */
569
- description?: string;
570
- /** @description Preview image URL for the component definition (shown in the UI) */
571
- previewImageUrl?: string;
887
+ type?: string;
888
+ /** @description Default value of the data variable */
889
+ default: string;
890
+ /** @description Sets the order of the variable when displayed in a list with other variables. If not set, the order defaults to alphabetical with any explicitly set orders first in the list */
891
+ order?: number;
572
892
  /**
573
- * @description if this component uses team permissions or custom permissions
574
- * @default true
893
+ * @description An optional arbitrary human readable source identifier to describe where this variable is from.
894
+ * Some user interfaces may group variables by source value, for example 'From URL' or 'My Integration'
575
895
  */
576
- useTeamPermissions?: boolean;
577
- /** @description Custom role permissions for this component definition */
578
- permissions?: components$r["schemas"]["ComponentDefinitionPermission"][];
579
- /** @description The named slots for this component; placement areas where arrays of other components can be added */
580
- slots?: components$r["schemas"]["ComponentDefinitionSlot"][];
581
- slugSettings?: components$r["schemas"]["ComponentDefinitionSlugSettings"];
582
- /** @description Default component instance value */
583
- defaults?: components$r["schemas"]["ComponentInstance"] | null;
584
- /** @description Named variants for this component; enables the creation of visual variants that use the same parameter data */
585
- variants?: components$r["schemas"]["ComponentDefinitionVariant"][];
586
- /** @description Created date string for this definition (ignored for writes) */
587
- created?: string;
588
- /** @description Last modified date string for this definition (ignored for writes) */
589
- updated?: string;
590
- /**
591
- * Format: uuid
592
- * @description ID of the workflow that instances of this component definition will use by default. When not set, no workflow is attached
593
- */
594
- workflowId?: string;
595
- };
596
- Error: {
597
- /** @description Error message(s) that occurred while processing the request */
598
- errorMessage?: string[] | string;
599
- };
600
- };
601
- responses: {
602
- /** @description Request input validation failed */
603
- BadRequestError: {
604
- headers: {
605
- [name: string]: unknown;
606
- };
607
- content: {
608
- "application/json": components$r["schemas"]["Error"];
609
- };
610
- };
611
- /** @description API key or token was not valid */
612
- UnauthorizedError: {
613
- headers: {
614
- [name: string]: unknown;
615
- };
616
- content: {
617
- "application/json": components$r["schemas"]["Error"];
618
- };
619
- };
620
- /** @description Permission was denied */
621
- ForbiddenError: {
622
- headers: {
623
- [name: string]: unknown;
624
- };
625
- content: {
626
- "application/json": components$r["schemas"]["Error"];
627
- };
628
- };
629
- /** @description Too many requests in allowed time period */
630
- RateLimitError: {
631
- headers: {
632
- [name: string]: unknown;
633
- };
634
- content?: never;
896
+ source?: string;
635
897
  };
636
- /** @description Execution error occurred */
637
- InternalServerError: {
638
- headers: {
639
- [name: string]: unknown;
640
- };
641
- content?: never;
898
+ /**
899
+ * @description Data definitions attached to this component. The property name is the key of the data in the data document.
900
+ * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key)
901
+ */
902
+ DataResourceDefinitions: {
903
+ [key: string]: components$q["schemas"]["DataResourceDefinition"];
642
904
  };
643
- };
644
- parameters: never;
645
- requestBodies: never;
646
- headers: never;
647
- pathItems: never;
648
- }
649
-
650
- interface components$q {
651
- schemas: {
652
- /** @description Public ID (used in code). Do not change after creation */
653
- PublicIdProperty: string;
654
- /** @description The definition of a component parameter */
655
- ComponentDefinitionParameter: {
656
- id: components$q["schemas"]["PublicIdProperty"];
657
- /** @description Friendly name of the parameter */
658
- name: string;
659
- /** @description Appears next to the parameter in the Composition editor */
660
- helpText?: string;
661
- /** @description Context provided to AI when generating content for this parameter. May also be shown to humans. */
662
- guidance?: string;
663
- /** @description Type name of the parameter (provided by a Uniform integration) */
905
+ /** @description Defines a data resource, which is a named JSON document, usually from an API response, which may be projected onto parameters */
906
+ DataResourceDefinition: {
907
+ /** @description Public ID of the data type that provides this data */
664
908
  type: string;
909
+ /** @description Whether this data is a pattern data resource that can be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false */
910
+ isPatternParameter?: boolean;
665
911
  /**
666
- * @description If true, this property can have locale-specific values. If false or not defined,
667
- * this property will have a single value that is shared for all locales
668
- */
669
- localizable?: boolean;
670
- /**
671
- * @description When `localizable` is true, this property controls the default localizability of the property.
672
- * true - when the property has no existing value, it will be in 'single value' mode and not store locale specific values
673
- * false/undefined - when the property has no existing value, it will store separate values for each enabled locale
674
- *
675
- * If `localized` is false, this has no effect.
912
+ * @description When true, the default data resource of a pattern data parameter (isPatternParameter=true) will be ignored when the pattern is referenced.
913
+ * Unless specifically overridden, the pattern data parameter will be provided with a null default value - leaving any data connections to it unresolvable.
914
+ * If isPatternParameter is false or undefined, this has no meaning
676
915
  */
677
- notLocalizedByDefault?: boolean;
916
+ ignorePatternParameterDefault?: boolean;
678
917
  /**
679
- * @description Enables creating additional conditional values for the parameter based on criteria such as dynamic inputs.
680
- * When combined with a localized value, each locale has independent conditional values.
681
- *
682
- * When not defined, conditional values are not allowed.
918
+ * @description When true, the data resource does not create an error forcing the choosing of override value when there is no default.
919
+ * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
683
920
  */
684
- allowConditionalValues?: boolean;
685
- /** @description The configuration object for the type (type-specific) */
686
- typeConfig?: unknown;
921
+ optionalPatternParameter?: boolean;
922
+ variables?: components$q["schemas"]["DataResourceVariables"];
687
923
  };
688
- /** @description The definition of a named component slot that can contain other components */
689
- ComponentDefinitionSlot: {
690
- id: components$q["schemas"]["PublicIdProperty"];
691
- /** @description Friendly name of the slot */
692
- name: string;
693
- /** @description A list of component definition public IDs that are allowed in this named slot */
694
- allowedComponents: string[];
695
- /**
696
- * @description Whether this slot inherits its allowed components from the parent slot it lives in. If true, `allowedComponents` is irrelevant.
697
- * If `allowAllComponents` is true, this value is ignored
698
- * @default false
699
- */
700
- inheritAllowedComponents: boolean;
701
- /**
702
- * @description When false or not defined, only components in `allowedComponents` may be added to this slot - and if `allowedComponents` is empty, nothing can be added.
703
- * When true, every component and pattern that is defined may be added to this slot regardless of any other setting including `inheritAllowedComponents`
704
- */
705
- allowAllComponents?: boolean;
706
- /**
707
- * @description When not defined, or false: all patterns for components listed in `allowedComponents` are automatically allowed in the slot.
708
- * When true: patterns for components listed in `allowedComponents` are not allowed in the slot unless explicitly added to `allowedComponents` as `$p:<patternid>`
709
- */
710
- patternsInAllowedComponents?: boolean;
711
- /** @description Minimum valid number of components in this slot */
712
- minComponents?: number;
713
- /** @description Maximum valid number of components in this slot */
714
- maxComponents?: number;
924
+ /** @description Variable values for a data resource */
925
+ DataResourceVariables: {
926
+ [key: string]: string;
715
927
  };
716
- /** @description The definition of a composition's slug settings */
717
- ComponentDefinitionSlugSettings: {
718
- /**
719
- * @description Whether the slug is required
720
- * no: slug is optional
721
- * yes: slug is required
722
- * disabled: slug is disabled and will not be shown in the editor
723
- * @default no
724
- * @enum {string}
725
- */
726
- required?: "no" | "yes" | "disabled";
727
- /**
728
- * @description Slug uniqueness configuration.
729
- * no = no unique constraint
730
- * local = must be unique within this component type
731
- * global = must be unique across all component types
732
- * @enum {string}
733
- */
734
- unique?: "no" | "local" | "global";
735
- /** @description Regular expression slugs must match */
736
- regularExpression?: string;
928
+ /**
929
+ * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
930
+ * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
931
+ * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, en published yet.
932
+ * Means nothing for PUTs; it will be ignored
933
+ * @enum {string}
934
+ */
935
+ PatternError: "NOTFOUND" | "CYCLIC";
936
+ HistoryApiResponse: {
737
937
  /**
738
- * @description Custom error message when regular expression validation fails.
739
- * Has no effect if `regularExpression` is not set
938
+ * @description If there are more results, this will be populated with a token to pass in the next request to get the next page of results.
939
+ * If this is undefined then no more results are available
740
940
  */
741
- regularExpressionMessage?: string;
742
- };
743
- /** @description The definition of a component variant */
744
- ComponentDefinitionVariant: {
745
- id: components$q["schemas"]["PublicIdProperty"];
746
- /** @description Friendly name of the variant */
747
- name: string;
941
+ cursor?: string;
942
+ /** @description If more history is available than your plan allows, and additional entries are available by upgrading, this will be true */
943
+ truncated?: boolean;
944
+ /** @description Version history entries */
945
+ results?: components$q["schemas"]["HistoryEntry"][];
748
946
  };
749
- /** @description Permission set for a component definition */
750
- ComponentDefinitionPermission: {
751
- roleId: components$q["schemas"]["PublicIdProperty"];
752
- /**
753
- * @description Permission type for this permission ComponentDefinition:
754
- * read | write | create | delete
755
- * @enum {string}
756
- */
757
- permission: "read" | "write" | "create" | "delete";
758
- /** @description State of the component that this permission applies to */
947
+ HistoryEntry: {
948
+ /** @description The version ID of the entity. This can be used to fetch the version's data via the entity API */
949
+ versionId: string;
950
+ /** @description The timestamp when the version was created in epoch milliseconds */
951
+ timestamp: number;
952
+ /** @description The name (full name) of the user who created the version, or "Unknown user" if the author can no longer be resolved */
953
+ authorName: string;
954
+ authorIsApiKey: boolean;
955
+ /** @description The identity who created the version; absent on old history entries. */
956
+ authorSubject?: string;
957
+ /** @description The state of the entity when the history entry was made */
759
958
  state: number;
760
959
  };
761
- /** @description Defines a component type that can live on a Composition */
762
- ComponentDefinition: {
763
- id: components$q["schemas"]["PublicIdProperty"];
764
- /** @description Friendly name of the component definition */
765
- name: string;
960
+ /** @description Category for tagging canvas entities */
961
+ Category: {
766
962
  /**
767
- * @description Icon name for the component definition (e.g. 'screen')
768
- * @default screen
963
+ * Format: uuid
964
+ * @description Unique identifier for the category
769
965
  */
770
- icon?: string;
966
+ id: string;
967
+ /** @description Display name of the category */
968
+ name: string;
771
969
  /**
772
- * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
773
- * The parameter type must support being used as a title parameter for this to work
774
- * @default null
970
+ * @description Sets the order of the category when displayed in a list with other categories. If not set, the order defaults to alphabetical with any explicitly set orders first in the list
971
+ * @default 0
775
972
  */
776
- titleParameter?: string | null;
973
+ order?: number;
974
+ };
975
+ /** @description Project map node information related to a component */
976
+ CompositionProjectMapNodeInfo: {
777
977
  /**
778
- * @description The public ID of the parameter whose value should be used as a thumbnail for compositions of this component in the UI
779
- * @default null
978
+ * Format: uuid
979
+ * @description Unique identifier for the project map node
780
980
  */
781
- thumbnailParameter?: string | null;
981
+ id: string;
782
982
  /**
783
- * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components
784
- * @default false
983
+ * @description Fallback path of the project map node.
984
+ * Note that the node may have matched via a locale-specific path which is in the `locales` object
785
985
  */
786
- canBeComposition?: boolean;
787
- /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries */
788
- parameters?: components$q["schemas"]["ComponentDefinitionParameter"][];
986
+ path: string;
789
987
  /**
790
988
  * Format: uuid
791
- * @description Reference to the category this component definition belongs to
792
- * @default null
989
+ * @description Unique identifier for the project map that this node belongs to
793
990
  */
794
- categoryId?: string | null;
795
- /** @description Description of the component definition */
796
- description?: string;
797
- /** @description Preview image URL for the component definition (shown in the UI) */
798
- previewImageUrl?: string;
991
+ projectMapId: string;
992
+ data?: components$q["schemas"]["ProjectMapNodeData"];
799
993
  /**
800
- * @description if this component uses team permissions or custom permissions
801
- * @default true
994
+ * @description Locale-specific paths of the project map node.
995
+ * Keys are locale codes
802
996
  */
803
- useTeamPermissions?: boolean;
804
- /** @description Custom role permissions for this component definition */
805
- permissions?: components$q["schemas"]["ComponentDefinitionPermission"][];
806
- /** @description The named slots for this component; placement areas where arrays of other components can be added */
807
- slots?: components$q["schemas"]["ComponentDefinitionSlot"][];
808
- slugSettings?: components$q["schemas"]["ComponentDefinitionSlugSettings"];
809
- /** @description Default component instance value */
810
- defaults?: components$q["schemas"]["ComponentInstance"] | null;
811
- /** @description Named variants for this component; enables the creation of visual variants that use the same parameter data */
812
- variants?: components$q["schemas"]["ComponentDefinitionVariant"][];
813
- /** @description Created date string for this definition (ignored for writes) */
814
- created?: string;
815
- /** @description Last modified date string for this definition (ignored for writes) */
816
- updated?: string;
997
+ locales?: {
998
+ [key: string]: {
999
+ /** @description Locale-specific path of the project map node */
1000
+ path: string;
1001
+ /** @description Whether the path is inherited from a parent node which defined a path segment in this locale */
1002
+ inherited: boolean;
1003
+ };
1004
+ };
1005
+ };
1006
+ /** @description AI Prompt definition */
1007
+ Prompt: {
817
1008
  /**
818
1009
  * Format: uuid
819
- * @description ID of the workflow that instances of this component definition will use by default. When not set, no workflow is attached
1010
+ * @description Unique identifier for the prompt
820
1011
  */
821
- workflowId?: string;
1012
+ id: string;
1013
+ /** @description Unique identifier for the integration that this prompt belongs to */
1014
+ integrationType: string;
1015
+ /** @description Name for the prompt */
1016
+ name?: string | null;
1017
+ /** @description Text for the prompt */
1018
+ text?: string | null;
1019
+ /** @description Data for the prompt */
1020
+ data?: {
1021
+ [key: string]: unknown;
1022
+ } | null;
1023
+ /** @description Turn off/on prompt */
1024
+ enabled?: boolean | null;
1025
+ /** @description Integration default prompt */
1026
+ builtIn?: boolean | null;
1027
+ /** @description Supported parameter types */
1028
+ parameterTypes?: string[] | null;
822
1029
  };
823
- /** @description Defines a content type */
824
- ContentType: {
825
- id: components$q["schemas"]["PublicIdProperty"];
826
- /** @description Friendly name of the content type */
827
- name: string;
828
- /**
829
- * @description The public ID of the field whose value should be used to create a display name for entries of this content type in the UI.
830
- * The field type must support being used as an entry name for this to work
831
- */
832
- entryName?: string | null;
833
- /**
834
- * @description The public ID of the field whose value should be used as a thumbnail for entries of this content type in the UI
835
- * @default null
836
- */
837
- thumbnailField?: string | null;
838
- /** @description The fields for this content type. Fields are key-value pairs that can be text, numbers, JSON objects, etc. */
839
- fields?: components$q["schemas"]["ComponentDefinitionParameter"][];
840
- /** @description Description of the content type */
841
- description?: string;
842
- /**
843
- * @description Icon name for the content type (e.g. 'screen')
844
- * @default file-document
845
- */
846
- icon?: string;
847
- /** @description Created date string for this content type (ignored for writes) */
848
- created?: string;
849
- /** @description Last modified date string for this content type (ignored for writes) */
850
- updated?: string;
851
- slugSettings?: components$q["schemas"]["ComponentDefinitionSlugSettings"];
852
- /**
853
- * @description The definition type of this content type (block or content type)
854
- * @default contentType
855
- * @enum {string}
856
- */
857
- type?: "contentType" | "block";
1030
+ /** @description Definition of a workflow that can be assigned to entities */
1031
+ WorkflowDefinition: {
858
1032
  /**
859
- * @description if this content type uses team permissions or custom permissions
860
- * @default true
1033
+ * Format: uuid
1034
+ * @description Unique identifier of the workflow definition
861
1035
  */
862
- useTeamPermissions?: boolean;
863
- /** @description Custom role permissions for this content type */
864
- permissions?: components$q["schemas"]["ComponentDefinitionPermission"][];
1036
+ id: string;
1037
+ /** @description Workflow name */
1038
+ name: string;
865
1039
  /**
866
1040
  * Format: uuid
867
- * @description ID of the workflow that instances of this content type will use by default. When not set, no workflow is attached
1041
+ * @description The ID of the initial stage in the stages object.
868
1042
  */
869
- workflowId?: string;
870
- /** @description Configurations for previewing an entry on a consuming pattern or composition. */
871
- previewConfigurations?: components$q["schemas"]["ContentTypePreviewConfiguration"][];
872
- };
873
- /** @description Defines a configuration for previewing an entry on a consuming pattern or composition. */
874
- ContentTypePreviewConfiguration: {
1043
+ initialStage: string;
1044
+ /** @description All stages of the workflow */
1045
+ stages: {
1046
+ [key: string]: components$q["schemas"]["WorkflowStage"];
1047
+ };
1048
+ /** @description Last modified ISO date string for this definition (ignored for writes) */
1049
+ modified?: string;
1050
+ /** @description Created ISO date string for this definition (ignored for writes) */
1051
+ created?: string;
875
1052
  /**
876
- * @description The type of preview configuration
877
- * @enum {string}
1053
+ * @description Name of the original creator of the workflow.
1054
+ * If undefined, the user has been removed from the team.
1055
+ * Ignored for writes
878
1056
  */
879
- type: "pattern" | "project-map";
880
- /** @description Display label for the preview configuration */
881
- label: string;
1057
+ createdBy?: string;
882
1058
  /**
883
- * Format: uuid
884
- * @description Target preview entity ID (project map node ID or pattern ID)
1059
+ * @description Name of the last modifier of the workflow.
1060
+ * If undefined, the user has been removed from the team.
1061
+ * Ignored for writes
885
1062
  */
886
- id: string;
887
- /** @description Optional mapping of dynamic input names to their values */
888
- dynamicInputs?: {
889
- [key: string]: string;
890
- };
1063
+ modifiedBy?: string;
891
1064
  };
892
- /** @description Defines an editable parameter on a component */
893
- ComponentParameter: {
894
- /** @description The value of the parameter. Any JSON-serializable value is acceptable */
895
- value?: unknown;
896
- /** @description The type of the parameter. Determines how it is displayed when editing and tells the consumer how to process it */
897
- type: string;
898
- /** @deprecated */
899
- connectedData?: components$q["schemas"]["DataElementConnectionDefinition"];
1065
+ /** @description Definition of a stage in a workflow */
1066
+ WorkflowStage: {
1067
+ /** @description Name of the stage */
1068
+ name: string;
900
1069
  /**
901
- * @description Locale-specific values for this parameter. Keys are locale codes, and values are the `value` in that locale.
902
- * Note that locales must be registered on the entry/composition `_locales` before being used
1070
+ * @description Defines roles which have permissions to this workflow stage
1071
+ * NOTE: Being able to write or publish to entities in a workflow stage requires both core write or publish permissions,
1072
+ * as well as membership in a role which grants the explicit rights to the stage. If a user is not a member of any role
1073
+ * listed here, the stage is read-only and publishing is disabled
903
1074
  */
904
- locales?: {
905
- [key: string]: unknown;
906
- };
907
- conditions?: components$q["schemas"]["ComponentParameterConditions"];
908
- /** @description Locale-specific conditional values for this parameter. Keys are locale codes, and values are the `conditions` for that locale. */
909
- localesConditions?: {
910
- [key: string]: components$q["schemas"]["ComponentParameterConditions"];
1075
+ permissions: {
1076
+ [key: string]: components$q["schemas"]["WorkflowStagePermission"];
911
1077
  };
912
- };
913
- /**
914
- * @description Array of alternate values which are based on conditions.
915
- *
916
- * When requested with an explicit locale parameter, or via the route API:
917
- * * Conditions are evaluated sequentially and the first match is used. If a match is found, the conditions are eliminated.
918
- * * If no conditions match, the `value` property is used.
919
- * * If a condition cannot be evaluated yet (i.e. a client-side criteria), it is left alone.
920
- *
921
- * When no locale is passed to a non-route API, conditions are not processed and all conditions are returned.
922
- */
923
- ComponentParameterConditions: components$q["schemas"]["ComponentParameterConditionalValue"][];
924
- /** @description Defines a conditional value for a component parameter */
925
- ComponentParameterConditionalValue: {
926
- when: components$q["schemas"]["VisibilityCriteriaGroup"];
927
1078
  /**
928
- * @description The value of the parameter. Any JSON-serializable value is acceptable.
929
- * A value of `null` will cause the parameter value to be removed, if it matches.
1079
+ * @description When true, transitioning into this stage from a different stage will automatically publish the entity.
1080
+ * If the user making the transition does not have publish permissions to the stage as well as publish permission on the entity, the action will not run.
1081
+ * Setting this to true is equivalent to setting requireValidity to true, as publishing cannot be performed with validation errors.
1082
+ * NOTE: This is not executed by direct API calls. Only the Uniform UI performs this action
930
1083
  */
931
- value: unknown;
1084
+ autoPublish?: boolean;
932
1085
  /**
933
- * @description Unique sequence identifier of the conditional value within the component parameter.
934
- * This value must be unique within the conditional values array, and it should not change after a condition is created.
1086
+ * @description When true, transitioning into this stage from a different stage will require the entity to have no validation errors.
1087
+ * If the entity is not valid, the transition will not be allowed.
1088
+ * NOTE: This is not executed by direct API calls. Only the Uniform UI performs this action
935
1089
  */
936
- id: number;
937
- };
938
- /**
939
- * @deprecated
940
- * @description beta functionality subject to change
941
- */
942
- VisibilityCriteriaGroup: {
1090
+ requireValidity?: boolean;
943
1091
  /**
944
- * @description The boolean operator to join the clauses with. Defaults to & if not specified.
945
- * @enum {string}
1092
+ * @description Defines transitions to other stages
1093
+ * Every stage must define at least one transition, to avoid creating a workflow that
1094
+ * has a stage that can never be escaped
946
1095
  */
947
- op?: "&" | "|";
948
- clauses: (components$q["schemas"]["VisibilityCriteria"] | components$q["schemas"]["VisibilityCriteriaGroup"])[];
949
- };
950
- /**
951
- * @deprecated
952
- * @description beta functionality subject to change
953
- */
954
- VisibilityCriteria: {
955
- /** @description The rule type to execute */
956
- rule: string;
1096
+ transitions: components$q["schemas"]["WorkflowStageTransition"][];
957
1097
  /**
958
- * @description The source value of the rule.
959
- * For rules which have multiple classes of match, for example a dynamic input matches on a named DI, the rule is dynamic input and the DI name is the source.
1098
+ * @description Icon name for the stage (e.g. 'chevron-double-right-o')
1099
+ * @default chevron-double-right-o
960
1100
  */
961
- source?: string;
962
- /** @description The rule-definition-specific operator to test against */
963
- op: string;
964
- /** @description The value, or if an array several potential values, to test against. In most rules, multiple values are OR'd together ('any of') but this is not a hard requirement. */
965
- value: string | string[];
1101
+ icon?: string;
1102
+ /** @description Sets the order of the stage when displayed in a list with other stages. If not set, the order defaults to alphabetical with any explicitly set orders first in the list */
1103
+ order?: number;
966
1104
  };
967
- /** @description Defines a connection to a dynamic token on a data resource */
968
- DataElementConnectionDefinition: {
969
- /** @description A JSON Pointer expression that defines the data resource dynamic token value */
970
- pointer: string;
1105
+ /** @description Definition of a transition from one stage to another in a workflow */
1106
+ WorkflowStageTransition: {
971
1107
  /**
972
- * @description The syntax used to select the dynamic token to bind to
973
- * @enum {string}
1108
+ * Format: uuid
1109
+ * @description The target stage to transition to
974
1110
  */
975
- syntax: "jptr";
1111
+ to: string;
976
1112
  /**
977
- * @description The action to take if the dynamic token cannot be resolved
978
- * - t: TOKEN: Removes the failed dynamic token value, leaving the rest of the property value, if any, intact [default]
979
- * NOTE: If the _only_ value in the property is a dynamic token, the property value is removed (as with 'p' below)
980
- * NOTE: If the _failureDefault_ property is also set, that default value will be used instead of removing the token.
981
- * this only applies when the failureAction is 't' or undefined, the default is otherwise ignored
982
- * - p: PROPERTY: Removes the entire property value, including any other dynamic tokens or static values in the property
983
- * - c: COMPONENT: Removes the whole parent component or block that contains the property.
984
- * NOTE: If a 'component' failure occurs on the root component of a composition, or an entry,
985
- * it is treated as an 'a' failure because removing the root means we must remove all
986
- * - a: ALL: Fails the whole entry or composition. This will result in the item returning a 404 from APIs, and being removed from API list responses
987
- * @enum {string}
1113
+ * @description Name shown to the user when they execute this transition.
1114
+ * If not provided, a default name will be assigned automatically based on the target stage
988
1115
  */
989
- failureAction?: "t" | "p" | "c" | "a";
1116
+ name: string;
990
1117
  /**
991
- * @description How to report when the dynamic token cannot be resolved
992
- * - e: ERROR: Report an error message (this will prevent publishing)
993
- * - w: WARNING: Report a warning message [default]
994
- * - i: INFO: Log an informative message (failure is expected/normal, i.e. optional data)
995
- * @enum {string}
996
- */
997
- failureLogLevel?: "e" | "w" | "i";
998
- /**
999
- * @description The default value to use if the dynamic token cannot be resolved.
1000
- * This is only used if the failureAction is the default (undefined, or explicitly token)
1001
- */
1002
- failureDefault?: string;
1003
- };
1004
- /** @description Defines the shape of a component instance served by the composition API */
1005
- ComponentInstance: {
1006
- /** @description Type of the component instance (public_id of its definition) */
1007
- type: string;
1008
- /** @description Component parameter values for the component instance */
1009
- parameters?: {
1010
- [key: string]: components$q["schemas"]["ComponentParameter"];
1011
- };
1012
- /** @description Public ID of alternate visual appearance for this component, if any selected */
1013
- variant?: string;
1014
- /** @description Slots containing any child components */
1015
- slots?: {
1016
- [key: string]: components$q["schemas"]["ComponentInstance"][];
1017
- };
1018
- /**
1019
- * @description Unique identifier of the component within the composition.
1020
- * No assumptions should be made about the format of this value other than "it will be unique."
1021
- * This is not returned in GET replies unless specifically requested via `withComponentIDs` API parameter.
1022
- * When updating or creating a composition, if you do not specify an _id for each component, one will be created and stored for you
1023
- */
1024
- _id?: string;
1025
- /** @description Indicates this component instance should be sourced from a pattern library pattern */
1026
- _pattern?: string;
1027
- _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
1028
- /**
1029
- * @description Data definitions coming from a pattern resolved for this component. Merged with _dataResources during resolution.
1030
- * Means nothing for PUTs; it will be ignored
1031
- */
1032
- _patternDataResources?: {
1033
- [key: string]: components$q["schemas"]["DataResourceDefinition"];
1034
- };
1035
- _patternError?: components$q["schemas"]["PatternError"];
1036
- /**
1037
- * @description Defines patch overrides to component IDs that live in the composition.
1038
- * This can be used to override parameters that are defined on patterns,
1039
- * including nested patterns, with values that are specific to this composition.
1040
- * The keys in this object are component IDs.
1041
- * Overrides are applied from the top down, so for example if both the composition
1042
- * and a pattern on the composition define an override on a nested pattern,
1043
- * the composition's override replaces the pattern's.
1044
- *
1045
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1046
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1047
- */
1048
- _overrides?: {
1049
- [key: string]: components$q["schemas"]["ComponentOverride"];
1050
- };
1051
- /**
1052
- * @description Overrides coming from a pattern resolved for this component. Merged with _overrides during resolution.
1053
- * Means nothing for PUTs; it will be ignored
1054
- */
1055
- _patternOverrides?: {
1056
- [key: string]: components$q["schemas"]["ComponentOverride"];
1057
- };
1058
- /**
1059
- * @description When used on a pattern, defines how the pattern's parameters may be overridden
1060
- * by consumers of the pattern.
1061
- *
1062
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1063
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1064
- */
1065
- _overridability?: components$q["schemas"]["ComponentOverridability"];
1066
- /** @description Array of locales that have data defined. Only set for pattern references or composition defaults */
1067
- _locales?: string[];
1068
- };
1069
- /** @description Defines the shape of the root component in a composition */
1070
- RootComponentInstance: {
1071
- /** @description Type of the component instance (public_id of its definition) */
1072
- type: string;
1073
- /** @description Component parameter values for the component instance */
1074
- parameters?: {
1075
- [key: string]: components$q["schemas"]["ComponentParameter"];
1076
- };
1077
- /** @description Public ID of alternate visual appearance for this component, if any selected */
1078
- variant?: string;
1079
- /** @description Project map nodes associated with this component. Must pass withProjectMapNodes parameter to be populated */
1080
- projectMapNodes?: components$q["schemas"]["CompositionProjectMapNodeInfo"][];
1081
- /** @description Slots containing any child components */
1082
- slots?: {
1083
- [key: string]: components$q["schemas"]["ComponentInstance"][];
1084
- };
1085
- /** @description The ID of the composition */
1086
- _id: string;
1087
- /** @description Slug pattern of this component */
1088
- _slug?: string | null;
1089
- /** @description Friendly name of this component */
1090
- _name: string;
1091
- /** @description Name of the author of the most recent change */
1092
- _author?: string;
1093
- /** @description Identity subject of the author of the most recent change */
1094
- _authorSubject?: string;
1095
- /** @description Name of the original creator */
1096
- _creator?: string;
1097
- /** @description Identity subject of the original creator */
1098
- _creatorSubject?: string;
1099
- /** @description Indicates this component instance should be sourced from a pattern library pattern */
1100
- _pattern?: string;
1101
- /**
1102
- * @description Data definitions coming from a pattern resolved for this component. Merged with _dataResources during resolution.
1103
- * Means nothing for PUTs; it will be ignored
1104
- */
1105
- _patternDataResources?: {
1106
- [key: string]: components$q["schemas"]["DataResourceDefinition"];
1107
- };
1108
- _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
1109
- _patternError?: components$q["schemas"]["PatternError"];
1110
- /**
1111
- * @description Defines patch overrides to component IDs that live in the composition.
1112
- * This can be used to override parameters that are defined on patterns,
1113
- * including nested patterns, with values that are specific to this composition.
1114
- * The keys in this object are component IDs.
1115
- * Overrides are applied from the top down, so for example if both the composition
1116
- * and a pattern on the composition define an override on a nested pattern,
1117
- * the composition's override replaces the pattern's.
1118
- *
1119
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1120
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1121
- */
1122
- _overrides?: {
1123
- [key: string]: components$q["schemas"]["ComponentOverride"];
1124
- };
1125
- /**
1126
- * @description Overrides coming from a pattern resolved for this component. Merged with _overrides during resolution.
1127
- * Means nothing for PUTs; it will be ignored
1128
- */
1129
- _patternOverrides?: {
1130
- [key: string]: components$q["schemas"]["ComponentOverride"];
1131
- };
1132
- /**
1133
- * @description When used on a pattern, defines how the pattern's parameters may be overridden
1134
- * by consumers of the pattern.
1135
- *
1136
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1137
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1138
- */
1139
- _overridability?: components$q["schemas"]["ComponentOverridability"];
1140
- /** @description Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
1141
- _locales?: string[];
1142
- };
1143
- /**
1144
- * @description Defines how to override a specific component.
1145
- *
1146
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1147
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1148
- */
1149
- ComponentOverride: {
1150
- parameters?: {
1151
- [key: string]: components$q["schemas"]["ComponentParameter"];
1152
- };
1153
- slots?: {
1154
- [key: string]: components$q["schemas"]["ComponentInstance"][];
1155
- };
1156
- variant?: string;
1157
- /**
1158
- * @description Overrides data resource definitions for a pattern component.
1159
- * Object keys defined under this property override the corresponding keys in the pattern's data resources.
1160
- * Overrides defined here replace values in either _dataResources or _patternDataResources on the target component.
1161
- */
1162
- dataResources?: {
1163
- [key: string]: components$q["schemas"]["DataResourceDefinition"];
1164
- };
1165
- };
1166
- /**
1167
- * @description Defines how a component on a pattern may have its values overridden.
1168
- * NOTE: Data resources' overridability is defined in the data resource definition, not here.
1169
- *
1170
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1171
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1172
- */
1173
- ComponentOverridability: {
1174
- /** @description Defines component parameter value overrides. Keys are the parameter public ID */
1175
- parameters?: {
1176
- [key: string]: components$q["schemas"]["OverrideOptions"];
1177
- };
1178
- /** @description Allows overriding a display variant is allowed if it is defined on the component the pattern is derived from. Default = false */
1179
- variants?: boolean;
1180
- /**
1181
- * @description If true, parameters that are not overridable will be hidden by default on pattern instances' editors.
1182
- * If false, all parameters will be shown on pattern instances' editors, but locked parameters will be read-only.
1183
- * If not set, the default is false
1184
- */
1185
- hideLockedParameters?: boolean;
1186
- };
1187
- /**
1188
- * @description Whether a parameter is overridable
1189
- *
1190
- * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1191
- * Future updates that do not break the overrides-applied state of a composition may be made without notice
1192
- * @enum {string}
1193
- */
1194
- OverrideOptions: "yes" | "no";
1195
- /** @description Additional set of headers, parameters, variables, etc to be used for data resolving in the context like e.g. Unpublished Data. */
1196
- AlternativeDataSourceData: {
1197
- /** @description Base resource URL of the data source. No trailing slash */
1198
- baseUrl: string;
1199
- /** @description HTTP headers to pass with requests to the data source */
1200
- headers?: {
1201
- key: string;
1202
- value: string;
1203
- omitIfEmpty?: boolean;
1204
- }[];
1205
- /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data source, overriding identical keys */
1206
- parameters?: {
1207
- key: string;
1208
- value: string;
1209
- omitIfEmpty?: boolean;
1210
- }[];
1211
- /** @description Variables needed to make calls to the data source */
1212
- variables?: {
1213
- [key: string]: components$q["schemas"]["DataVariableDefinition"];
1214
- };
1215
- };
1216
- /**
1217
- * @description An instance of a data source (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset").
1218
- * These are created in the UI and shared across a whole project.
1219
- * NOTE: If you acquire a list of data sources or do not have manage permissions, you will receive "SECRET"
1220
- * for all header, parameter, and variable values to obscure the actual encrypted secret value
1221
- */
1222
- DataSource: {
1223
- /** @description Public ID of the data source */
1224
- id: string;
1225
- /** @description Display name of the data source */
1226
- displayName: string;
1227
- /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an installed integration) */
1228
- connectorType: string;
1229
- /** @description Base resource URL of the data source. No trailing slash */
1230
- baseUrl: string;
1231
- /** @description HTTP headers to pass with requests to the data source */
1232
- headers?: {
1233
- key: string;
1234
- value: string;
1235
- }[];
1236
- /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data source, overriding identical keys */
1237
- parameters?: {
1238
- key: string;
1239
- value: string;
1240
- }[];
1241
- /** @description Variables needed to make calls to the data source */
1242
- variables?: {
1243
- [key: string]: components$q["schemas"]["DataVariableDefinition"];
1244
- };
1245
- /**
1246
- * @description Mapping of locale codes to data source locale codes. Keys are Uniform locale codes, values are data source locale codes.
1247
- * If a locale is not mapped, it will be passed through to the data source as-is
1248
- */
1249
- localeMapping?: {
1250
- [key: string]: string;
1251
- };
1252
- /**
1253
- * @description If true, data source will require additional credentials to access unpublished data.
1254
- * If false, no additional data source credentials are required and data resources of this data source won't be able to access unpublished data.
1255
- */
1256
- enableUnpublishedMode?: boolean;
1257
- /** @description Custom configuration accessible to all data connector UIs (data source, data type, and data resource editors) and custom edgehancers. This data should not contain secrets */
1258
- customPublic?: {
1259
- [key: string]: unknown;
1260
- };
1261
- /** @description Custom configuration accessible to the data source editor UI and custom edgehancer that may contain secrets. This cannot be read by the data type or data resource editors */
1262
- custom?: {
1263
- [key: string]: unknown;
1264
- };
1265
- /** @description Different connector detail variants to use in the different contexts like e.g. Unpublished Data */
1266
- variants?: {
1267
- unpublished?: components$q["schemas"]["AlternativeDataSourceData"];
1268
- };
1269
- /** @description Created date of the data source in ISO 8601 format (ignored for writes) */
1270
- created?: string;
1271
- /** @description Last modified date of the data source in ISO 8601 format (ignored for writes) */
1272
- modified?: string;
1273
- /** @description User or API key ID that created the data source (ignored for writes) */
1274
- createdBy?: string;
1275
- /** @description User or API key ID that last modified the data source (ignored for writes) */
1276
- modifiedBy?: string;
1277
- };
1278
- /** @description A specific type of data that a Data Source can provide (i.e. "Recipe", "Recipes List by Tag", "Yelp Reviews of My Restaurant"). These are created in the UI and shared a whole project */
1279
- DataType: {
1280
- /** @description Public ID of the data type */
1281
- id: string;
1282
- /** @description Display name of the data type */
1283
- displayName: string;
1284
- /** @description Public ID of the associated data source */
1285
- dataSourceId: string;
1286
- /**
1287
- * @description A connector-specific archetype for this data type; used to select UI as well as perform any
1288
- * necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
1289
- * no special UI or processing is required
1290
- */
1291
- archetype?: string;
1292
- allowedOnComponents?: string[];
1293
- /** @description Resource path, appended to the data source's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have a leading slash */
1294
- path: string;
1295
- /** @description Time-to-live (in seconds) for the resource data cache */
1296
- ttl?: number;
1297
- /** @description A key for the resource data cache purging */
1298
- purgeKey?: string;
1299
- /** @description URL to a custom badge icon for the Uniform dashboard for this data type. If not set falls back to the data connector or integration icons */
1300
- badgeIconUrl?: string;
1301
- /** @description HTTP headers to pass with requests to the data type. Merged with headers from the data source, overriding identical keys */
1302
- headers?: {
1303
- key: string;
1304
- value: string;
1305
- omitIfEmpty?: boolean;
1306
- }[];
1307
- /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data source, overriding identical keys */
1308
- parameters?: {
1309
- key: string;
1310
- value: string;
1311
- omitIfEmpty?: boolean;
1312
- }[];
1313
- /** @description Body to pass with requests to the data type (ignored unless the method is POST) */
1314
- body?: string;
1315
- /**
1316
- * @description HTTP method to use with requests to the data type
1317
- * @default GET
1318
- * @enum {string}
1319
- */
1320
- method: "GET" | "POST" | "HEAD";
1321
- /** @description Variables needed to make calls to the data type. Merged with variables from the data source, overriding identical keys */
1322
- variables?: {
1323
- [key: string]: components$q["schemas"]["DataVariableDefinition"];
1324
- };
1325
- /** @description Custom configuration specific to the data source being defined */
1326
- custom?: {
1327
- [key: string]: unknown;
1328
- };
1329
- /** @description Created date of the data type in ISO 8601 format (ignored for writes) */
1330
- created?: string;
1331
- /** @description Last modified date of the data type in ISO 8601 format (ignored for writes) */
1332
- modified?: string;
1333
- /** @description User or API key ID that created the data type (ignored for writes) */
1334
- createdBy?: string;
1335
- /** @description User or API key ID that last modified the data type (ignored for writes) */
1336
- modifiedBy?: string;
1337
- };
1338
- /** @description Defines the shape of a data variable on a Data Source or Data Type */
1339
- DataVariableDefinition: {
1340
- /** @description Display name of the data variable */
1341
- displayName?: string;
1342
- /** @description Explanatory text that is provided to the data resource editor to explain what this variable does */
1343
- helpText?: string;
1344
- /**
1345
- * @description Type of the data variable. Optionally used as a point of reference for custom integrations to decide how to render an editor for a variable
1346
- * @default text
1347
- */
1348
- type?: string;
1349
- /** @description Default value of the data variable */
1350
- default: string;
1351
- /** @description Sets the order of the variable when displayed in a list with other variables. If not set, the order defaults to alphabetical with any explicitly set orders first in the list */
1352
- order?: number;
1353
- /**
1354
- * @description An optional arbitrary human readable source identifier to describe where this variable is from.
1355
- * Some user interfaces may group variables by source value, for example 'From URL' or 'My Integration'
1356
- */
1357
- source?: string;
1358
- };
1359
- /**
1360
- * @description Data definitions attached to this component. The property name is the key of the data in the data document.
1361
- * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key)
1362
- */
1363
- DataResourceDefinitions: {
1364
- [key: string]: components$q["schemas"]["DataResourceDefinition"];
1365
- };
1366
- /** @description Defines a data resource, which is a named JSON document, usually from an API response, which may be projected onto parameters */
1367
- DataResourceDefinition: {
1368
- /** @description Public ID of the data type that provides this data */
1369
- type: string;
1370
- /** @description Whether this data is a pattern data resource that can be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false */
1371
- isPatternParameter?: boolean;
1372
- /**
1373
- * @description When true, the default data resource of a pattern data parameter (isPatternParameter=true) will be ignored when the pattern is referenced.
1374
- * Unless specifically overridden, the pattern data parameter will be provided with a null default value - leaving any data connections to it unresolvable.
1375
- * If isPatternParameter is false or undefined, this has no meaning
1376
- */
1377
- ignorePatternParameterDefault?: boolean;
1378
- /**
1379
- * @description When true, the data resource does not create an error forcing the choosing of override value when there is no default.
1380
- * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
1381
- */
1382
- optionalPatternParameter?: boolean;
1383
- variables?: components$q["schemas"]["DataResourceVariables"];
1384
- };
1385
- /** @description Variable values for a data resource */
1386
- DataResourceVariables: {
1387
- [key: string]: string;
1388
- };
1389
- /**
1390
- * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
1391
- * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
1392
- * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, en published yet.
1393
- * Means nothing for PUTs; it will be ignored
1394
- * @enum {string}
1395
- */
1396
- PatternError: "NOTFOUND" | "CYCLIC";
1397
- HistoryApiResponse: {
1398
- /**
1399
- * @description If there are more results, this will be populated with a token to pass in the next request to get the next page of results.
1400
- * If this is undefined then no more results are available
1401
- */
1402
- cursor?: string;
1403
- /** @description If more history is available than your plan allows, and additional entries are available by upgrading, this will be true */
1404
- truncated?: boolean;
1405
- /** @description Version history entries */
1406
- results?: components$q["schemas"]["HistoryEntry"][];
1407
- };
1408
- HistoryEntry: {
1409
- /** @description The version ID of the entity. This can be used to fetch the version's data via the entity API */
1410
- versionId: string;
1411
- /** @description The timestamp when the version was created in epoch milliseconds */
1412
- timestamp: number;
1413
- /** @description The name (full name) of the user who created the version */
1414
- authorName: string;
1415
- authorIsApiKey: boolean;
1416
- /** @description The state of the entity when the history entry was made */
1417
- state: number;
1418
- };
1419
- /** @description Category for tagging canvas entities */
1420
- Category: {
1421
- /**
1422
- * Format: uuid
1423
- * @description Unique identifier for the category
1424
- */
1425
- id: string;
1426
- /** @description Display name of the category */
1427
- name: string;
1428
- /**
1429
- * @description Sets the order of the category when displayed in a list with other categories. If not set, the order defaults to alphabetical with any explicitly set orders first in the list
1430
- * @default 0
1431
- */
1432
- order?: number;
1433
- };
1434
- /** @description Project map node information related to a component */
1435
- CompositionProjectMapNodeInfo: {
1436
- /**
1437
- * Format: uuid
1438
- * @description Unique identifier for the project map node
1439
- */
1440
- id: string;
1441
- /**
1442
- * @description Fallback path of the project map node.
1443
- * Note that the node may have matched via a locale-specific path which is in the `locales` object
1444
- */
1445
- path: string;
1446
- /**
1447
- * Format: uuid
1448
- * @description Unique identifier for the project map that this node belongs to
1449
- */
1450
- projectMapId: string;
1451
- data?: components$q["schemas"]["ProjectMapNodeData"];
1452
- /**
1453
- * @description Locale-specific paths of the project map node.
1454
- * Keys are locale codes
1455
- */
1456
- locales?: {
1457
- [key: string]: {
1458
- /** @description Locale-specific path of the project map node */
1459
- path: string;
1460
- /** @description Whether the path is inherited from a parent node which defined a path segment in this locale */
1461
- inherited: boolean;
1462
- };
1463
- };
1464
- };
1465
- /** @description AI Prompt definition */
1466
- Prompt: {
1467
- /**
1468
- * Format: uuid
1469
- * @description Unique identifier for the prompt
1470
- */
1471
- id: string;
1472
- /** @description Unique identifier for the integration that this prompt belongs to */
1473
- integrationType: string;
1474
- /** @description Name for the prompt */
1475
- name?: string | null;
1476
- /** @description Text for the prompt */
1477
- text?: string | null;
1478
- /** @description Data for the prompt */
1479
- data?: {
1480
- [key: string]: unknown;
1481
- } | null;
1482
- /** @description Turn off/on prompt */
1483
- enabled?: boolean | null;
1484
- /** @description Integration default prompt */
1485
- builtIn?: boolean | null;
1486
- /** @description Supported parameter types */
1487
- parameterTypes?: string[] | null;
1488
- };
1489
- /** @description Definition of a workflow that can be assigned to entities */
1490
- WorkflowDefinition: {
1491
- /**
1492
- * Format: uuid
1493
- * @description Unique identifier of the workflow definition
1494
- */
1495
- id: string;
1496
- /** @description Workflow name */
1497
- name: string;
1498
- /**
1499
- * Format: uuid
1500
- * @description The ID of the initial stage in the stages object.
1501
- */
1502
- initialStage: string;
1503
- /** @description All stages of the workflow */
1504
- stages: {
1505
- [key: string]: components$q["schemas"]["WorkflowStage"];
1506
- };
1507
- /** @description Last modified ISO date string for this definition (ignored for writes) */
1508
- modified?: string;
1509
- /** @description Created ISO date string for this definition (ignored for writes) */
1510
- created?: string;
1511
- /**
1512
- * @description Name of the original creator of the workflow.
1513
- * If undefined, the user has been removed from the team.
1514
- * Ignored for writes
1515
- */
1516
- createdBy?: string;
1517
- /**
1518
- * @description Name of the last modifier of the workflow.
1519
- * If undefined, the user has been removed from the team.
1520
- * Ignored for writes
1521
- */
1522
- modifiedBy?: string;
1523
- };
1524
- /** @description Definition of a stage in a workflow */
1525
- WorkflowStage: {
1526
- /** @description Name of the stage */
1527
- name: string;
1528
- /**
1529
- * @description Defines roles which have permissions to this workflow stage
1530
- * NOTE: Being able to write or publish to entities in a workflow stage requires both core write or publish permissions,
1531
- * as well as membership in a role which grants the explicit rights to the stage. If a user is not a member of any role
1532
- * listed here, the stage is read-only and publishing is disabled
1533
- */
1534
- permissions: {
1535
- [key: string]: components$q["schemas"]["WorkflowStagePermission"];
1536
- };
1537
- /**
1538
- * @description When true, transitioning into this stage from a different stage will automatically publish the entity.
1539
- * If the user making the transition does not have publish permissions to the stage as well as publish permission on the entity, the action will not run.
1540
- * Setting this to true is equivalent to setting requireValidity to true, as publishing cannot be performed with validation errors.
1541
- * NOTE: This is not executed by direct API calls. Only the Uniform UI performs this action
1542
- */
1543
- autoPublish?: boolean;
1544
- /**
1545
- * @description When true, transitioning into this stage from a different stage will require the entity to have no validation errors.
1546
- * If the entity is not valid, the transition will not be allowed.
1547
- * NOTE: This is not executed by direct API calls. Only the Uniform UI performs this action
1548
- */
1549
- requireValidity?: boolean;
1550
- /**
1551
- * @description Defines transitions to other stages
1552
- * Every stage must define at least one transition, to avoid creating a workflow that
1553
- * has a stage that can never be escaped
1554
- */
1555
- transitions: components$q["schemas"]["WorkflowStageTransition"][];
1556
- /**
1557
- * @description Icon name for the stage (e.g. 'chevron-double-right-o')
1558
- * @default chevron-double-right-o
1559
- */
1560
- icon?: string;
1561
- /** @description Sets the order of the stage when displayed in a list with other stages. If not set, the order defaults to alphabetical with any explicitly set orders first in the list */
1562
- order?: number;
1563
- };
1564
- /** @description Definition of a transition from one stage to another in a workflow */
1565
- WorkflowStageTransition: {
1566
- /**
1567
- * Format: uuid
1568
- * @description The target stage to transition to
1569
- */
1570
- to: string;
1571
- /**
1572
- * @description Name shown to the user when they execute this transition.
1573
- * If not provided, a default name will be assigned automatically based on the target stage
1574
- */
1575
- name: string;
1576
- /**
1577
- * @description Permissions for the stage transition.
1578
- * NOTE: Users without membership in any role listed here will be unable to execute the transition unless they are team admins
1118
+ * @description Permissions for the stage transition.
1119
+ * NOTE: Users without membership in any role listed here will be unable to execute the transition unless they are team admins
1579
1120
  */
1580
1121
  permissions: {
1581
1122
  [key: string]: components$q["schemas"]["WorkflowStageTransitionPermission"];
@@ -1639,96 +1180,45 @@ interface components$q {
1639
1180
  pathItems: never;
1640
1181
  }
1641
1182
 
1642
- /**
1643
- * Data projection wire grammar (`select.*` query parameters) and shared spec
1644
- * type used by every consumer of projections: API serializers (SDK clients),
1645
- * the origin pruner (lib/canvas-sdk applyProjection), and localize (for the
1646
- * representation-modifier operator `fields[locales]`).
1647
- *
1648
- * Wire grammar (mirrors `filters.*`):
1649
- *
1650
- * select.fields[only]=name,seo_*
1651
- * select.fields[except]=internalNote
1652
- * select.fields[only]= // strip every field
1653
- * select.fields[except]=* // strip every field (wildcard form)
1654
- * select.fields[locales]=slug,seo_*
1655
- * select.fieldTypes[only]=text,number
1656
- * select.fieldTypes[except]=richText
1657
- * select.slots[only]=hero
1658
- * select.slots[except]=footer
1659
- * select.slots[depth]=2
1660
- * select.slots.<name>[depth]=1
1661
- * select.fields[blockDepth]=2
1662
- * select.fields[blockDepth]=preserveAll
1663
- */
1664
- /**
1665
- * Prefix used by every `select.*` query parameter on the wire. Exported so
1666
- * downstream prefix scans (lambda validator, edge search-param reader,
1667
- * origin handler short-circuits) and key builders don't hand-roll the
1668
- * literal at every call site.
1669
- */
1670
- declare const SELECT_QUERY_PREFIX = "select.";
1671
- type FieldsProjection = {
1672
- /** Include only fields whose name matches one of these patterns. */
1673
- only?: string[];
1674
- /** Exclude fields whose name matches one of these patterns. */
1675
- except?: string[];
1676
- /**
1677
- * Field-name patterns whose value should retain its full per-locale map
1678
- * (`locales` / `localesConditions`) after `localize` runs. Representation
1679
- * modifier; the pruner ignores this — see lib/canvas-sdk applyProjection.
1680
- */
1681
- locales?: string[];
1682
- /**
1683
- * Controls how far projection descends into block-typed fields (`$block`).
1684
- * A block field's value is an array of structured content, each with its own
1685
- * fields, so projection can recurse into it like any other node.
1686
- *
1687
- * - Omitted (default): projection descends into blocks without limit,
1688
- * applying `only`/`except` at every block level.
1689
- * - A non-negative integer `N`: keep block nesting up to `N` levels. Block
1690
- * fields on a node at depth `>= N` are dropped; `only`/`except` still
1691
- * apply within the levels that are kept. `0` removes every block-typed
1692
- * field; `1` keeps top-level blocks but not blocks nested inside them.
1693
- * - `'preserveAll'`: Projection does not evaluate within blocks at all:
1694
- * `only`/`except` do not apply to fields within blocks. The top level block field
1695
- * is still subject to projection rules, but its descendants are not.
1696
- */
1697
- blockDepth?: number | 'preserveAll';
1698
- };
1699
- type FieldTypesProjection = {
1700
- /** Include only fields whose `type` matches one of these patterns. */
1701
- only?: string[];
1702
- /** Exclude fields whose `type` matches one of these patterns. */
1703
- except?: string[];
1704
- };
1705
- type SlotsProjection = {
1706
- /** Include only slots whose name matches one of these patterns. */
1707
- only?: string[];
1708
- /** Exclude slots whose name matches one of these patterns. */
1709
- except?: string[];
1710
- /**
1711
- * Container-wide recursion-depth cap counted in slot levels from the root.
1712
- * 0 means "no slots at all on the root"; 1 means "root's own slots but no
1713
- * grandchildren slots". Per-name depth (see `named`) overrides this for
1714
- * its specific slot.
1715
- */
1716
- depth?: number;
1717
- /** Per-slot depth caps. Keyed by slot name. */
1718
- named?: {
1719
- [slotName: string]: {
1720
- depth?: number;
1721
- };
1722
- };
1723
- };
1724
- type ProjectionSpec = {
1725
- fields?: FieldsProjection;
1726
- fieldTypes?: FieldTypesProjection;
1727
- slots?: SlotsProjection;
1728
- };
1183
+ type SharedComponents$3 = components$q['schemas'];
1184
+ type Api$2 = paths$n['/api/v1/categories'];
1185
+ /** Shape of the GET response from /api/v1/category */
1186
+ type CategoriesGetResponse = Api$2['get']['responses']['200']['content']['application/json'];
1187
+ /** Shape of the PUT request body for /api/v1/category */
1188
+ type CategoriesPutParameters = Api$2['put']['requestBody']['content']['application/json'];
1189
+ /** Shape of the DELETE request body for /api/v1/category */
1190
+ type CategoriesDeleteParameters = Api$2['delete']['requestBody']['content']['application/json'];
1191
+ /** Query parameter options for GET /api/v1/category */
1192
+ type CategoriesGetParameters = Api$2['get']['parameters']['query'];
1193
+ /** Defines a component type that can live on a Composition */
1194
+ type Category = SharedComponents$3['Category'];
1195
+
1196
+ declare class CategoryClient extends ApiClient {
1197
+ constructor(options: ClientOptions);
1198
+ /** Fetches a list of categories created in given project */
1199
+ list(options?: Omit<CategoriesGetParameters, 'projectId'>): Promise<{
1200
+ categories: components$r["schemas"]["Category"][];
1201
+ }>;
1202
+ /** @deprecated Use {@link list} instead. */
1203
+ getCategories(options?: Omit<CategoriesGetParameters, 'projectId'>): Promise<{
1204
+ categories: components$r["schemas"]["Category"][];
1205
+ }>;
1206
+ /** Updates or creates a category, also used to re-order them */
1207
+ save(categories: CategoriesPutParameters['categories']): Promise<unknown>;
1208
+ /** @deprecated Use {@link save} instead. */
1209
+ upsertCategories(categories: CategoriesPutParameters['categories']): Promise<unknown>;
1210
+ /** Deletes a category */
1211
+ remove(options: Omit<CategoriesDeleteParameters, 'projectId'>): Promise<unknown>;
1212
+ /** @deprecated Use {@link remove} instead. */
1213
+ removeCategory(options: Omit<CategoriesDeleteParameters, 'projectId'>): Promise<unknown>;
1214
+ }
1215
+ /** @deprecated Pass `bypassCache: true` to {@link CategoryClient} instead. */
1216
+ declare class UncachedCategoryClient extends CategoryClient {
1217
+ constructor(options: Omit<ClientOptions, 'bypassCache'>);
1218
+ }
1729
1219
 
1730
1220
  interface paths$m {
1731
- "/api/v1/categories": {
1221
+ "/api/v1/canvas-definitions": {
1732
1222
  parameters: {
1733
1223
  query?: never;
1734
1224
  header?: never;
@@ -1738,24 +1228,108 @@ interface paths$m {
1738
1228
  get: {
1739
1229
  parameters: {
1740
1230
  query: {
1231
+ /** @description The project ID to get component definitions for */
1741
1232
  projectId: string;
1233
+ /** @description Limit the list to one result by ID (response remains an array) */
1234
+ componentId?: string;
1235
+ /** @description Number of records to skip */
1236
+ offset?: number;
1237
+ /** @description Maximum number of records to return */
1238
+ limit?: number;
1239
+ /** @description Whether to fetch system meta-component definitions (personalize, test, etc.) */
1240
+ includeSystem?: boolean;
1241
+ /** @description Filter by category ID */
1242
+ categories?: string[];
1243
+ };
1244
+ header?: never;
1245
+ path?: never;
1246
+ cookie?: never;
1247
+ };
1248
+ requestBody?: never;
1249
+ responses: {
1250
+ /** @description OK */
1251
+ 200: {
1252
+ headers: {
1253
+ [name: string]: unknown;
1254
+ };
1255
+ content: {
1256
+ "application/json": {
1257
+ /** @description Component definitions that match the query */
1258
+ componentDefinitions: components$p["schemas"]["ComponentDefinition"][];
1259
+ };
1260
+ };
1261
+ };
1262
+ 400: components$p["responses"]["BadRequestError"];
1263
+ 401: components$p["responses"]["UnauthorizedError"];
1264
+ 403: components$p["responses"]["ForbiddenError"];
1265
+ 429: components$p["responses"]["RateLimitError"];
1266
+ 500: components$p["responses"]["InternalServerError"];
1267
+ };
1268
+ };
1269
+ /** @description Upserts a component definition */
1270
+ put: {
1271
+ parameters: {
1272
+ query?: never;
1273
+ header?: never;
1274
+ path?: never;
1275
+ cookie?: never;
1276
+ };
1277
+ requestBody: {
1278
+ content: {
1279
+ "application/json": {
1280
+ /**
1281
+ * Format: uuid
1282
+ * @description The project ID to upsert the component definition to
1283
+ */
1284
+ projectId: string;
1285
+ componentDefinition: components$p["schemas"]["ComponentDefinition"];
1286
+ };
1287
+ };
1288
+ };
1289
+ responses: {
1290
+ /** @description OK */
1291
+ 204: {
1292
+ headers: {
1293
+ [name: string]: unknown;
1294
+ };
1295
+ content?: never;
1742
1296
  };
1297
+ 400: components$p["responses"]["BadRequestError"];
1298
+ 401: components$p["responses"]["UnauthorizedError"];
1299
+ 403: components$p["responses"]["ForbiddenError"];
1300
+ 429: components$p["responses"]["RateLimitError"];
1301
+ 500: components$p["responses"]["InternalServerError"];
1302
+ };
1303
+ };
1304
+ post?: never;
1305
+ /** @description Deletes a component definition */
1306
+ delete: {
1307
+ parameters: {
1308
+ query?: never;
1743
1309
  header?: never;
1744
1310
  path?: never;
1745
1311
  cookie?: never;
1746
1312
  };
1747
- requestBody?: never;
1313
+ requestBody: {
1314
+ content: {
1315
+ "application/json": {
1316
+ /** @description The public ID of the component definition to delete */
1317
+ componentId: string;
1318
+ /**
1319
+ * Format: uuid
1320
+ * @description The project ID the component definition to delete belongs to
1321
+ */
1322
+ projectId: string;
1323
+ };
1324
+ };
1325
+ };
1748
1326
  responses: {
1749
1327
  /** @description OK */
1750
- 200: {
1328
+ 204: {
1751
1329
  headers: {
1752
1330
  [name: string]: unknown;
1753
1331
  };
1754
- content: {
1755
- "application/json": {
1756
- categories: components$p["schemas"]["Category"][];
1757
- };
1758
- };
1332
+ content?: never;
1759
1333
  };
1760
1334
  400: components$p["responses"]["BadRequestError"];
1761
1335
  401: components$p["responses"]["UnauthorizedError"];
@@ -1764,92 +1338,469 @@ interface paths$m {
1764
1338
  500: components$p["responses"]["InternalServerError"];
1765
1339
  };
1766
1340
  };
1767
- put: {
1341
+ /** @description Handles preflight requests. This endpoint allows CORS */
1342
+ options: {
1768
1343
  parameters: {
1769
1344
  query?: never;
1770
1345
  header?: never;
1771
1346
  path?: never;
1772
1347
  cookie?: never;
1773
1348
  };
1774
- requestBody: {
1775
- content: {
1776
- "application/json": {
1777
- /** Format: uuid */
1778
- projectId: string;
1779
- categories: components$p["schemas"]["Category"][];
1780
- };
1781
- };
1349
+ requestBody?: never;
1350
+ responses: {
1351
+ /** @description OK */
1352
+ 204: {
1353
+ headers: {
1354
+ [name: string]: unknown;
1355
+ };
1356
+ content?: never;
1357
+ };
1358
+ };
1359
+ };
1360
+ head?: never;
1361
+ patch?: never;
1362
+ trace?: never;
1363
+ };
1364
+ }
1365
+ interface components$p {
1366
+ schemas: {
1367
+ /** @description Public ID (used in code). Do not change after creation */
1368
+ PublicIdProperty: string;
1369
+ /** @description The definition of a component parameter */
1370
+ ComponentDefinitionParameter: {
1371
+ id: components$p["schemas"]["PublicIdProperty"];
1372
+ /** @description Friendly name of the parameter */
1373
+ name: string;
1374
+ /** @description Appears next to the parameter in the Composition editor */
1375
+ helpText?: string;
1376
+ /** @description Context provided to AI when generating content for this parameter. May also be shown to humans. */
1377
+ guidance?: string;
1378
+ /** @description Type name of the parameter (provided by a Uniform integration) */
1379
+ type: string;
1380
+ /**
1381
+ * @description If true, this property can have locale-specific values. If false or not defined,
1382
+ * this property will have a single value that is shared for all locales
1383
+ */
1384
+ localizable?: boolean;
1385
+ /**
1386
+ * @description When `localizable` is true, this property controls the default localizability of the property.
1387
+ * true - when the property has no existing value, it will be in 'single value' mode and not store locale specific values
1388
+ * false/undefined - when the property has no existing value, it will store separate values for each enabled locale
1389
+ *
1390
+ * If `localized` is false, this has no effect.
1391
+ */
1392
+ notLocalizedByDefault?: boolean;
1393
+ /**
1394
+ * @description Enables creating additional conditional values for the parameter based on criteria such as dynamic inputs.
1395
+ * When combined with a localized value, each locale has independent conditional values.
1396
+ *
1397
+ * When not defined, conditional values are not allowed.
1398
+ */
1399
+ allowConditionalValues?: boolean;
1400
+ /** @description The configuration object for the type (type-specific) */
1401
+ typeConfig?: unknown;
1402
+ };
1403
+ /** @description Permission set for a component definition */
1404
+ ComponentDefinitionPermission: {
1405
+ roleId: components$p["schemas"]["PublicIdProperty"];
1406
+ /**
1407
+ * @description Permission type for this permission ComponentDefinition:
1408
+ * read | write | create | delete
1409
+ * @enum {string}
1410
+ */
1411
+ permission: "read" | "write" | "create" | "delete";
1412
+ /** @description State of the component that this permission applies to */
1413
+ state: number;
1414
+ };
1415
+ /** @description The definition of a named component slot that can contain other components */
1416
+ ComponentDefinitionSlot: {
1417
+ id: components$p["schemas"]["PublicIdProperty"];
1418
+ /** @description Friendly name of the slot */
1419
+ name: string;
1420
+ /** @description A list of component definition public IDs that are allowed in this named slot */
1421
+ allowedComponents: string[];
1422
+ /**
1423
+ * @description Whether this slot inherits its allowed components from the parent slot it lives in. If true, `allowedComponents` is irrelevant.
1424
+ * If `allowAllComponents` is true, this value is ignored
1425
+ * @default false
1426
+ */
1427
+ inheritAllowedComponents: boolean;
1428
+ /**
1429
+ * @description When false or not defined, only components in `allowedComponents` may be added to this slot - and if `allowedComponents` is empty, nothing can be added.
1430
+ * When true, every component and pattern that is defined may be added to this slot regardless of any other setting including `inheritAllowedComponents`
1431
+ */
1432
+ allowAllComponents?: boolean;
1433
+ /**
1434
+ * @description When not defined, or false: all patterns for components listed in `allowedComponents` are automatically allowed in the slot.
1435
+ * When true: patterns for components listed in `allowedComponents` are not allowed in the slot unless explicitly added to `allowedComponents` as `$p:<patternid>`
1436
+ */
1437
+ patternsInAllowedComponents?: boolean;
1438
+ /** @description Minimum valid number of components in this slot */
1439
+ minComponents?: number;
1440
+ /** @description Maximum valid number of components in this slot */
1441
+ maxComponents?: number;
1442
+ };
1443
+ /** @description The definition of a composition's slug settings */
1444
+ ComponentDefinitionSlugSettings: {
1445
+ /**
1446
+ * @description Whether the slug is required
1447
+ * no: slug is optional
1448
+ * yes: slug is required
1449
+ * disabled: slug is disabled and will not be shown in the editor
1450
+ * @default no
1451
+ * @enum {string}
1452
+ */
1453
+ required?: "no" | "yes" | "disabled";
1454
+ /**
1455
+ * @description Slug uniqueness configuration.
1456
+ * no = no unique constraint
1457
+ * local = must be unique within this component type
1458
+ * global = must be unique across all component types
1459
+ * @enum {string}
1460
+ */
1461
+ unique?: "no" | "local" | "global";
1462
+ /** @description Regular expression slugs must match */
1463
+ regularExpression?: string;
1464
+ /**
1465
+ * @description Custom error message when regular expression validation fails.
1466
+ * Has no effect if `regularExpression` is not set
1467
+ */
1468
+ regularExpressionMessage?: string;
1469
+ };
1470
+ /** @description Defines a connection to a dynamic token on a data resource */
1471
+ DataElementConnectionDefinition: {
1472
+ /** @description A JSON Pointer expression that defines the data resource dynamic token value */
1473
+ pointer: string;
1474
+ /**
1475
+ * @description The syntax used to select the dynamic token to bind to
1476
+ * @enum {string}
1477
+ */
1478
+ syntax: "jptr";
1479
+ /**
1480
+ * @description The action to take if the dynamic token cannot be resolved
1481
+ * - t: TOKEN: Removes the failed dynamic token value, leaving the rest of the property value, if any, intact [default]
1482
+ * NOTE: If the _only_ value in the property is a dynamic token, the property value is removed (as with 'p' below)
1483
+ * NOTE: If the _failureDefault_ property is also set, that default value will be used instead of removing the token.
1484
+ * this only applies when the failureAction is 't' or undefined, the default is otherwise ignored
1485
+ * - p: PROPERTY: Removes the entire property value, including any other dynamic tokens or static values in the property
1486
+ * - c: COMPONENT: Removes the whole parent component or block that contains the property.
1487
+ * NOTE: If a 'component' failure occurs on the root component of a composition, or an entry,
1488
+ * it is treated as an 'a' failure because removing the root means we must remove all
1489
+ * - a: ALL: Fails the whole entry or composition. This will result in the item returning a 404 from APIs, and being removed from API list responses
1490
+ * @enum {string}
1491
+ */
1492
+ failureAction?: "t" | "p" | "c" | "a";
1493
+ /**
1494
+ * @description How to report when the dynamic token cannot be resolved
1495
+ * - e: ERROR: Report an error message (this will prevent publishing)
1496
+ * - w: WARNING: Report a warning message [default]
1497
+ * - i: INFO: Log an informative message (failure is expected/normal, i.e. optional data)
1498
+ * @enum {string}
1499
+ */
1500
+ failureLogLevel?: "e" | "w" | "i";
1501
+ /**
1502
+ * @description The default value to use if the dynamic token cannot be resolved.
1503
+ * This is only used if the failureAction is the default (undefined, or explicitly token)
1504
+ */
1505
+ failureDefault?: string;
1506
+ };
1507
+ /**
1508
+ * @deprecated
1509
+ * @description beta functionality subject to change
1510
+ */
1511
+ VisibilityCriteria: {
1512
+ /** @description The rule type to execute */
1513
+ rule: string;
1514
+ /**
1515
+ * @description The source value of the rule.
1516
+ * For rules which have multiple classes of match, for example a dynamic input matches on a named DI, the rule is dynamic input and the DI name is the source.
1517
+ */
1518
+ source?: string;
1519
+ /** @description The rule-definition-specific operator to test against */
1520
+ op: string;
1521
+ /** @description The value, or if an array several potential values, to test against. In most rules, multiple values are OR'd together ('any of') but this is not a hard requirement. */
1522
+ value: string | string[];
1523
+ };
1524
+ /**
1525
+ * @deprecated
1526
+ * @description beta functionality subject to change
1527
+ */
1528
+ VisibilityCriteriaGroup: {
1529
+ /**
1530
+ * @description The boolean operator to join the clauses with. Defaults to & if not specified.
1531
+ * @enum {string}
1532
+ */
1533
+ op?: "&" | "|";
1534
+ clauses: (components$p["schemas"]["VisibilityCriteria"] | components$p["schemas"]["VisibilityCriteriaGroup"])[];
1535
+ };
1536
+ /** @description Defines a conditional value for a component parameter */
1537
+ ComponentParameterConditionalValue: {
1538
+ when: components$p["schemas"]["VisibilityCriteriaGroup"];
1539
+ /**
1540
+ * @description The value of the parameter. Any JSON-serializable value is acceptable.
1541
+ * A value of `null` will cause the parameter value to be removed, if it matches.
1542
+ */
1543
+ value: unknown;
1544
+ /**
1545
+ * @description Unique sequence identifier of the conditional value within the component parameter.
1546
+ * This value must be unique within the conditional values array, and it should not change after a condition is created.
1547
+ */
1548
+ id: number;
1549
+ };
1550
+ /**
1551
+ * @description Array of alternate values which are based on conditions.
1552
+ *
1553
+ * When requested with an explicit locale parameter, or via the route API:
1554
+ * * Conditions are evaluated sequentially and the first match is used. If a match is found, the conditions are eliminated.
1555
+ * * If no conditions match, the `value` property is used.
1556
+ * * If a condition cannot be evaluated yet (i.e. a client-side criteria), it is left alone.
1557
+ *
1558
+ * When no locale is passed to a non-route API, conditions are not processed and all conditions are returned.
1559
+ */
1560
+ ComponentParameterConditions: components$p["schemas"]["ComponentParameterConditionalValue"][];
1561
+ /** @description Defines an editable parameter on a component */
1562
+ ComponentParameter: {
1563
+ /** @description The value of the parameter. Any JSON-serializable value is acceptable */
1564
+ value?: unknown;
1565
+ /** @description The type of the parameter. Determines how it is displayed when editing and tells the consumer how to process it */
1566
+ type: string;
1567
+ /** @deprecated */
1568
+ connectedData?: components$p["schemas"]["DataElementConnectionDefinition"];
1569
+ /**
1570
+ * @description Locale-specific values for this parameter. Keys are locale codes, and values are the `value` in that locale.
1571
+ * Note that locales must be registered on the entry/composition `_locales` before being used
1572
+ */
1573
+ locales?: {
1574
+ [key: string]: unknown;
1575
+ };
1576
+ conditions?: components$p["schemas"]["ComponentParameterConditions"];
1577
+ /** @description Locale-specific conditional values for this parameter. Keys are locale codes, and values are the `conditions` for that locale. */
1578
+ localesConditions?: {
1579
+ [key: string]: components$p["schemas"]["ComponentParameterConditions"];
1580
+ };
1581
+ };
1582
+ /** @description Defines the shape of a component instance served by the composition API */
1583
+ ComponentInstance: {
1584
+ /** @description Type of the component instance (public_id of its definition) */
1585
+ type: string;
1586
+ /** @description Component parameter values for the component instance */
1587
+ parameters?: {
1588
+ [key: string]: components$p["schemas"]["ComponentParameter"];
1589
+ };
1590
+ /** @description Public ID of alternate visual appearance for this component, if any selected */
1591
+ variant?: string;
1592
+ /** @description Slots containing any child components */
1593
+ slots?: {
1594
+ [key: string]: components$p["schemas"]["ComponentInstance"][];
1595
+ };
1596
+ /**
1597
+ * @description Unique identifier of the component within the composition.
1598
+ * No assumptions should be made about the format of this value other than "it will be unique."
1599
+ * This is not returned in GET replies unless specifically requested via `withComponentIDs` API parameter.
1600
+ * When updating or creating a composition, if you do not specify an _id for each component, one will be created and stored for you
1601
+ */
1602
+ _id?: string;
1603
+ /** @description Indicates this component instance should be sourced from a pattern library pattern */
1604
+ _pattern?: string;
1605
+ _dataResources?: components$p["schemas"]["DataResourceDefinitions"];
1606
+ /**
1607
+ * @description Data definitions coming from a pattern resolved for this component. Merged with _dataResources during resolution.
1608
+ * Means nothing for PUTs; it will be ignored
1609
+ */
1610
+ _patternDataResources?: {
1611
+ [key: string]: components$p["schemas"]["DataResourceDefinition"];
1612
+ };
1613
+ _patternError?: components$p["schemas"]["PatternError"];
1614
+ /**
1615
+ * @description Defines patch overrides to component IDs that live in the composition.
1616
+ * This can be used to override parameters that are defined on patterns,
1617
+ * including nested patterns, with values that are specific to this composition.
1618
+ * The keys in this object are component IDs.
1619
+ * Overrides are applied from the top down, so for example if both the composition
1620
+ * and a pattern on the composition define an override on a nested pattern,
1621
+ * the composition's override replaces the pattern's.
1622
+ *
1623
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1624
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
1625
+ */
1626
+ _overrides?: {
1627
+ [key: string]: components$p["schemas"]["ComponentOverride"];
1782
1628
  };
1783
- responses: {
1784
- /** @description OK */
1785
- 204: {
1786
- headers: {
1787
- [name: string]: unknown;
1788
- };
1789
- content?: never;
1790
- };
1791
- 400: components$p["responses"]["BadRequestError"];
1792
- 401: components$p["responses"]["UnauthorizedError"];
1793
- 403: components$p["responses"]["ForbiddenError"];
1794
- 429: components$p["responses"]["RateLimitError"];
1795
- 500: components$p["responses"]["InternalServerError"];
1629
+ /**
1630
+ * @description Overrides coming from a pattern resolved for this component. Merged with _overrides during resolution.
1631
+ * Means nothing for PUTs; it will be ignored
1632
+ */
1633
+ _patternOverrides?: {
1634
+ [key: string]: components$p["schemas"]["ComponentOverride"];
1796
1635
  };
1636
+ /**
1637
+ * @description When used on a pattern, defines how the pattern's parameters may be overridden
1638
+ * by consumers of the pattern.
1639
+ *
1640
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1641
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
1642
+ */
1643
+ _overridability?: components$p["schemas"]["ComponentOverridability"];
1644
+ /** @description Array of locales that have data defined. Only set for pattern references or composition defaults */
1645
+ _locales?: string[];
1797
1646
  };
1798
- post?: never;
1799
- delete: {
1800
- parameters: {
1801
- query?: never;
1802
- header?: never;
1803
- path?: never;
1804
- cookie?: never;
1647
+ /** @description Variable values for a data resource */
1648
+ DataResourceVariables: {
1649
+ [key: string]: string;
1650
+ };
1651
+ /** @description Defines a data resource, which is a named JSON document, usually from an API response, which may be projected onto parameters */
1652
+ DataResourceDefinition: {
1653
+ /** @description Public ID of the data type that provides this data */
1654
+ type: string;
1655
+ /** @description Whether this data is a pattern data resource that can be overridden when a pattern is referenced on another composition. If this is not a pattern composition, this has no meaning and should not be used. If unspecified, the default is false */
1656
+ isPatternParameter?: boolean;
1657
+ /**
1658
+ * @description When true, the default data resource of a pattern data parameter (isPatternParameter=true) will be ignored when the pattern is referenced.
1659
+ * Unless specifically overridden, the pattern data parameter will be provided with a null default value - leaving any data connections to it unresolvable.
1660
+ * If isPatternParameter is false or undefined, this has no meaning
1661
+ */
1662
+ ignorePatternParameterDefault?: boolean;
1663
+ /**
1664
+ * @description When true, the data resource does not create an error forcing the choosing of override value when there is no default.
1665
+ * If isPatternParameter is false or undefined, or if ignorePatternParameterDefault is false, this has no meaning
1666
+ */
1667
+ optionalPatternParameter?: boolean;
1668
+ variables?: components$p["schemas"]["DataResourceVariables"];
1669
+ };
1670
+ /**
1671
+ * @description Data definitions attached to this component. The property name is the key of the data in the data document.
1672
+ * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key)
1673
+ */
1674
+ DataResourceDefinitions: {
1675
+ [key: string]: components$p["schemas"]["DataResourceDefinition"];
1676
+ };
1677
+ /**
1678
+ * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
1679
+ * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
1680
+ * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, en published yet.
1681
+ * Means nothing for PUTs; it will be ignored
1682
+ * @enum {string}
1683
+ */
1684
+ PatternError: "NOTFOUND" | "CYCLIC";
1685
+ /**
1686
+ * @description Defines how to override a specific component.
1687
+ *
1688
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1689
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
1690
+ */
1691
+ ComponentOverride: {
1692
+ parameters?: {
1693
+ [key: string]: components$p["schemas"]["ComponentParameter"];
1805
1694
  };
1806
- requestBody: {
1807
- content: {
1808
- "application/json": {
1809
- /** Format: uuid */
1810
- categoryId: string;
1811
- /** Format: uuid */
1812
- projectId: string;
1813
- };
1814
- };
1695
+ slots?: {
1696
+ [key: string]: components$p["schemas"]["ComponentInstance"][];
1815
1697
  };
1816
- responses: {
1817
- /** @description OK */
1818
- 204: {
1819
- headers: {
1820
- [name: string]: unknown;
1821
- };
1822
- content?: never;
1823
- };
1824
- 400: components$p["responses"]["BadRequestError"];
1825
- 401: components$p["responses"]["UnauthorizedError"];
1826
- 403: components$p["responses"]["ForbiddenError"];
1827
- 429: components$p["responses"]["RateLimitError"];
1828
- 500: components$p["responses"]["InternalServerError"];
1698
+ variant?: string;
1699
+ /**
1700
+ * @description Overrides data resource definitions for a pattern component.
1701
+ * Object keys defined under this property override the corresponding keys in the pattern's data resources.
1702
+ * Overrides defined here replace values in either _dataResources or _patternDataResources on the target component.
1703
+ */
1704
+ dataResources?: {
1705
+ [key: string]: components$p["schemas"]["DataResourceDefinition"];
1829
1706
  };
1830
1707
  };
1831
- options?: never;
1832
- head?: never;
1833
- patch?: never;
1834
- trace?: never;
1835
- };
1836
- }
1837
- interface components$p {
1838
- schemas: {
1839
- /** @description Category for tagging canvas entities */
1840
- Category: {
1708
+ /**
1709
+ * @description Whether a parameter is overridable
1710
+ *
1711
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1712
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
1713
+ * @enum {string}
1714
+ */
1715
+ OverrideOptions: "yes" | "no";
1716
+ /**
1717
+ * @description Defines how a component on a pattern may have its values overridden.
1718
+ * NOTE: Data resources' overridability is defined in the data resource definition, not here.
1719
+ *
1720
+ * NOTE: This is considered an internal data structure and is not guaranteed to be stable.
1721
+ * Future updates that do not break the overrides-applied state of a composition may be made without notice
1722
+ */
1723
+ ComponentOverridability: {
1724
+ /** @description Defines component parameter value overrides. Keys are the parameter public ID */
1725
+ parameters?: {
1726
+ [key: string]: components$p["schemas"]["OverrideOptions"];
1727
+ };
1728
+ /** @description Allows overriding a display variant is allowed if it is defined on the component the pattern is derived from. Default = false */
1729
+ variants?: boolean;
1841
1730
  /**
1842
- * Format: uuid
1843
- * @description Unique identifier for the category
1731
+ * @description If true, parameters that are not overridable will be hidden by default on pattern instances' editors.
1732
+ * If false, all parameters will be shown on pattern instances' editors, but locked parameters will be read-only.
1733
+ * If not set, the default is false
1844
1734
  */
1845
- id: string;
1846
- /** @description Display name of the category */
1735
+ hideLockedParameters?: boolean;
1736
+ };
1737
+ /** @description The definition of a component variant */
1738
+ ComponentDefinitionVariant: {
1739
+ id: components$p["schemas"]["PublicIdProperty"];
1740
+ /** @description Friendly name of the variant */
1741
+ name: string;
1742
+ };
1743
+ /** @description Defines a component type that can live on a Composition */
1744
+ ComponentDefinition: {
1745
+ id: components$p["schemas"]["PublicIdProperty"];
1746
+ /** @description Friendly name of the component definition */
1847
1747
  name: string;
1848
1748
  /**
1849
- * @description Sets the order of the category when displayed in a list with other categories. If not set, the order defaults to alphabetical with any explicitly set orders first in the list
1850
- * @default 0
1749
+ * @description Icon name for the component definition (e.g. 'screen')
1750
+ * @default screen
1851
1751
  */
1852
- order?: number;
1752
+ icon?: string;
1753
+ /**
1754
+ * @description The public ID of the parameter whose value should be used to create a display title for this component in the UI.
1755
+ * The parameter type must support being used as a title parameter for this to work
1756
+ * @default null
1757
+ */
1758
+ titleParameter?: string | null;
1759
+ /**
1760
+ * @description The public ID of the parameter whose value should be used as a thumbnail for compositions of this component in the UI
1761
+ * @default null
1762
+ */
1763
+ thumbnailParameter?: string | null;
1764
+ /**
1765
+ * @description Whether this component type can be the root of a composition. If false, this component is only used within slots on other components
1766
+ * @default false
1767
+ */
1768
+ canBeComposition?: boolean;
1769
+ /** @description The parameters for this component. Parameters are key-value pairs that can be anything from text values to links to CMS entries */
1770
+ parameters?: components$p["schemas"]["ComponentDefinitionParameter"][];
1771
+ /**
1772
+ * Format: uuid
1773
+ * @description Reference to the category this component definition belongs to
1774
+ * @default null
1775
+ */
1776
+ categoryId?: string | null;
1777
+ /** @description Description of the component definition */
1778
+ description?: string;
1779
+ /** @description Preview image URL for the component definition (shown in the UI) */
1780
+ previewImageUrl?: string;
1781
+ /**
1782
+ * @description if this component uses team permissions or custom permissions
1783
+ * @default true
1784
+ */
1785
+ useTeamPermissions?: boolean;
1786
+ /** @description Custom role permissions for this component definition */
1787
+ permissions?: components$p["schemas"]["ComponentDefinitionPermission"][];
1788
+ /** @description The named slots for this component; placement areas where arrays of other components can be added */
1789
+ slots?: components$p["schemas"]["ComponentDefinitionSlot"][];
1790
+ slugSettings?: components$p["schemas"]["ComponentDefinitionSlugSettings"];
1791
+ /** @description Default component instance value */
1792
+ defaults?: components$p["schemas"]["ComponentInstance"] | null;
1793
+ /** @description Named variants for this component; enables the creation of visual variants that use the same parameter data */
1794
+ variants?: components$p["schemas"]["ComponentDefinitionVariant"][];
1795
+ /** @description Created date string for this definition (ignored for writes) */
1796
+ created?: string;
1797
+ /** @description Last modified date string for this definition (ignored for writes) */
1798
+ updated?: string;
1799
+ /**
1800
+ * Format: uuid
1801
+ * @description ID of the workflow that instances of this component definition will use by default. When not set, no workflow is attached
1802
+ */
1803
+ workflowId?: string;
1853
1804
  };
1854
1805
  Error: {
1855
1806
  /** @description Error message(s) that occurred while processing the request */
@@ -1905,21 +1856,8 @@ interface components$p {
1905
1856
  pathItems: never;
1906
1857
  }
1907
1858
 
1908
- type SharedComponents$3 = components$q['schemas'];
1909
- type Api$2 = paths$m['/api/v1/categories'];
1910
- /** Shape of the GET response from /api/v1/category */
1911
- type CategoriesGetResponse = Api$2['get']['responses']['200']['content']['application/json'];
1912
- /** Shape of the PUT request body for /api/v1/category */
1913
- type CategoriesPutParameters = Api$2['put']['requestBody']['content']['application/json'];
1914
- /** Shape of the DELETE request body for /api/v1/category */
1915
- type CategoriesDeleteParameters = Api$2['delete']['requestBody']['content']['application/json'];
1916
- /** Query parameter options for GET /api/v1/category */
1917
- type CategoriesGetParameters = Api$2['get']['parameters']['query'];
1918
- /** Defines a component type that can live on a Composition */
1919
- type Category = SharedComponents$3['Category'];
1920
-
1921
1859
  type SharedComponents$2 = components$q['schemas'];
1922
- type Api$1 = paths$n['/api/v1/canvas-definitions'];
1860
+ type Api$1 = paths$m['/api/v1/canvas-definitions'];
1923
1861
  /** Shape of the GET response from /api/v1/canvas-definitions */
1924
1862
  type ComponentDefinitionGetResponse = Api$1['get']['responses']['200']['content']['application/json'];
1925
1863
  /** Shape of the PUT request body for /api/v1/canvas-definitions */
@@ -1943,6 +1881,31 @@ type ComponentDefinitionPermission = SharedComponents$2['ComponentDefinitionPerm
1943
1881
  /** Defines a component type that can live on a Composition */
1944
1882
  type ComponentDefinition = SharedComponents$2['ComponentDefinition'];
1945
1883
 
1884
+ /**
1885
+ * Internal base for the canvas content clients: applies a default limit policy
1886
+ * and the per-client `bypassCache` default. Not exported from the package surface.
1887
+ */
1888
+ declare abstract class ContentClientBase extends ApiClient<ClientOptions> {
1889
+ protected constructor(options: ClientOptions, defaultBypassCache: boolean);
1890
+ }
1891
+
1892
+ /**
1893
+ * Management client for component definitions.
1894
+ */
1895
+ declare class ComponentDefinitionClient extends ContentClientBase {
1896
+ constructor(options: ClientOptions);
1897
+ /** Fetches one component definition by id (throws `ApiClientError(404)` if absent). */
1898
+ get(args: {
1899
+ componentId: string;
1900
+ }): Promise<ComponentDefinition>;
1901
+ /** Fetches a list of component definitions. */
1902
+ list(args?: ExceptProject<ComponentDefinitionGetParameters>): Promise<ComponentDefinitionGetResponse>;
1903
+ /** Creates or updates a component definition. */
1904
+ save(def: ExceptProject<ComponentDefinitionPutParameters>): Promise<void>;
1905
+ /** Deletes a component definition. */
1906
+ remove(args: ExceptProject<ComponentDefinitionDeleteParameters>): Promise<void>;
1907
+ }
1908
+
1946
1909
  /** Public ID of Canvas personalization component type */
1947
1910
  declare const CANVAS_PERSONALIZE_TYPE = "$personalization";
1948
1911
  /** Public ID of Canvas A/B test component type */
@@ -2698,7 +2661,9 @@ interface components$o {
2698
2661
  withWorkflowDefinition: boolean;
2699
2662
  /**
2700
2663
  * @description If true the `_id` unique identifier of blocks will be part of the response data.
2701
- * If false, the `_id` will not be present in the API response
2664
+ * If false, the `_id` will not be present in the API response.
2665
+ * Note: the default value depends on the `format`: true for editor or canonical, false for delivery or when no format is specified.
2666
+ * Prefer selecting a `format` rather than using this option.
2702
2667
  */
2703
2668
  withComponentIDs: boolean;
2704
2669
  /**
@@ -2718,16 +2683,33 @@ interface components$o {
2718
2683
  withTotalCount: boolean;
2719
2684
  /** @description Performs keyword search on the entries */
2720
2685
  keyword: string;
2686
+ /**
2687
+ * @description Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
2688
+ * skipOverridesResolution, withComponentIDs) overrides this alias.
2689
+ * - `canonical`: PUT-safe structure — patterns and overrides left
2690
+ * unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
2691
+ * (skipPatternResolution=true, skipOverridesResolution=true,
2692
+ * withComponentIDs=true).
2693
+ * - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
2694
+ * the expanded pattern nodes.
2695
+ * - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
2696
+ * and component `_id`s removed.
2697
+ */
2698
+ format: "canonical" | "editor" | "delivery";
2721
2699
  /**
2722
2700
  * @description If true, any pattern references in the composition will be left unresolved.
2723
2701
  * This is appropriate if you intend to serialize the composition without patterns
2724
- * embedded into it, and serialize the pattern data separately
2702
+ * embedded into it, and serialize the pattern data separately.
2703
+ * Default: true when `format` is canonical. False otherwise
2704
+ * Prefer selecting a `format` rather than using this option.
2725
2705
  */
2726
2706
  skipPatternResolution: boolean;
2727
2707
  /**
2728
2708
  * @description If true, any pattern override data is not resolved by the API.
2729
2709
  * This is intended for internal use in the Canvas editor, and should not be used.
2730
- * Passing this parameter automatically implies withComponentIDs to be true
2710
+ * Passing this parameter automatically implies withComponentIDs to be true.
2711
+ * Default: true when `format` is canonical or editor. False otherwise.
2712
+ * Prefer selecting a `format` rather than using this option.
2731
2713
  */
2732
2714
  skipOverridesResolution: boolean;
2733
2715
  /**
@@ -2827,6 +2809,8 @@ interface paths$l {
2827
2809
  limit?: number;
2828
2810
  /** @description Limit the types of content type to return. If not specified, both block types and content types are returned */
2829
2811
  type?: "block" | "contentType";
2812
+ /** @description Limit the response to the content types (or block types) matching these public IDs. */
2813
+ contentTypeIDs?: string[];
2830
2814
  };
2831
2815
  header?: never;
2832
2816
  path?: never;
@@ -3324,7 +3308,9 @@ interface paths$k {
3324
3308
  withWorkflowDefinition?: components$m["parameters"]["withWorkflowDefinition"];
3325
3309
  /**
3326
3310
  * @description If true the `_id` unique identifier of blocks will be part of the response data.
3327
- * If false, the `_id` will not be present in the API response
3311
+ * If false, the `_id` will not be present in the API response.
3312
+ * Note: the default value depends on the `format`: true for editor or canonical, false for delivery or when no format is specified.
3313
+ * Prefer selecting a `format` rather than using this option.
3328
3314
  */
3329
3315
  withComponentIDs?: components$m["parameters"]["withComponentIDs"];
3330
3316
  /** @description Performs keyword search on the entries */
@@ -3332,7 +3318,9 @@ interface paths$k {
3332
3318
  /**
3333
3319
  * @description If true, any pattern references in the composition will be left unresolved.
3334
3320
  * This is appropriate if you intend to serialize the composition without patterns
3335
- * embedded into it, and serialize the pattern data separately
3321
+ * embedded into it, and serialize the pattern data separately.
3322
+ * Default: true when `format` is canonical. False otherwise
3323
+ * Prefer selecting a `format` rather than using this option.
3336
3324
  */
3337
3325
  skipPatternResolution?: components$m["parameters"]["skipPatternResolution"];
3338
3326
  /**
@@ -3343,7 +3331,9 @@ interface paths$k {
3343
3331
  /**
3344
3332
  * @description If true, any pattern override data is not resolved by the API.
3345
3333
  * This is intended for internal use in the Canvas editor, and should not be used.
3346
- * Passing this parameter automatically implies withComponentIDs to be true
3334
+ * Passing this parameter automatically implies withComponentIDs to be true.
3335
+ * Default: true when `format` is canonical or editor. False otherwise.
3336
+ * Prefer selecting a `format` rather than using this option.
3347
3337
  */
3348
3338
  skipOverridesResolution?: components$m["parameters"]["skipOverridesResolution"];
3349
3339
  /**
@@ -3398,6 +3388,19 @@ interface paths$k {
3398
3388
  * If versionId is passed, this is always enabled.
3399
3389
  */
3400
3390
  editions?: components$m["parameters"]["editions"];
3391
+ /**
3392
+ * @description Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
3393
+ * skipOverridesResolution, withComponentIDs) overrides this alias.
3394
+ * - `canonical`: PUT-safe structure — patterns and overrides left
3395
+ * unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
3396
+ * (skipPatternResolution=true, skipOverridesResolution=true,
3397
+ * withComponentIDs=true).
3398
+ * - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
3399
+ * the expanded pattern nodes.
3400
+ * - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
3401
+ * and component `_id`s removed.
3402
+ */
3403
+ format?: components$m["parameters"]["format"];
3401
3404
  /**
3402
3405
  * @description Controls filtering of trashed items.
3403
3406
  *
@@ -4322,7 +4325,9 @@ interface components$m {
4322
4325
  withWorkflowDefinition: boolean;
4323
4326
  /**
4324
4327
  * @description If true the `_id` unique identifier of blocks will be part of the response data.
4325
- * If false, the `_id` will not be present in the API response
4328
+ * If false, the `_id` will not be present in the API response.
4329
+ * Note: the default value depends on the `format`: true for editor or canonical, false for delivery or when no format is specified.
4330
+ * Prefer selecting a `format` rather than using this option.
4326
4331
  */
4327
4332
  withComponentIDs: boolean;
4328
4333
  /** @description Performs keyword search on the entries */
@@ -4330,7 +4335,9 @@ interface components$m {
4330
4335
  /**
4331
4336
  * @description If true, any pattern references in the composition will be left unresolved.
4332
4337
  * This is appropriate if you intend to serialize the composition without patterns
4333
- * embedded into it, and serialize the pattern data separately
4338
+ * embedded into it, and serialize the pattern data separately.
4339
+ * Default: true when `format` is canonical. False otherwise
4340
+ * Prefer selecting a `format` rather than using this option.
4334
4341
  */
4335
4342
  skipPatternResolution: boolean;
4336
4343
  /**
@@ -4341,7 +4348,9 @@ interface components$m {
4341
4348
  /**
4342
4349
  * @description If true, any pattern override data is not resolved by the API.
4343
4350
  * This is intended for internal use in the Canvas editor, and should not be used.
4344
- * Passing this parameter automatically implies withComponentIDs to be true
4351
+ * Passing this parameter automatically implies withComponentIDs to be true.
4352
+ * Default: true when `format` is canonical or editor. False otherwise.
4353
+ * Prefer selecting a `format` rather than using this option.
4345
4354
  */
4346
4355
  skipOverridesResolution: boolean;
4347
4356
  /**
@@ -4396,6 +4405,19 @@ interface components$m {
4396
4405
  * If versionId is passed, this is always enabled.
4397
4406
  */
4398
4407
  editions: "auto" | "all" | "raw";
4408
+ /**
4409
+ * @description Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
4410
+ * skipOverridesResolution, withComponentIDs) overrides this alias.
4411
+ * - `canonical`: PUT-safe structure — patterns and overrides left
4412
+ * unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
4413
+ * (skipPatternResolution=true, skipOverridesResolution=true,
4414
+ * withComponentIDs=true).
4415
+ * - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
4416
+ * the expanded pattern nodes.
4417
+ * - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
4418
+ * and component `_id`s removed.
4419
+ */
4420
+ format: "canonical" | "editor" | "delivery";
4399
4421
  /**
4400
4422
  * @description Controls filtering of trashed items.
4401
4423
  *
@@ -4482,9 +4504,11 @@ interface components$l {
4482
4504
  versionId: string;
4483
4505
  /** @description The timestamp when the version was created in epoch milliseconds */
4484
4506
  timestamp: number;
4485
- /** @description The name (full name) of the user who created the version */
4507
+ /** @description The name (full name) of the user who created the version, or "Unknown user" if the author can no longer be resolved */
4486
4508
  authorName: string;
4487
4509
  authorIsApiKey: boolean;
4510
+ /** @description The identity who created the version; absent on old history entries. */
4511
+ authorSubject?: string;
4488
4512
  /** @description The state of the entity when the history entry was made */
4489
4513
  state: number;
4490
4514
  };
@@ -6711,7 +6735,7 @@ interface components$e {
6711
6735
  withComponentIDs: boolean;
6712
6736
  /**
6713
6737
  * @deprecated
6714
- * @description Includes content source map metadata on supported parameters
6738
+ * @description Has no effect.
6715
6739
  */
6716
6740
  withContentSourceMap: boolean;
6717
6741
  /**
@@ -6978,7 +7002,9 @@ interface paths$c {
6978
7002
  /**
6979
7003
  * @description If true, any pattern references in the composition will be left unresolved.
6980
7004
  * This is appropriate if you intend to serialize the composition without patterns
6981
- * embedded into it, and serialize the pattern data separately
7005
+ * embedded into it, and serialize the pattern data separately.
7006
+ * Default: true when `format` is canonical. False otherwise.
7007
+ * Prefer selecting a `format` rather than using this option.
6982
7008
  */
6983
7009
  skipPatternResolution?: components$d["parameters"]["skipPatternResolution"];
6984
7010
  /**
@@ -6989,7 +7015,9 @@ interface paths$c {
6989
7015
  /**
6990
7016
  * @description If true, any pattern override data is not resolved by the API.
6991
7017
  * This is intended for internal use in the Canvas editor and should not be used.
6992
- * Passing this parameter automatically implies `withComponentIDs` is true
7018
+ * Passing this parameter automatically implies `withComponentIDs` is true.
7019
+ * Default: true when `format` is canonical or editor. False otherwise.
7020
+ * Prefer selecting a `format` rather than using this option.
6993
7021
  */
6994
7022
  skipOverridesResolution?: components$d["parameters"]["skipOverridesResolution"];
6995
7023
  /**
@@ -7029,7 +7057,9 @@ interface paths$c {
7029
7057
  updatedBy?: components$d["parameters"]["updatedBy"];
7030
7058
  /**
7031
7059
  * @description If true, the `_id` unique identifier of each non-root component will be part of the response data.
7032
- * If false, the `_id` will not be present in the API response
7060
+ * If false, the `_id` will not be present in the API response.
7061
+ * Note: the default value depends on the `format`: true for editor or canonical, false for delivery or when no format is specified.
7062
+ * Prefer selecting a `format` rather than using this option.
7033
7063
  */
7034
7064
  withComponentIDs?: components$d["parameters"]["withComponentIDs"];
7035
7065
  /**
@@ -7049,7 +7079,7 @@ interface paths$c {
7049
7079
  withProjectMapNodes?: components$d["parameters"]["withProjectMapNodes"];
7050
7080
  /**
7051
7081
  * @deprecated
7052
- * @description Includes content source map metadata on supported parameters
7082
+ * @description Has no effect.
7053
7083
  */
7054
7084
  withContentSourceMap?: components$d["parameters"]["withContentSourceMap"];
7055
7085
  /**
@@ -7106,6 +7136,19 @@ interface paths$c {
7106
7136
  * If versionId is passed, this is always enabled.
7107
7137
  */
7108
7138
  editions?: components$d["parameters"]["editions"];
7139
+ /**
7140
+ * @description Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
7141
+ * skipOverridesResolution, withComponentIDs) overrides this alias.
7142
+ * - `canonical`: PUT-safe structure — patterns and overrides left
7143
+ * unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
7144
+ * (skipPatternResolution=true, skipOverridesResolution=true,
7145
+ * withComponentIDs=true).
7146
+ * - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
7147
+ * the expanded pattern nodes.
7148
+ * - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
7149
+ * and component `_id`s removed.
7150
+ */
7151
+ format?: components$d["parameters"]["format"];
7109
7152
  /**
7110
7153
  * @description Controls filtering of trashed items.
7111
7154
  *
@@ -8067,16 +8110,33 @@ interface components$d {
8067
8110
  * If calling the Canvas API directly with no enhancer proxy, this has no effect
8068
8111
  */
8069
8112
  skipEnhance: boolean;
8113
+ /**
8114
+ * @description Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
8115
+ * skipOverridesResolution, withComponentIDs) overrides this alias.
8116
+ * - `canonical`: PUT-safe structure — patterns and overrides left
8117
+ * unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
8118
+ * (skipPatternResolution=true, skipOverridesResolution=true,
8119
+ * withComponentIDs=true).
8120
+ * - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
8121
+ * the expanded pattern nodes.
8122
+ * - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
8123
+ * and component `_id`s removed.
8124
+ */
8125
+ format: "canonical" | "editor" | "delivery";
8070
8126
  /**
8071
8127
  * @description If true, any pattern references in the composition will be left unresolved.
8072
8128
  * This is appropriate if you intend to serialize the composition without patterns
8073
- * embedded into it, and serialize the pattern data separately
8129
+ * embedded into it, and serialize the pattern data separately.
8130
+ * Default: true when `format` is canonical. False otherwise.
8131
+ * Prefer selecting a `format` rather than using this option.
8074
8132
  */
8075
8133
  skipPatternResolution: boolean;
8076
8134
  /**
8077
8135
  * @description If true, any pattern override data is not resolved by the API.
8078
8136
  * This is intended for internal use in the Canvas editor and should not be used.
8079
- * Passing this parameter automatically implies `withComponentIDs` is true
8137
+ * Passing this parameter automatically implies `withComponentIDs` is true.
8138
+ * Default: true when `format` is canonical or editor. False otherwise.
8139
+ * Prefer selecting a `format` rather than using this option.
8080
8140
  */
8081
8141
  skipOverridesResolution: boolean;
8082
8142
  /**
@@ -8086,7 +8146,9 @@ interface components$d {
8086
8146
  skipParameterResolution: boolean;
8087
8147
  /**
8088
8148
  * @description If true, the `_id` unique identifier of each non-root component will be part of the response data.
8089
- * If false, the `_id` will not be present in the API response
8149
+ * If false, the `_id` will not be present in the API response.
8150
+ * Note: the default value depends on the `format`: true for editor or canonical, false for delivery or when no format is specified.
8151
+ * Prefer selecting a `format` rather than using this option.
8090
8152
  */
8091
8153
  withComponentIDs: boolean;
8092
8154
  /**
@@ -8152,7 +8214,7 @@ interface components$d {
8152
8214
  withProjectMapNodes: boolean;
8153
8215
  /**
8154
8216
  * @deprecated
8155
- * @description Includes content source map metadata on supported parameters
8217
+ * @description Has no effect.
8156
8218
  */
8157
8219
  withContentSourceMap: boolean;
8158
8220
  /**
@@ -8307,9 +8369,11 @@ interface components$c {
8307
8369
  versionId: string;
8308
8370
  /** @description The timestamp when the version was created in epoch milliseconds */
8309
8371
  timestamp: number;
8310
- /** @description The name (full name) of the user who created the version */
8372
+ /** @description The name (full name) of the user who created the version, or "Unknown user" if the author can no longer be resolved */
8311
8373
  authorName: string;
8312
8374
  authorIsApiKey: boolean;
8375
+ /** @description The identity who created the version; absent on old history entries. */
8376
+ authorSubject?: string;
8313
8377
  /** @description The state of the entity when the history entry was made */
8314
8378
  state: number;
8315
8379
  };
@@ -9507,7 +9571,9 @@ interface components$b {
9507
9571
  /**
9508
9572
  * @description If true, any pattern references in the composition will be left unresolved.
9509
9573
  * This is appropriate if you intend to serialize the composition without patterns
9510
- * embedded into it, and serialize the pattern data separately
9574
+ * embedded into it, and serialize the pattern data separately.
9575
+ * Default: true when `format` is canonical. False otherwise.
9576
+ * Prefer selecting a `format` rather than using this option.
9511
9577
  */
9512
9578
  skipPatternResolution: boolean;
9513
9579
  /**
@@ -9539,7 +9605,9 @@ interface components$b {
9539
9605
  updatedBy: string;
9540
9606
  /**
9541
9607
  * @description If true, the `_id` unique identifier of each non-root component will be part of the response data.
9542
- * If false, the `_id` will not be present in the API response
9608
+ * If false, the `_id` will not be present in the API response.
9609
+ * Note: the default value depends on the `format`: true for editor or canonical, false for delivery or when no format is specified.
9610
+ * Prefer selecting a `format` rather than using this option.
9543
9611
  */
9544
9612
  withComponentIDs: boolean;
9545
9613
  /**
@@ -9555,7 +9623,7 @@ interface components$b {
9555
9623
  withUIStatus: boolean;
9556
9624
  /**
9557
9625
  * @deprecated
9558
- * @description Includes content source map metadata on supported parameters
9626
+ * @description Has no effect.
9559
9627
  */
9560
9628
  withContentSourceMap: boolean;
9561
9629
  /**
@@ -9809,7 +9877,7 @@ interface paths$a {
9809
9877
  withComponentIDs?: components$a["parameters"]["withComponentIDs"];
9810
9878
  /**
9811
9879
  * @deprecated
9812
- * @description Includes content source map metadata on supported parameters
9880
+ * @description Has no effect.
9813
9881
  */
9814
9882
  withContentSourceMap?: components$a["parameters"]["withContentSourceMap"];
9815
9883
  /**
@@ -10661,7 +10729,7 @@ interface components$a {
10661
10729
  withComponentIDs: boolean;
10662
10730
  /**
10663
10731
  * @deprecated
10664
- * @description Includes content source map metadata on supported parameters
10732
+ * @description Has no effect.
10665
10733
  */
10666
10734
  withContentSourceMap: boolean;
10667
10735
  /**
@@ -10986,6 +11054,33 @@ type RouteGetResponseEdgehancedNotFound = RouteGetResponseNotFound & {
10986
11054
  compositionApiResponse?: Pick<CompositionResolvedGetResponse, 'errors' | 'warnings' | 'infos' | 'diagnostics' | 'wholeResponseCacheDiagnostics'>;
10987
11055
  };
10988
11056
 
11057
+ /**
11058
+ * Constructor options for the delivery (edge) clients. Adds the edge-only fields
11059
+ * to the shared client options.
11060
+ */
11061
+ type DeliveryClientOptions = ClientOptions & {
11062
+ /** Host used for delivery (edge) reads. Defaults to `https://uniform.global`. */
11063
+ edgeApiHost?: string;
11064
+ /**
11065
+ * When true, skips stale-while-revalidate behavior on data resource caches
11066
+ * May result in increased latency for requests that refetch expired data resources,
11067
+ * but is useful if you are caching responses outside of Uniform and require consistency.
11068
+ */
11069
+ disableSWR?: boolean;
11070
+ };
11071
+ /**
11072
+ * Internal base for the read-only delivery clients: adds edge-host selection,
11073
+ * the SWR header, and diagnostics coercion. Defaults `bypassCache` to false.
11074
+ * Not exported from the package surface.
11075
+ */
11076
+ declare abstract class DeliveryClientBase extends ContentClientBase {
11077
+ protected readonly edgeApiHost: string;
11078
+ protected readonly edgeRequestInit?: RequestInit;
11079
+ protected constructor(options: DeliveryClientOptions);
11080
+ /** Coerces the `diagnostics` option into the shape the edge endpoints accept. */
11081
+ protected coerceDiagnostics(diagnostics?: boolean | 'no-data'): boolean | 'no-data' | undefined;
11082
+ }
11083
+
10989
11084
  type PreviewPanelSettings = {
10990
11085
  isVisualEditingDisabled?: boolean;
10991
11086
  };
@@ -13022,13 +13117,358 @@ type WorkflowsPutParameters = WorkflowsApi['put']['requestBody']['content']['app
13022
13117
  /** Shape of the DELETE request body for /api/v1/workflows */
13023
13118
  type WorkflowsDeleteParameters = WorkflowsApi['delete']['requestBody']['content']['application/json'];
13024
13119
 
13025
- type CanvasClientOptions = ClientOptions & {
13026
- edgeApiHost?: string;
13027
- disableSWR?: boolean;
13120
+ /**
13121
+ * Data projection wire grammar (`select.*` query parameters) and shared spec
13122
+ * type used by every consumer of projections: API serializers (SDK clients),
13123
+ * the origin pruner (lib/canvas-sdk applyProjection), and localize (for the
13124
+ * representation-modifier operator `fields[locales]`).
13125
+ *
13126
+ * Wire grammar (mirrors `filters.*`):
13127
+ *
13128
+ * select.fields[only]=name,seo_*
13129
+ * select.fields[except]=internalNote
13130
+ * select.fields[only]= // strip every field
13131
+ * select.fields[except]=* // strip every field (wildcard form)
13132
+ * select.fields[locales]=slug,seo_*
13133
+ * select.fieldTypes[only]=text,number
13134
+ * select.fieldTypes[except]=richText
13135
+ * select.slots[only]=hero
13136
+ * select.slots[except]=footer
13137
+ * select.slots[depth]=2
13138
+ * select.slots.<name>[depth]=1
13139
+ * select.fields[blockDepth]=2
13140
+ * select.fields[blockDepth]=preserveAll
13141
+ */
13142
+ /**
13143
+ * Prefix used by every `select.*` query parameter on the wire. Exported so
13144
+ * downstream prefix scans (lambda validator, edge search-param reader,
13145
+ * origin handler short-circuits) and key builders don't hand-roll the
13146
+ * literal at every call site.
13147
+ */
13148
+ declare const SELECT_QUERY_PREFIX = "select.";
13149
+ type FieldsProjection = {
13150
+ /** Include only fields whose name matches one of these patterns. */
13151
+ only?: string[];
13152
+ /** Exclude fields whose name matches one of these patterns. */
13153
+ except?: string[];
13154
+ /**
13155
+ * Field-name patterns whose value should retain its full per-locale map
13156
+ * (`locales` / `localesConditions`) after `localize` runs. Representation
13157
+ * modifier; the pruner ignores this — see lib/canvas-sdk applyProjection.
13158
+ */
13159
+ locales?: string[];
13160
+ /**
13161
+ * Controls how far projection descends into block-typed fields (`$block`).
13162
+ * A block field's value is an array of structured content, each with its own
13163
+ * fields, so projection can recurse into it like any other node.
13164
+ *
13165
+ * - Omitted (default): projection descends into blocks without limit,
13166
+ * applying `only`/`except` at every block level.
13167
+ * - A non-negative integer `N`: keep block nesting up to `N` levels. Block
13168
+ * fields on a node at depth `>= N` are dropped; `only`/`except` still
13169
+ * apply within the levels that are kept. `0` removes every block-typed
13170
+ * field; `1` keeps top-level blocks but not blocks nested inside them.
13171
+ * - `'preserveAll'`: Projection does not evaluate within blocks at all:
13172
+ * `only`/`except` do not apply to fields within blocks. The top level block field
13173
+ * is still subject to projection rules, but its descendants are not.
13174
+ */
13175
+ blockDepth?: number | 'preserveAll';
13176
+ };
13177
+ type FieldTypesProjection = {
13178
+ /** Include only fields whose `type` matches one of these patterns. */
13179
+ only?: string[];
13180
+ /** Exclude fields whose `type` matches one of these patterns. */
13181
+ except?: string[];
13182
+ };
13183
+ type SlotsProjection = {
13184
+ /** Include only slots whose name matches one of these patterns. */
13185
+ only?: string[];
13186
+ /** Exclude slots whose name matches one of these patterns. */
13187
+ except?: string[];
13188
+ /**
13189
+ * Container-wide recursion-depth cap counted in slot levels from the root.
13190
+ * 0 means "no slots at all on the root"; 1 means "root's own slots but no
13191
+ * grandchildren slots". Per-name depth (see `named`) overrides this for
13192
+ * its specific slot.
13193
+ */
13194
+ depth?: number;
13195
+ /** Per-slot depth caps. Keyed by slot name. */
13196
+ named?: {
13197
+ [slotName: string]: {
13198
+ depth?: number;
13199
+ };
13200
+ };
13201
+ };
13202
+ type ProjectionSpec = {
13203
+ fields?: FieldsProjection;
13204
+ fieldTypes?: FieldTypesProjection;
13205
+ slots?: SlotsProjection;
13206
+ };
13207
+
13208
+ /**
13209
+ * Optional data projection, shared by delivery + management `get`/`list` for
13210
+ * entries and compositions. Serialized to `select.*` querystring parameters
13211
+ * (mirroring `filters.*`) via `projectionToQuery`; the API prunes the response
13212
+ * tree before any downstream processing (dynamic params, localize, edge-side
13213
+ * data fetches). See {@link ProjectionSpec}.
13214
+ */
13215
+ type Projection = {
13216
+ select?: ProjectionSpec;
13217
+ };
13218
+ /** Lookup keys hoisted into the composition selector unions (so they are not
13219
+ * also accepted in the free-form read-options bag). */
13220
+ type CompositionSelectorKey = 'compositionId' | 'editionId' | 'versionId' | 'slug' | 'projectMapNodeId' | 'projectMapNodePath' | 'projectMapId' | 'componentId';
13221
+ /** Params retired from the new client surface (still accepted by the endpoint). */
13222
+ type CompositionRetiredKey = 'withContentSourceMap' | 'skipEnhance' | 'withWorkflowDefinition';
13223
+ /** `format` is client-owned: management reads use the `'canonical' | 'editor'`
13224
+ * alias (see {@link ManagementFormat}); delivery reads don't send it. */
13225
+ type CompositionClientOwnedKey = 'format';
13226
+ /**
13227
+ * Options shared by composition `get` and `list`, derived from the generated
13228
+ * `/api/v1/canvas` query type. Client-owned keys are removed: `projectId` is
13229
+ * supplied by the client, `editions` is derived per persona, and the selector
13230
+ * lookup keys are hoisted into the selector unions. `state` and the shaping
13231
+ * flags ride along as optional per-call overrides.
13232
+ */
13233
+ type CompositionReadOptions = Omit<CompositionGetParameters, 'projectId' | 'editions' | CompositionSelectorKey | CompositionRetiredKey | CompositionClientOwnedKey> & Projection;
13234
+ /** Edition resolution for composition list reads (lists take no `editionId`). */
13235
+ type ListEditions = {
13236
+ editions?: 'auto' | 'all' | 'raw';
13237
+ };
13238
+ /** Composition `list` query (shared by delivery + management). */
13239
+ type CompositionListQuery = CompositionReadOptions & ListEditions & {
13240
+ /** Structured filters serialized to `filters.*` on the wire. */
13241
+ filters?: CompositionFilters;
13242
+ };
13243
+ /** Delivery reads expose the data-resolution knobs (depth/variant/diagnostics). */
13244
+ type CompositionDeliveryReadOptions = CompositionReadOptions & DataResolutionParameters;
13245
+ type CompositionDeliveryListQuery = CompositionListQuery & DataResolutionParameters;
13246
+ /**
13247
+ * Read shape for the management clients, selected via the public `format` alias:
13248
+ * - `canonical` (default) — compact PUT-safe shape;
13249
+ * - `editor` — canonical with patterns expanded for display (still PUT-safe).
13250
+ * The individual shaping flags still ride along and override the preset.
13251
+ */
13252
+ type ManagementFormat = {
13253
+ format?: 'canonical' | 'editor';
13254
+ };
13255
+ /**
13256
+ * Optional edition-mode override for management single-`get`. By default a bare
13257
+ * id reads `raw` and a locale-scoped read resolves editions (`auto`); set this
13258
+ * to force one mode (see {@link resolveManagementEditions}).
13259
+ */
13260
+ type ManagementEditionsOverride = {
13261
+ editions?: 'raw' | 'auto';
13262
+ };
13263
+ type CompositionManagementReadOptions = CompositionReadOptions & ManagementFormat & ManagementEditionsOverride;
13264
+ type CompositionManagementListQuery = CompositionListQuery & ManagementFormat;
13265
+ type CompositionIdSelector = {
13266
+ compositionId: string;
13267
+ editionId?: string;
13268
+ versionId?: string;
13269
+ };
13270
+ type CompositionSlugSelector = {
13271
+ slug: string;
13272
+ };
13273
+ type CompositionNodeIdSelector = {
13274
+ projectMapNodeId: string;
13275
+ projectMapId?: string;
13276
+ };
13277
+ type CompositionNodePathSelector = {
13278
+ projectMapNodePath: string;
13279
+ projectMapId?: string;
13280
+ };
13281
+ /** Reads a component definition's stored `defaults` tree as a synthetic draft
13282
+ * composition (management-only; `state` is ignored server-side). */
13283
+ type CompositionDefaultsSelector = {
13284
+ componentId: string;
13285
+ };
13286
+ /** Single-composition selector for the delivery client. */
13287
+ type CompositionDeliverySelector = CompositionIdSelector | CompositionSlugSelector | CompositionNodeIdSelector | CompositionNodePathSelector;
13288
+ /** Single-composition selector for the management client (adds the defaults selector). */
13289
+ type CompositionManagementSelector = CompositionDeliverySelector | CompositionDefaultsSelector;
13290
+ /** Selector for write/delete operations that target a specific edition group. */
13291
+ type CompositionWriteSelector = Omit<ExceptProject<CompositionDeleteParameters>, 'state'>;
13292
+ type EntrySelectorKey = 'entryIDs' | 'slug' | 'versionId';
13293
+ type EntryRetiredKey = 'withWorkflowDefinition';
13294
+ /** See {@link CompositionClientOwnedKey} — `format` is replaced by {@link ManagementFormat}. */
13295
+ type EntryClientOwnedKey = 'format';
13296
+ /**
13297
+ * Options shared by entry `get` and `list`, derived from the generated
13298
+ * `/api/v1/entries` query type, with the same client-owned removals as
13299
+ * compositions (see {@link CompositionReadOptions}).
13300
+ */
13301
+ type EntryReadOptions = Omit<GetEntriesOptions, 'projectId' | 'editions' | EntrySelectorKey | EntryRetiredKey | EntryClientOwnedKey> & Projection;
13302
+ /** Entry `list` query (shared by delivery + management). */
13303
+ type EntryListQuery = EntryReadOptions & ListEditions & {
13304
+ /** Fetch specific entries (or, with `editions: 'raw'`, specific editions) by id. */
13305
+ entryIDs?: string[];
13306
+ /** Filter the list to the entry matching this slug (returns 0 or 1 rows). */
13307
+ slug?: string;
13308
+ /** Structured filters serialized to `filters.*` on the wire. */
13309
+ filters?: EntryFilters;
13310
+ };
13311
+ type EntryDeliveryReadOptions = EntryReadOptions & DataResolutionParameters;
13312
+ type EntryDeliveryListQuery = EntryListQuery & DataResolutionParameters;
13313
+ type EntryManagementReadOptions = EntryReadOptions & ManagementFormat & ManagementEditionsOverride;
13314
+ type EntryManagementListQuery = EntryListQuery & ManagementFormat;
13315
+ /** Single-entry selector. */
13316
+ type EntrySelector = {
13317
+ entryId: string;
13318
+ editionId?: string;
13319
+ versionId?: string;
13320
+ } | {
13321
+ slug: string;
13322
+ };
13323
+ /** Selector for entry write/delete operations targeting a specific edition group. */
13324
+ type EntryWriteSelector = Omit<ExceptProject<DeleteEntryOptions>, 'state'>;
13325
+ /** Optimistic-concurrency option for save / saveAndPublish. */
13326
+ type SaveOptions = {
13327
+ /**
13328
+ * If provided, sends `x-if-unmodified-since`; the server rejects the write
13329
+ * (409) when the target row changed since this timestamp.
13330
+ */
13331
+ ifUnmodifiedSince?: string;
13028
13332
  };
13333
+ /** Result of a write: the new modification timestamp (from `x-modified-at`), or null. */
13334
+ type SaveResult = {
13335
+ modified: string | null;
13336
+ };
13337
+
13338
+ /**
13339
+ * Read-only delivery client for compositions. Hits the edge host with patterns
13340
+ * + overrides + data resources resolved and component `_id`s stripped — the
13341
+ * shape sites/edge serve. Defaults `state` to published and `bypassCache` to
13342
+ * false (cached). It has no write methods by design: you cannot read a
13343
+ * delivery-shaped tree and PUT it back through this client.
13344
+ */
13345
+ declare class CompositionDeliveryClient extends DeliveryClientBase {
13346
+ constructor(options: DeliveryClientOptions);
13347
+ /** Fetches exactly one composition (throws `ApiClientError(404)` if absent). */
13348
+ get(args: CompositionDeliverySelector & CompositionDeliveryReadOptions): Promise<CompositionResolvedGetResponse>;
13349
+ /** Fetches a list of compositions, optionally filtered. */
13350
+ list(args?: CompositionDeliveryListQuery): Promise<CompositionResolvedListResponse>;
13351
+ }
13352
+
13353
+ /**
13354
+ * Full-CRUD management client for compositions. Reads the canonical (PUT-safe)
13355
+ * shape from the origin host and defaults `state` to draft and `bypassCache` to
13356
+ * true. Pass `format: 'editor'` per call for the editor read shape (patterns
13357
+ * expanded, still PUT-safe).
13358
+ */
13359
+ declare class CompositionManagementClient extends ContentClientBase {
13360
+ constructor(options: ClientOptions);
13361
+ /**
13362
+ * Fetches one composition in canonical shape (throws `ApiClientError(404)` if
13363
+ * absent).
13364
+ */
13365
+ get(args: CompositionManagementSelector & CompositionManagementReadOptions): Promise<CompositionGetResponse>;
13366
+ /** Fetches a list of compositions in canonical shape. */
13367
+ list(args?: CompositionManagementListQuery): Promise<CompositionGetListResponse>;
13368
+ /** Creates or updates a composition. Returns the new `x-modified-at` timestamp. */
13369
+ save(body: ExceptProject<CompositionPutParameters>, opts?: SaveOptions): Promise<SaveResult>;
13370
+ /**
13371
+ * Saves the draft and publishes in one call (two PUTs). The optimistic
13372
+ * concurrency guard, if any, applies to the draft write.
13373
+ */
13374
+ saveAndPublish(body: ExceptProject<Omit<CompositionPutParameters, 'state'>>, opts?: SaveOptions): Promise<SaveResult>;
13375
+ /**
13376
+ * Removes only the published state, leaving the draft intact. Scoped to a
13377
+ * single edition when `editionId` is supplied; otherwise unpublishes all editions.
13378
+ * To unpublish only the base edition, pass editionId and compositionId as the same value.
13379
+ */
13380
+ unpublish(selector: CompositionWriteSelector): Promise<void>;
13381
+ /**
13382
+ * Deletes across all states. Scoped to a single edition when `editionId` is
13383
+ * supplied; otherwise deletes all states and editions.
13384
+ * Use `unpublish` to drop only the published state.
13385
+ */
13386
+ remove(selector: CompositionWriteSelector): Promise<void>;
13387
+ /** Fetches historical versions of a composition or pattern. */
13388
+ history(args: ExceptProject<ComponentInstanceHistoryGetParameters>): Promise<ComponentInstanceHistoryGetResponse>;
13389
+ private deleteComposition;
13390
+ }
13391
+
13392
+ /**
13393
+ * Management client for content types.
13394
+ */
13395
+ declare class ContentTypeClient extends ContentClientBase {
13396
+ constructor(options: ClientOptions);
13397
+ /** Fetches one content type by id (throws `ApiClientError(404)` if absent). */
13398
+ get(args: {
13399
+ contentTypeId: string;
13400
+ }): Promise<ContentType>;
13401
+ /** Fetches a list of content types. */
13402
+ list(args?: ExceptProject<GetContentTypesOptions>): Promise<GetContentTypesResponse>;
13403
+ /** Creates or updates a content type. */
13404
+ save(body: ExceptProject<PutContentTypeBody>, opts?: {
13405
+ autogenerateDataTypes?: boolean;
13406
+ }): Promise<void>;
13407
+ /** Deletes a content type. */
13408
+ remove(args: ExceptProject<DeleteContentTypeOptions>): Promise<void>;
13409
+ }
13410
+
13411
+ /**
13412
+ * Read-only delivery client for entries. Hits the edge host with data resources
13413
+ * resolved and component `_id`s stripped. Defaults `state` to published and
13414
+ * `bypassCache` to false (cached). No write methods by design.
13415
+ */
13416
+ declare class EntryDeliveryClient extends DeliveryClientBase {
13417
+ constructor(options: DeliveryClientOptions);
13418
+ /** Fetches exactly one entry by id or slug (throws `ApiClientError(404)` if absent). */
13419
+ get(args: EntrySelector & EntryDeliveryReadOptions): Promise<Entry>;
13420
+ /** Fetches a list of entries, optionally filtered. */
13421
+ list(args?: EntryDeliveryListQuery): Promise<GetEntriesResponse>;
13422
+ }
13423
+
13424
+ /**
13425
+ * Full-CRUD management client for entries. Reads the canonical (PUT-safe) shape
13426
+ * from the origin host and defaults `state` to draft and `bypassCache` to true.
13427
+ */
13428
+ declare class EntryManagementClient extends ContentClientBase {
13429
+ constructor(options: ClientOptions);
13430
+ /**
13431
+ * Fetches one entry by id or slug in canonical shape (throws
13432
+ * `ApiClientError(404)` if absent).
13433
+ */
13434
+ get(args: EntrySelector & EntryManagementReadOptions): Promise<Entry>;
13435
+ /** Fetches a list of entries in canonical shape. */
13436
+ list(args?: EntryManagementListQuery): Promise<GetEntriesResponse>;
13437
+ /** Creates or updates an entry. Returns the new `x-modified-at` timestamp. */
13438
+ save(body: ExceptProject<PutEntryBody>, opts?: SaveOptions): Promise<SaveResult>;
13439
+ /** Saves the draft and publishes in one call (two PUTs). */
13440
+ saveAndPublish(body: ExceptProject<Omit<PutEntryBody, 'state'>>, opts?: SaveOptions): Promise<SaveResult>;
13441
+ /**
13442
+ * Removes only the published state, leaving the draft intact. Scoped to a
13443
+ * single edition when `editionId` is supplied; otherwise unpublishes all editions.
13444
+ * To unpublish only the base edition, pass editionId and entryId as the same value.
13445
+ */
13446
+ unpublish(selector: EntryWriteSelector): Promise<void>;
13447
+ /**
13448
+ * Deletes across all states. Scoped to a single edition when `editionId` is
13449
+ * supplied; otherwise deletes all states and editions.
13450
+ * Use `unpublish` to drop only the published state.
13451
+ */
13452
+ remove(selector: EntryWriteSelector): Promise<void>;
13453
+ /** Fetches historical versions of an entry. */
13454
+ history(args: ExceptProject<EntriesHistoryGetParameters>): Promise<EntriesHistoryGetResponse>;
13455
+ private deleteEntry;
13456
+ }
13457
+
13458
+ type CanvasClientOptions = DeliveryClientOptions;
13029
13459
  type UpdateCompositionOptions = {
13030
13460
  ifUnmodifiedSince?: string;
13031
13461
  };
13462
+ /**
13463
+ * @deprecated Use the persona-shaped clients instead:
13464
+ * - {@link CompositionDeliveryClient} for read-only delivery (resolved) reads,
13465
+ * - {@link CompositionManagementClient} for canonical (PUT-safe) read/write,
13466
+ * - {@link ComponentDefinitionClient} for component definitions.
13467
+ *
13468
+ * The mode (delivery vs management) is now the client class rather than the
13469
+ * `skipDataResolution` flag, which makes the "read resolved → write back →
13470
+ * corrupt" failure unrepresentable.
13471
+ */
13032
13472
  declare class CanvasClient extends ApiClient<CanvasClientOptions> {
13033
13473
  private edgeApiHost;
13034
13474
  private edgeApiRequestInit?;
@@ -13084,39 +13524,31 @@ declare class CanvasClient extends ApiClient<CanvasClientOptions> {
13084
13524
  removeComposition(body: Omit<CompositionDeleteParameters, 'projectId'>): Promise<void>;
13085
13525
  /** Fetches all Canvas component definitions */
13086
13526
  getComponentDefinitions(options?: Omit<ComponentDefinitionGetParameters, 'projectId'>): Promise<{
13087
- componentDefinitions: components$r["schemas"]["ComponentDefinition"][];
13527
+ componentDefinitions: components$p["schemas"]["ComponentDefinition"][];
13088
13528
  }>;
13089
13529
  /** Updates or creates a Canvas component definition */
13090
13530
  updateComponentDefinition(body: Omit<ComponentDefinitionPutParameters, 'projectId'>): Promise<void>;
13091
13531
  /** Deletes a Canvas component definition */
13092
13532
  removeComponentDefinition(body: Omit<ComponentDefinitionDeleteParameters, 'projectId'>): Promise<void>;
13093
13533
  }
13534
+ /**
13535
+ * @deprecated Use {@link CompositionManagementClient} (which defaults
13536
+ * `bypassCache: true`), or pass `bypassCache: true` to a delivery client.
13537
+ */
13094
13538
  declare class UncachedCanvasClient extends CanvasClient {
13095
13539
  constructor(options: Omit<CanvasClientOptions, 'bypassCache'>);
13096
13540
  }
13097
13541
 
13098
- declare class CategoryClient extends ApiClient {
13099
- constructor(options: ClientOptions);
13100
- /** Fetches all categories created in given project */
13101
- getCategories(options?: Omit<CategoriesGetParameters, 'projectId'>): Promise<{
13102
- categories: components$p["schemas"]["Category"][];
13103
- }>;
13104
- /** Updates or creates a category, also used to re-order them */
13105
- upsertCategories(categories: CategoriesPutParameters['categories']): Promise<unknown>;
13106
- /** Deletes a category */
13107
- removeCategory(options: Omit<CategoriesDeleteParameters, 'projectId'>): Promise<unknown>;
13108
- }
13109
- declare class UncachedCategoryClient extends CategoryClient {
13110
- constructor(options: Omit<ClientOptions, 'bypassCache'>);
13111
- }
13112
-
13113
13542
  type UpsertEntryOptions = {
13114
13543
  ifUnmodifiedSince?: string;
13115
13544
  };
13116
- type ContentClientOptions = ClientOptions & {
13117
- edgeApiHost?: string;
13118
- disableSWR?: boolean;
13119
- };
13545
+ type ContentClientOptions = DeliveryClientOptions;
13546
+ /**
13547
+ * @deprecated Use the persona-shaped clients instead:
13548
+ * - {@link EntryDeliveryClient} for read-only delivery (resolved) reads,
13549
+ * - {@link EntryManagementClient} for canonical (PUT-safe) read/write,
13550
+ * - {@link ContentTypeClient} for content types.
13551
+ */
13120
13552
  declare class ContentClient extends ApiClient<ContentClientOptions> {
13121
13553
  #private;
13122
13554
  private edgeApiHost;
@@ -13146,6 +13578,10 @@ declare class ContentClient extends ApiClient<ContentClientOptions> {
13146
13578
  deleteEntry(body: ExceptProject<DeleteEntryOptions>): Promise<void>;
13147
13579
  private getEdgeOptions;
13148
13580
  }
13581
+ /**
13582
+ * @deprecated Use {@link EntryManagementClient} (which defaults
13583
+ * `bypassCache: true`), or pass `bypassCache: true` to a delivery client.
13584
+ */
13149
13585
  declare class UncachedContentClient extends ContentClient {
13150
13586
  constructor(options: Omit<ContentClientOptions, 'bypassCache'>);
13151
13587
  }
@@ -13153,15 +13589,21 @@ declare class UncachedContentClient extends ContentClient {
13153
13589
  /** API client to make comms with the Next Gen Mesh Data Source API simpler */
13154
13590
  declare class DataSourceClient extends ApiClient {
13155
13591
  constructor(options: ClientOptions);
13156
- /** Fetches all DataSources for a project */
13592
+ /** Fetches a single DataSource by id (with decrypted secrets). */
13157
13593
  get(options?: ExceptProject<DataSourceGetParameters>): Promise<{
13158
13594
  result: components$k["schemas"]["DataSource"];
13159
13595
  }>;
13160
- /** Fetches all DataSources for a project */
13596
+ /** Fetches the list of DataSources for a project (secrets masked). */
13597
+ list(options?: ExceptProject<DataSourcesGetParameters>): Promise<{
13598
+ results: components$j["schemas"]["DataSource"][];
13599
+ }>;
13600
+ /** @deprecated Use {@link list} instead. */
13161
13601
  getList(options?: ExceptProject<DataSourcesGetParameters>): Promise<{
13162
13602
  results: components$j["schemas"]["DataSource"][];
13163
13603
  }>;
13164
13604
  /** Updates or creates (based on id) a DataSource */
13605
+ save(body: ExceptProject<DataSourcePutParameters>): Promise<void>;
13606
+ /** @deprecated Use {@link save} instead. */
13165
13607
  upsert(body: ExceptProject<DataSourcePutParameters>): Promise<void>;
13166
13608
  /** Deletes a DataSource */
13167
13609
  remove(body: ExceptProject<DataSourceDeleteParameters>): Promise<void>;
@@ -13171,9 +13613,13 @@ declare class DataSourceClient extends ApiClient {
13171
13613
  declare class DataTypeClient extends ApiClient {
13172
13614
  #private;
13173
13615
  constructor(options: ClientOptions);
13174
- /** Fetches all DataTypes for a project */
13616
+ /** Fetches a list of DataTypes for a project */
13617
+ list(options?: ExceptProject<DataTypeGetParameters>): Promise<DataTypeGetResponse>;
13618
+ /** @deprecated Use {@link list} instead. */
13175
13619
  get(options?: ExceptProject<DataTypeGetParameters>): Promise<DataTypeGetResponse>;
13176
13620
  /** Updates or creates (based on id) a DataType */
13621
+ save(body: ExceptProject<DataTypePutParameters>): Promise<void>;
13622
+ /** @deprecated Use {@link save} instead. */
13177
13623
  upsert(body: ExceptProject<DataTypePutParameters>): Promise<void>;
13178
13624
  /** Deletes a DataType */
13179
13625
  remove(body: ExceptProject<DataTypeDeleteParameters>): Promise<void>;
@@ -13439,8 +13885,8 @@ declare function findParameterInNodeTree(data: ComponentInstance | EntryData | A
13439
13885
 
13440
13886
  /** Returns the JSON pointer of a component based on its location */
13441
13887
  declare function getComponentJsonPointer(ancestorsAndSelf: Array<NodeLocationReference>): string;
13442
- declare function getNounForLocation(parentLocation: NodeLocationReference | undefined): "fields" | "parameters";
13443
- declare function getNounForNode(node: ComponentInstance | EntryData | Array<NodeLocationReference>): "fields" | "parameters";
13888
+ declare function getNounForLocation(parentLocation: NodeLocationReference | undefined): "parameters" | "fields";
13889
+ declare function getNounForNode(node: ComponentInstance | EntryData | Array<NodeLocationReference>): "parameters" | "fields";
13444
13890
 
13445
13891
  declare function getComponentPath(ancestorsAndSelf: Array<NodeLocationReference>): string;
13446
13892
 
@@ -13703,6 +14149,11 @@ declare function walkPropertyValues(property: ComponentParameter, visitor: (opti
13703
14149
  declare class EntityReleasesClient extends ApiClient {
13704
14150
  constructor(options: ClientOptions);
13705
14151
  /** Fetches entity across all releases (and base) */
14152
+ list(options?: ExceptProject<EntityReleasesGetParameters>): Promise<{
14153
+ results: components$6["schemas"]["EntityInRelease"][];
14154
+ totalCount: number;
14155
+ }>;
14156
+ /** @deprecated Use {@link list} instead. */
13706
14157
  get(options?: ExceptProject<EntityReleasesGetParameters>): Promise<{
13707
14158
  results: components$6["schemas"]["EntityInRelease"][];
13708
14159
  totalCount: number;
@@ -13732,7 +14183,27 @@ declare class IntegrationPropertyEditorsClient extends ApiClient<IntegrationProp
13732
14183
  }
13733
14184
 
13734
14185
  declare class LabelClient extends ApiClient {
13735
- /** Fetches labels for the current project. */
14186
+ /** Fetches a list of labels for the current project. */
14187
+ list(options?: Omit<LabelsQuery, 'projectId'>): Promise<{
14188
+ labels: {
14189
+ projectId: string;
14190
+ label: {
14191
+ publicId: string;
14192
+ displayName: string;
14193
+ isGroup: boolean;
14194
+ parent?: string;
14195
+ color: string;
14196
+ description?: string;
14197
+ scope: string[];
14198
+ };
14199
+ created: string;
14200
+ modified: string;
14201
+ createdBy?: string;
14202
+ modifiedBy?: string;
14203
+ }[];
14204
+ totalCount: number;
14205
+ }>;
14206
+ /** @deprecated Use {@link list} instead. */
13736
14207
  getLabels(options?: Omit<LabelsQuery, 'projectId'>): Promise<{
13737
14208
  labels: {
13738
14209
  projectId: string;
@@ -13753,10 +14224,15 @@ declare class LabelClient extends ApiClient {
13753
14224
  totalCount: number;
13754
14225
  }>;
13755
14226
  /** Updates or creates a label. */
14227
+ save(body: Omit<LabelPut, 'projectId'>): Promise<void>;
14228
+ /** @deprecated Use {@link save} instead. */
13756
14229
  upsertLabel(body: Omit<LabelPut, 'projectId'>): Promise<void>;
13757
14230
  /** Deletes a label by id. */
14231
+ remove(options: Omit<LabelDelete, 'projectId'>): Promise<void>;
14232
+ /** @deprecated Use {@link remove} instead. */
13758
14233
  removeLabel(options: Omit<LabelDelete, 'projectId'>): Promise<void>;
13759
14234
  }
14235
+ /** @deprecated Pass `bypassCache: true` to {@link LabelClient} instead. */
13760
14236
  declare class UncachedLabelClient extends LabelClient {
13761
14237
  constructor(options: Omit<ClientOptions, 'bypassCache'>);
13762
14238
  }
@@ -13764,11 +14240,17 @@ declare class UncachedLabelClient extends LabelClient {
13764
14240
  /** API client to enable managing project locales */
13765
14241
  declare class LocaleClient extends ApiClient {
13766
14242
  constructor(options: ClientOptions);
13767
- /** Fetches all locales for a project */
14243
+ /** Fetches a list of locales for a project */
14244
+ list(options?: ExceptProject<LocalesGetParameters>): Promise<{
14245
+ results: components$f["schemas"]["Locale"][];
14246
+ }>;
14247
+ /** @deprecated Use {@link list} instead. */
13768
14248
  get(options?: ExceptProject<LocalesGetParameters>): Promise<{
13769
14249
  results: components$f["schemas"]["Locale"][];
13770
14250
  }>;
13771
14251
  /** Updates or creates (based on id) a locale */
14252
+ save(body: ExceptProject<LocalePutParameters>): Promise<void>;
14253
+ /** @deprecated Use {@link save} instead. */
13772
14254
  upsert(body: ExceptProject<LocalePutParameters>): Promise<void>;
13773
14255
  /** Deletes a locale */
13774
14256
  remove(body: ExceptProject<LocaleDeleteParameters>): Promise<void>;
@@ -14564,10 +15046,16 @@ declare class ProjectClient extends ApiClient {
14564
15046
  * When teamId is provided, returns a single team with its projects.
14565
15047
  * When omitted, returns all accessible teams and their projects.
14566
15048
  */
15049
+ list(options?: ProjectsGetParameters): Promise<ProjectsGetResponse>;
15050
+ /** @deprecated Use {@link list} instead. */
14567
15051
  getProjects(options?: ProjectsGetParameters): Promise<ProjectsGetResponse>;
14568
15052
  /** Updates or creates (based on id) a Project */
15053
+ save(body: ExceptProject<ProjectPutParameters>): Promise<ProjectPutResponse>;
15054
+ /** @deprecated Use {@link save} instead. */
14569
15055
  upsert(body: ExceptProject<ProjectPutParameters>): Promise<ProjectPutResponse>;
14570
15056
  /** Deletes a Project */
15057
+ remove(body: ExceptProject<ProjectDeleteParameters>): Promise<void>;
15058
+ /** @deprecated Use {@link remove} instead. */
14571
15059
  delete(body: ExceptProject<ProjectDeleteParameters>): Promise<void>;
14572
15060
  }
14573
15061
 
@@ -14635,7 +15123,11 @@ declare function projectionToQuery(spec: ProjectionSpec | undefined): Record<str
14635
15123
  */
14636
15124
  declare function queryToProjection(source: URLSearchParams | Record<string, unknown> | null | undefined): ProjectionSpec | undefined;
14637
15125
 
14638
- /** API client to make comms with the Next Gen Mesh Data Source API simpler */
15126
+ /**
15127
+ * API client for the Prompts API.
15128
+ *
15129
+ * @deprecated This client is deprecated and will be removed in a future release.
15130
+ */
14639
15131
  declare class PromptClient extends ApiClient {
14640
15132
  constructor(options: ClientOptions);
14641
15133
  /** Fetches Prompts for a project */
@@ -14818,18 +15310,27 @@ declare class RelationshipClient extends ApiClient<ClientOptions & {
14818
15310
  constructor(options: ClientOptions & {
14819
15311
  projectId: string;
14820
15312
  });
15313
+ list: (options: ExceptProject<RelationshipsGetParameters>) => Promise<RelationshipsGetResponse>;
15314
+ /** @deprecated Use {@link list} instead. */
14821
15315
  get: (options: ExceptProject<RelationshipsGetParameters>) => Promise<RelationshipsGetResponse>;
14822
15316
  }
14823
15317
 
14824
15318
  /** API client to enable managing project releases */
14825
15319
  declare class ReleaseClient extends ApiClient {
14826
15320
  constructor(options: ClientOptions);
14827
- /** Fetches all releases for a project */
15321
+ /** Fetches a list of releases for a project */
15322
+ list(options?: ExceptProject<ReleasesGetParameters>): Promise<{
15323
+ results: components$4["schemas"]["Release"][];
15324
+ totalCount: number;
15325
+ }>;
15326
+ /** @deprecated Use {@link list} instead. */
14828
15327
  get(options?: ExceptProject<ReleasesGetParameters>): Promise<{
14829
15328
  results: components$4["schemas"]["Release"][];
14830
15329
  totalCount: number;
14831
15330
  }>;
14832
15331
  /** Updates or creates (based on id) a release */
15332
+ save(body: ExceptProject<ReleasePutParameters>): Promise<void>;
15333
+ /** @deprecated Use {@link save} instead. */
14833
15334
  upsert(body: ExceptProject<ReleasePutParameters>): Promise<void>;
14834
15335
  /** Deletes a release */
14835
15336
  remove(body: ExceptProject<ReleaseDeleteParameters>): Promise<void>;
@@ -14840,7 +15341,12 @@ declare class ReleaseClient extends ApiClient {
14840
15341
  /** API client interact with release contents */
14841
15342
  declare class ReleaseContentsClient extends ApiClient {
14842
15343
  constructor(options: ClientOptions);
14843
- /** Fetches all entities added to a release */
15344
+ /** Fetches a list of entities added to a release */
15345
+ list(options?: ExceptProject<ReleaseContentsGetParameters>): Promise<{
15346
+ results: components$5["schemas"]["ReleaseContent"][];
15347
+ totalCount: number;
15348
+ }>;
15349
+ /** @deprecated Use {@link list} instead. */
14844
15350
  get(options?: ExceptProject<ReleaseContentsGetParameters>): Promise<{
14845
15351
  results: components$5["schemas"]["ReleaseContent"][];
14846
15352
  totalCount: number;
@@ -14862,15 +15368,16 @@ type ResolvedRouteGetResponse = RouteGetResponseEdgehancedNotFound | RouteGetRes
14862
15368
  declare class RouteClient extends ApiClient<RouteClientOptions> {
14863
15369
  private edgeApiHost;
14864
15370
  constructor(options: RouteClientOptions);
14865
- /** Fetches lists of Canvas compositions, optionally by type */
14866
- getRoute(options?: Omit<RouteGetParameters, 'projectId'> & {
14867
- /**
14868
- * Optional data projection. Applies to the resolved composition when
14869
- * the route matches one. Redirect / notFound responses pass through
14870
- * untouched. Serialized as `select.*` querystring parameters.
14871
- */
14872
- select?: ProjectionSpec;
14873
- }): Promise<ResolvedRouteGetResponse>;
15371
+ /**
15372
+ * Resolves a route to a composition, redirect, or not-found result.
15373
+ *
15374
+ * An optional `select` projection applies to the resolved composition when
15375
+ * the route matches one; redirect / notFound responses pass through
15376
+ * untouched.
15377
+ */
15378
+ get(options?: Omit<RouteGetParameters, 'projectId'> & Projection): Promise<ResolvedRouteGetResponse>;
15379
+ /** @deprecated use {@link RouteClient.get} instead (renamed). */
15380
+ getRoute(options?: Omit<RouteGetParameters, 'projectId'> & Projection): Promise<ResolvedRouteGetResponse>;
14874
15381
  }
14875
15382
 
14876
15383
  declare const mergeAssetConfigWithDefaults: (config: AssetParamConfig) => AssetParamConfig;
@@ -15150,16 +15657,22 @@ declare function hasReferencedVariables(value: string | undefined): number;
15150
15657
  */
15151
15658
  declare function parseVariableExpression(serialized: string, onToken?: (token: string, type: 'text' | 'variable', offset: number) => void | false): number;
15152
15659
 
15153
- declare const version = "20.74.5";
15660
+ declare const version = "20.74.6";
15154
15661
 
15155
15662
  /** API client to enable managing workflow definitions */
15156
15663
  declare class WorkflowClient extends ApiClient {
15157
15664
  constructor(options: ClientOptions);
15158
- /** Fetches workflows for a project */
15665
+ /** Fetches a list of workflows for a project */
15666
+ list(options?: ExceptProject<WorkflowsGetParameters>): Promise<{
15667
+ results: components$3["schemas"]["WorkflowDefinition"][];
15668
+ }>;
15669
+ /** @deprecated Use {@link list} instead. */
15159
15670
  get(options?: ExceptProject<WorkflowsGetParameters>): Promise<{
15160
15671
  results: components$3["schemas"]["WorkflowDefinition"][];
15161
15672
  }>;
15162
15673
  /** Updates or creates a workflow definition */
15674
+ save(body: ExceptProject<WorkflowsPutParameters>): Promise<void>;
15675
+ /** @deprecated Use {@link save} instead. */
15163
15676
  upsert(body: ExceptProject<WorkflowsPutParameters>): Promise<void>;
15164
15677
  /** Deletes a workflow definition */
15165
15678
  remove(body: ExceptProject<WorkflowsDeleteParameters>): Promise<void>;
@@ -15167,4 +15680,4 @@ declare class WorkflowClient extends ApiClient {
15167
15680
 
15168
15681
  declare const CanvasClientError: typeof ApiClientError;
15169
15682
 
15170
- export { ASSETS_SOURCE_CUSTOM_URL, ASSETS_SOURCE_UNIFORM, ASSET_PARAMETER_TYPE, ATTRIBUTE_COMPONENT_ID, ATTRIBUTE_MULTILINE, ATTRIBUTE_PARAMETER_ID, ATTRIBUTE_PARAMETER_TYPE, ATTRIBUTE_PARAMETER_VALUE, ATTRIBUTE_PLACEHOLDER, type AddComponentMessage, type AiAction, type AssetParamConfig, type AwaitingReadyMessage, type BatchEnhancer, BatchEntry, type BatchInvalidationPayload, type BindVariablesOptions, type BindVariablesResult, type BindVariablesToObjectOptions, BlockFormatError, type BlockLocationReference, type BlockValue, CANVAS_BLOCK_PARAM_TYPE, CANVAS_COMPONENT_DISPLAY_NAME_PARAM, CANVAS_CONTEXTUAL_EDITING_PARAM, CANVAS_DRAFT_STATE, CANVAS_EDITOR_STATE, CANVAS_ENRICHMENT_TAG_PARAM, CANVAS_HYPOTHESIS_PARAM, CANVAS_INTENT_TAG_PARAM, CANVAS_INTERNAL_PARAM_PREFIX, CANVAS_LOCALE_TAG_PARAM, CANVAS_LOCALIZATION_SLOT, CANVAS_LOCALIZATION_TYPE, CANVAS_PERSONALIZATION_ALGORITHM_PARAM, CANVAS_PERSONALIZATION_ALGORITHM_TYPE, CANVAS_PERSONALIZATION_EVENT_NAME_PARAM, CANVAS_PERSONALIZATION_PARAM, CANVAS_PERSONALIZATION_TAKE_PARAM, CANVAS_PERSONALIZE_SLOT, CANVAS_PERSONALIZE_TYPE, CANVAS_PUBLISHED_STATE, CANVAS_SLOT_SECTION_GROUP_TYPE_PARAM, CANVAS_SLOT_SECTION_MAX_PARAM, CANVAS_SLOT_SECTION_MIN_PARAM, CANVAS_SLOT_SECTION_NAME_PARAM, CANVAS_SLOT_SECTION_SLOT, CANVAS_SLOT_SECTION_SPECIFIC_PARAM, CANVAS_SLOT_SECTION_TYPE, CANVAS_TEST_SLOT, CANVAS_TEST_TYPE, CANVAS_TEST_VARIANT_PARAM, CANVAS_VIZ_CONTROL_PARAM, CANVAS_VIZ_DI_RULE, CANVAS_VIZ_DYNAMIC_TOKEN_RULE, CANVAS_VIZ_LOCALE_RULE, CANVAS_VIZ_QUIRKS_RULE, CanvasClient, CanvasClientError, type CanvasDefinitions, type CategoriesDeleteParameters, type CategoriesGetParameters, type CategoriesGetResponse, type CategoriesPutParameters, type Category, CategoryClient, type Channel, type ChannelMessage, ChildEnhancerBuilder, type ComponentDefinition, type ComponentDefinitionDeleteParameters, type ComponentDefinitionGetParameters, type ComponentDefinitionGetResponse, type ComponentDefinitionParameter, type ComponentDefinitionPermission, type ComponentDefinitionPutParameters, type ComponentDefinitionSlot, type ComponentDefinitionSlugSettings, type ComponentDefinitionVariant, type ComponentEnhancer, type ComponentEnhancerFunction, type ComponentEnhancerOptions, type ComponentInstance, type ComponentInstanceContextualEditing, type ComponentInstanceHistoryEntry, type ComponentInstanceHistoryGetParameters, type ComponentInstanceHistoryGetResponse, type ComponentLocationReference, type ComponentOverridability, type ComponentOverride, type ComponentOverrides, type ComponentParameter, type ComponentParameterBlock, type ComponentParameterConditionalValue, type ComponentParameterContextualEditing, type ComponentParameterEnhancer, type ComponentParameterEnhancerFunction, type ComponentParameterEnhancerOptions, type CompositionDeleteParameters, type CompositionFilters, type CompositionGetByComponentIdParameters, type CompositionGetByIdParameters, type CompositionGetByNodeIdParameters, type CompositionGetByNodePathParameters, type CompositionGetBySlugParameters, type CompositionGetListResponse, type CompositionGetParameters, type CompositionGetResponse, type CompositionGetValidResponses, type CompositionPutParameters, type CompositionResolvedGetResponse, type CompositionResolvedListResponse, type CompositionUIStatus, ContentClient, type ContentType, type ContentTypeField, type ContentTypePreviewConfiguration, type ContextStorageUpdatedMessage, type ContextualEditingComponentReference, type ContextualEditingValue, type CopiedComponentSubtree, type DataDiagnostic, type DataElementBindingIssue, type DataElementConnectionDefinition, type DataElementConnectionFailureAction, type DataElementConnectionFailureLogLevel, type DataResolutionConfigIssue, type DataResolutionIssue, type DataResolutionOption, type DataResolutionOptionNegative, type DataResolutionOptionPositive, type DataResolutionParameters, type DataResourceDefinition, type DataResourceDefinitions, type DataResourceIssue, type DataResourceVariables, type DataSource, DataSourceClient, type DataSourceDeleteParameters, type DataSourceGetParameters, type DataSourceGetResponse, type DataSourcePutParameters, type DataSourceVariantData, type DataSourceVariantsKeys, type DataSourcesGetParameters, type DataSourcesGetResponse, type DataType, DataTypeClient, type DataTypeDeleteParameters, type DataTypeGetParameters, type DataTypeGetResponse, type DataTypePutParameters, type DataVariableDefinition, type DataWithProperties, type DateParamConfig, type DateParamValue, type DatetimeParamConfig, type DeleteContentTypeOptions, type DeleteEntryOptions, type DismissPlaceholderMessage, type DynamicInputIssue, EDGE_CACHE_DISABLED, EDGE_DEFAULT_CACHE_TTL, EDGE_MAX_CACHE_TTL, EDGE_MIN_CACHE_TTL, EMPTY_COMPOSITION, type EdgehancersDiagnostics, type EdgehancersWholeResponseCacheDiagnostics, type EditorStateUpdatedMessage, EnhancerBuilder, type EnhancerContext, type EnhancerError, EntityReleasesClient, type EntityReleasesGetParameters, type EntityReleasesGetResponse, type EntriesGetParameters, type EntriesGetResponse, type EntriesHistoryGetParameters, type EntriesHistoryGetResponse, type EntriesResolvedListResponse, type Entry, type EntryData, type EntryFilters, type EntryList, type EvaluateCriteriaGroupOptions, type EvaluateNodeTreeVisibilityOptions, type EvaluateNodeVisibilityParameterOptions, type EvaluatePropertyCriteriaOptions, type EvaluateWalkTreePropertyCriteriaOptions, type FieldTypesProjection, type FieldsProjection, type Filters, type FindInNodeTreeReference, type FlattenProperty, type FlattenValues, type FlattenValuesOptions, type GetContentTypesOptions, type GetContentTypesResponse, type GetEffectivePropertyValueOptions, type GetEntriesOptions, type GetEntriesResponse, type GetParameterAttributesProps, IN_CONTEXT_EDITOR_COMPONENT_END_ROLE, IN_CONTEXT_EDITOR_COMPONENT_START_ROLE, IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM, IN_CONTEXT_EDITOR_EMBED_SCRIPT_ID, IN_CONTEXT_EDITOR_FORCED_SETTINGS_QUERY_STRING_PARAM, IN_CONTEXT_EDITOR_PLAYGROUND_QUERY_STRING_PARAM, IN_CONTEXT_EDITOR_QUERY_STRING_PARAM, IS_RENDERED_BY_UNIFORM_ATTRIBUTE, IntegrationPropertyEditorsClient, type IntegrationPropertyEditorsDeleteParameters, type IntegrationPropertyEditorsGetParameters, type IntegrationPropertyEditorsGetResponse, type paths$9 as IntegrationPropertyEditorsPaths, type IntegrationPropertyEditorsPutParameters, type InvalidationPayload, LOCALE_DYNAMIC_INPUT_NAME, type Label, LabelClient, type LabelDelete, type LabelPut, type LabelsQuery, type LabelsResponse, type LimitPolicy, type LinkParamConfiguration, type LinkParamValue, type LinkParameterType, type LinkTypeConfiguration, type Locale, LocaleClient, type LocaleDeleteParameters, type LocalePutParameters, type LocalesGetParameters, type LocalesGetResponse, type LocalizeOptions, type MaxDepthExceededIssue, type MessageHandler, type MoveComponentMessage, type MultiSelectParamConfiguration, type MultiSelectParamEditorType, type MultiSelectParamValue, type NodeLocationReference, type NonProjectMapLinkParamValue, type NumberParamConfig, type NumberParamEditorType, type NumberParamValue, type OpenParameterEditorMessage, type OverrideOptions, PLACEHOLDER_ID, type ParamTypeConfigConventions, type PatternIssue, PreviewClient, type PreviewPanelSettings, type PreviewUrl, type PreviewUrlDeleteParameters, type PreviewUrlDeleteResponse, type PreviewUrlPutParameters, type PreviewUrlPutResponse, type PreviewUrlsGetParameters, type PreviewUrlsGetResponse, type PreviewViewport, type PreviewViewportDeleteParameters, type PreviewViewportDeleteResponse, type PreviewViewportPutParameters, type PreviewViewportPutResponse, type PreviewViewportsGetParameters, type PreviewViewportsGetResponse, type Project, ProjectClient, type ProjectDeleteParameters, type ProjectGetParameters, type ProjectGetResponse, type ProjectMapLinkParamValue, type ProjectPutParameters, type ProjectPutResponse, type ProjectionSpec, type ProjectsGetParameters, type ProjectsGetProject, type ProjectsGetResponse, type ProjectsGetTeam, type Prompt, PromptClient, type PromptsDeleteParameters, type PromptsGetParameters, type PromptsGetResponse, type PromptsPutParameters, type PropertyCriteriaMatch, type PropertyValue, type PutContentTypeBody, type PutEntryBody, REFERENCE_DATA_TYPE_ID, type ReadyMessage, RelationshipClient, type RelationshipResultInstance, type Release, ReleaseClient, type ReleaseContent, ReleaseContentsClient, type ReleaseContentsDeleteBody, type ReleaseContentsGetParameters, type ReleaseContentsGetResponse, type ReleaseDeleteParameters, type ReleasePatchParameters, type ReleasePutParameters, type ReleaseState, type ReleasesGetParameters, type ReleasesGetResponse, type ReportRenderedCompositionsMessage, type RequestComponentSuggestionMessage, type RequestPageHtmlMessage, type ResolvedRouteGetResponse, type RichTextBuiltInElement, type RichTextBuiltInFormat, type RichTextParamConfiguration, type RichTextParamValue, type RootComponentInstance, type RootEntryReference, type RootLocationReference, RouteClient, type RouteDynamicInputs, type RouteGetParameters, type RouteGetResponse, type RouteGetResponseComposition, type RouteGetResponseEdgehancedComposition, type RouteGetResponseEdgehancedNotFound, type RouteGetResponseNotFound, type RouteGetResponseRedirect, SECRET_QUERY_STRING_PARAM, SELECT_QUERY_PREFIX, type SelectComponentMessage, type SelectParamConfiguration, type SelectParamEditorType, type SelectParamOption, type SelectParamValue, type SelectParameterMessage, type SendPageHtmlMessage, type SessionPendingMessage, type SlotsProjection, type SpecificProjectMap, type StringOperators, type SuggestComponentMessage, type TextParamConfig, type TextParamValue, type TreeNodeInfoTypes, type TriggerComponentActionMessage, type TriggerCompositionActionMessage, UncachedCanvasClient, UncachedCategoryClient, UncachedContentClient, UncachedLabelClient, UniqueBatchEntries, type UpdateAiActionsMessage, type UpdateComponentParameterMessage, type UpdateComponentReferencesMessage, type UpdateCompositionInternalMessage, type UpdateCompositionMessage, type UpdateCompositionOptions, type UpdateContextualEditingStateInternalMessage, type UpdateFeatureFlagsMessage, type UpdatePreviewSettingsMessage, type UpsertEntryOptions, type VisibilityCriteria, type VisibilityCriteriaEvaluationResult, type VisibilityCriteriaGroup, type VisibilityParameterValue, type VisibilityRule, type VisibilityRules, type WalkNodeTreeActions, type WalkNodeTreeOptions, type WebhookDefinition, WorkflowClient, type WorkflowDefinition, type WorkflowStage, type WorkflowStagePermission, type WorkflowStageTransition, type WorkflowStageTransitionPermission, type WorkflowsDeleteParameters, type WorkflowsGetParameters, type WorkflowsGetResponse, type WorkflowsPutParameters, autoFixParameterGroups, bindExpressionEscapeChars, bindExpressionPrefix, bindVariables, bindVariablesToObject, compose, convertEntryToPutEntry, convertToBindExpression, createBatchEnhancer, createCanvasChannel, createDynamicInputVisibilityRule, createDynamicTokenVisibilityRule, createLimitPolicy, createLocaleVisibilityRule, createQuirksVisibilityRule, createUniformApiEnhancer, createVariableReference, enhance, escapeBindExpressionDefaultValue, evaluateNodeVisibilityParameter, evaluatePropertyCriteria, evaluateVisibilityCriteriaGroup, evaluateWalkTreeNodeVisibility, evaluateWalkTreePropertyCriteria, extractLocales, findParameterInNodeTree, flattenValues, generateComponentPlaceholderId, generateHash, getBlockValue, getComponentJsonPointer, getComponentPath, getDataSourceVariantFromRouteGetParams, getEffectivePropertyValue, getLocalizedPropertyValues, getNounForLocation, getNounForNode, getParameterAttributes, getPropertiesValue, hasReferencedVariables, isAddComponentMessage, isAllowedReferrer, isAssetParamValue, isAssetParamValueItem, isAwaitingReadyMessage, isComponentActionMessage, isComponentPlaceholderId, isContextStorageUpdatedMessage, isDismissPlaceholderMessage, isEntryData, isLinkParamValue, isMovingComponentMessage, isNestedNodeType, isOpenParameterEditorMessage, isReadyMessage, isReportRenderedCompositionsMessage, isRequestComponentSuggestionMessage, isRootEntryReference, isSelectComponentMessage, isSelectParameterMessage, isSessionPendingMessage, isSuggestComponentMessage, isSystemComponentDefinition, isTriggerCompositionActionMessage, isUpdateAiActionsMessage, isUpdateComponentParameterMessage, isUpdateComponentReferencesMessage, isUpdateCompositionInternalMessage, isUpdateCompositionMessage, isUpdateContextualEditingStateInternalMessage, isUpdateFeatureFlagsMessage, isUpdatePreviewSettingsMessage, localize, mapSlotToPersonalizedVariations, mapSlotToTestVariations, matchesProjectionPattern, mergeAssetConfigWithDefaults, nullLimitPolicy, parseComponentPlaceholderId, parseVariableExpression, projectionToQuery, queryToProjection, version, walkNodeTree, walkPropertyValues };
15683
+ export { ASSETS_SOURCE_CUSTOM_URL, ASSETS_SOURCE_UNIFORM, ASSET_PARAMETER_TYPE, ATTRIBUTE_COMPONENT_ID, ATTRIBUTE_MULTILINE, ATTRIBUTE_PARAMETER_ID, ATTRIBUTE_PARAMETER_TYPE, ATTRIBUTE_PARAMETER_VALUE, ATTRIBUTE_PLACEHOLDER, type AddComponentMessage, type AiAction, type AssetParamConfig, type AwaitingReadyMessage, type BatchEnhancer, BatchEntry, type BatchInvalidationPayload, type BindVariablesOptions, type BindVariablesResult, type BindVariablesToObjectOptions, BlockFormatError, type BlockLocationReference, type BlockValue, CANVAS_BLOCK_PARAM_TYPE, CANVAS_COMPONENT_DISPLAY_NAME_PARAM, CANVAS_CONTEXTUAL_EDITING_PARAM, CANVAS_DRAFT_STATE, CANVAS_EDITOR_STATE, CANVAS_ENRICHMENT_TAG_PARAM, CANVAS_HYPOTHESIS_PARAM, CANVAS_INTENT_TAG_PARAM, CANVAS_INTERNAL_PARAM_PREFIX, CANVAS_LOCALE_TAG_PARAM, CANVAS_LOCALIZATION_SLOT, CANVAS_LOCALIZATION_TYPE, CANVAS_PERSONALIZATION_ALGORITHM_PARAM, CANVAS_PERSONALIZATION_ALGORITHM_TYPE, CANVAS_PERSONALIZATION_EVENT_NAME_PARAM, CANVAS_PERSONALIZATION_PARAM, CANVAS_PERSONALIZATION_TAKE_PARAM, CANVAS_PERSONALIZE_SLOT, CANVAS_PERSONALIZE_TYPE, CANVAS_PUBLISHED_STATE, CANVAS_SLOT_SECTION_GROUP_TYPE_PARAM, CANVAS_SLOT_SECTION_MAX_PARAM, CANVAS_SLOT_SECTION_MIN_PARAM, CANVAS_SLOT_SECTION_NAME_PARAM, CANVAS_SLOT_SECTION_SLOT, CANVAS_SLOT_SECTION_SPECIFIC_PARAM, CANVAS_SLOT_SECTION_TYPE, CANVAS_TEST_SLOT, CANVAS_TEST_TYPE, CANVAS_TEST_VARIANT_PARAM, CANVAS_VIZ_CONTROL_PARAM, CANVAS_VIZ_DI_RULE, CANVAS_VIZ_DYNAMIC_TOKEN_RULE, CANVAS_VIZ_LOCALE_RULE, CANVAS_VIZ_QUIRKS_RULE, CanvasClient, CanvasClientError, type CanvasDefinitions, type CategoriesDeleteParameters, type CategoriesGetParameters, type CategoriesGetResponse, type CategoriesPutParameters, type Category, CategoryClient, type Channel, type ChannelMessage, ChildEnhancerBuilder, type ComponentDefinition, ComponentDefinitionClient, type ComponentDefinitionDeleteParameters, type ComponentDefinitionGetParameters, type ComponentDefinitionGetResponse, type ComponentDefinitionParameter, type ComponentDefinitionPermission, type ComponentDefinitionPutParameters, type ComponentDefinitionSlot, type ComponentDefinitionSlugSettings, type ComponentDefinitionVariant, type ComponentEnhancer, type ComponentEnhancerFunction, type ComponentEnhancerOptions, type ComponentInstance, type ComponentInstanceContextualEditing, type ComponentInstanceHistoryEntry, type ComponentInstanceHistoryGetParameters, type ComponentInstanceHistoryGetResponse, type ComponentLocationReference, type ComponentOverridability, type ComponentOverride, type ComponentOverrides, type ComponentParameter, type ComponentParameterBlock, type ComponentParameterConditionalValue, type ComponentParameterContextualEditing, type ComponentParameterEnhancer, type ComponentParameterEnhancerFunction, type ComponentParameterEnhancerOptions, type CompositionDeleteParameters, CompositionDeliveryClient, type CompositionDeliveryListQuery, type CompositionDeliveryReadOptions, type CompositionDeliverySelector, type CompositionFilters, type CompositionGetByComponentIdParameters, type CompositionGetByIdParameters, type CompositionGetByNodeIdParameters, type CompositionGetByNodePathParameters, type CompositionGetBySlugParameters, type CompositionGetListResponse, type CompositionGetParameters, type CompositionGetResponse, type CompositionGetValidResponses, type CompositionListQuery, CompositionManagementClient, type CompositionManagementListQuery, type CompositionManagementReadOptions, type CompositionManagementSelector, type CompositionPutParameters, type CompositionReadOptions, type CompositionResolvedGetResponse, type CompositionResolvedListResponse, type CompositionUIStatus, type CompositionWriteSelector, ContentClient, type ContentType, ContentTypeClient, type ContentTypeField, type ContentTypePreviewConfiguration, type ContextStorageUpdatedMessage, type ContextualEditingComponentReference, type ContextualEditingValue, type CopiedComponentSubtree, type DataDiagnostic, type DataElementBindingIssue, type DataElementConnectionDefinition, type DataElementConnectionFailureAction, type DataElementConnectionFailureLogLevel, type DataResolutionConfigIssue, type DataResolutionIssue, type DataResolutionOption, type DataResolutionOptionNegative, type DataResolutionOptionPositive, type DataResolutionParameters, type DataResourceDefinition, type DataResourceDefinitions, type DataResourceIssue, type DataResourceVariables, type DataSource, DataSourceClient, type DataSourceDeleteParameters, type DataSourceGetParameters, type DataSourceGetResponse, type DataSourcePutParameters, type DataSourceVariantData, type DataSourceVariantsKeys, type DataSourcesGetParameters, type DataSourcesGetResponse, type DataType, DataTypeClient, type DataTypeDeleteParameters, type DataTypeGetParameters, type DataTypeGetResponse, type DataTypePutParameters, type DataVariableDefinition, type DataWithProperties, type DateParamConfig, type DateParamValue, type DatetimeParamConfig, type DeleteContentTypeOptions, type DeleteEntryOptions, type DismissPlaceholderMessage, type DynamicInputIssue, EDGE_CACHE_DISABLED, EDGE_DEFAULT_CACHE_TTL, EDGE_MAX_CACHE_TTL, EDGE_MIN_CACHE_TTL, EMPTY_COMPOSITION, type EdgehancersDiagnostics, type EdgehancersWholeResponseCacheDiagnostics, type EditorStateUpdatedMessage, EnhancerBuilder, type EnhancerContext, type EnhancerError, EntityReleasesClient, type EntityReleasesGetParameters, type EntityReleasesGetResponse, type EntriesGetParameters, type EntriesGetResponse, type EntriesHistoryGetParameters, type EntriesHistoryGetResponse, type EntriesResolvedListResponse, type Entry, type EntryData, EntryDeliveryClient, type EntryDeliveryListQuery, type EntryDeliveryReadOptions, type EntryFilters, type EntryList, type EntryListQuery, EntryManagementClient, type EntryManagementListQuery, type EntryManagementReadOptions, type EntryReadOptions, type EntrySelector, type EntryWriteSelector, type EvaluateCriteriaGroupOptions, type EvaluateNodeTreeVisibilityOptions, type EvaluateNodeVisibilityParameterOptions, type EvaluatePropertyCriteriaOptions, type EvaluateWalkTreePropertyCriteriaOptions, type FieldTypesProjection, type FieldsProjection, type Filters, type FindInNodeTreeReference, type FlattenProperty, type FlattenValues, type FlattenValuesOptions, type GetContentTypesOptions, type GetContentTypesResponse, type GetEffectivePropertyValueOptions, type GetEntriesOptions, type GetEntriesResponse, type GetParameterAttributesProps, IN_CONTEXT_EDITOR_COMPONENT_END_ROLE, IN_CONTEXT_EDITOR_COMPONENT_START_ROLE, IN_CONTEXT_EDITOR_CONFIG_CHECK_QUERY_STRING_PARAM, IN_CONTEXT_EDITOR_EMBED_SCRIPT_ID, IN_CONTEXT_EDITOR_FORCED_SETTINGS_QUERY_STRING_PARAM, IN_CONTEXT_EDITOR_PLAYGROUND_QUERY_STRING_PARAM, IN_CONTEXT_EDITOR_QUERY_STRING_PARAM, IS_RENDERED_BY_UNIFORM_ATTRIBUTE, IntegrationPropertyEditorsClient, type IntegrationPropertyEditorsDeleteParameters, type IntegrationPropertyEditorsGetParameters, type IntegrationPropertyEditorsGetResponse, type paths$9 as IntegrationPropertyEditorsPaths, type IntegrationPropertyEditorsPutParameters, type InvalidationPayload, LOCALE_DYNAMIC_INPUT_NAME, type Label, LabelClient, type LabelDelete, type LabelPut, type LabelsQuery, type LabelsResponse, type LimitPolicy, type LinkParamConfiguration, type LinkParamValue, type LinkParameterType, type LinkTypeConfiguration, type ListEditions, type Locale, LocaleClient, type LocaleDeleteParameters, type LocalePutParameters, type LocalesGetParameters, type LocalesGetResponse, type LocalizeOptions, type ManagementEditionsOverride, type ManagementFormat, type MaxDepthExceededIssue, type MessageHandler, type MoveComponentMessage, type MultiSelectParamConfiguration, type MultiSelectParamEditorType, type MultiSelectParamValue, type NodeLocationReference, type NonProjectMapLinkParamValue, type NumberParamConfig, type NumberParamEditorType, type NumberParamValue, type OpenParameterEditorMessage, type OverrideOptions, PLACEHOLDER_ID, type ParamTypeConfigConventions, type PatternIssue, PreviewClient, type PreviewPanelSettings, type PreviewUrl, type PreviewUrlDeleteParameters, type PreviewUrlDeleteResponse, type PreviewUrlPutParameters, type PreviewUrlPutResponse, type PreviewUrlsGetParameters, type PreviewUrlsGetResponse, type PreviewViewport, type PreviewViewportDeleteParameters, type PreviewViewportDeleteResponse, type PreviewViewportPutParameters, type PreviewViewportPutResponse, type PreviewViewportsGetParameters, type PreviewViewportsGetResponse, type Project, ProjectClient, type ProjectDeleteParameters, type ProjectGetParameters, type ProjectGetResponse, type ProjectMapLinkParamValue, type ProjectPutParameters, type ProjectPutResponse, type Projection, type ProjectionSpec, type ProjectsGetParameters, type ProjectsGetProject, type ProjectsGetResponse, type ProjectsGetTeam, type Prompt, PromptClient, type PromptsDeleteParameters, type PromptsGetParameters, type PromptsGetResponse, type PromptsPutParameters, type PropertyCriteriaMatch, type PropertyValue, type PutContentTypeBody, type PutEntryBody, REFERENCE_DATA_TYPE_ID, type ReadyMessage, RelationshipClient, type RelationshipResultInstance, type Release, ReleaseClient, type ReleaseContent, ReleaseContentsClient, type ReleaseContentsDeleteBody, type ReleaseContentsGetParameters, type ReleaseContentsGetResponse, type ReleaseDeleteParameters, type ReleasePatchParameters, type ReleasePutParameters, type ReleaseState, type ReleasesGetParameters, type ReleasesGetResponse, type ReportRenderedCompositionsMessage, type RequestComponentSuggestionMessage, type RequestPageHtmlMessage, type ResolvedRouteGetResponse, type RichTextBuiltInElement, type RichTextBuiltInFormat, type RichTextParamConfiguration, type RichTextParamValue, type RootComponentInstance, type RootEntryReference, type RootLocationReference, RouteClient, type RouteDynamicInputs, type RouteGetParameters, type RouteGetResponse, type RouteGetResponseComposition, type RouteGetResponseEdgehancedComposition, type RouteGetResponseEdgehancedNotFound, type RouteGetResponseNotFound, type RouteGetResponseRedirect, SECRET_QUERY_STRING_PARAM, SELECT_QUERY_PREFIX, type SaveOptions, type SaveResult, type SelectComponentMessage, type SelectParamConfiguration, type SelectParamEditorType, type SelectParamOption, type SelectParamValue, type SelectParameterMessage, type SendPageHtmlMessage, type SessionPendingMessage, type SlotsProjection, type SpecificProjectMap, type StringOperators, type SuggestComponentMessage, type TextParamConfig, type TextParamValue, type TreeNodeInfoTypes, type TriggerComponentActionMessage, type TriggerCompositionActionMessage, UncachedCanvasClient, UncachedCategoryClient, UncachedContentClient, UncachedLabelClient, UniqueBatchEntries, type UpdateAiActionsMessage, type UpdateComponentParameterMessage, type UpdateComponentReferencesMessage, type UpdateCompositionInternalMessage, type UpdateCompositionMessage, type UpdateCompositionOptions, type UpdateContextualEditingStateInternalMessage, type UpdateFeatureFlagsMessage, type UpdatePreviewSettingsMessage, type UpsertEntryOptions, type VisibilityCriteria, type VisibilityCriteriaEvaluationResult, type VisibilityCriteriaGroup, type VisibilityParameterValue, type VisibilityRule, type VisibilityRules, type WalkNodeTreeActions, type WalkNodeTreeOptions, type WebhookDefinition, WorkflowClient, type WorkflowDefinition, type WorkflowStage, type WorkflowStagePermission, type WorkflowStageTransition, type WorkflowStageTransitionPermission, type WorkflowsDeleteParameters, type WorkflowsGetParameters, type WorkflowsGetResponse, type WorkflowsPutParameters, autoFixParameterGroups, bindExpressionEscapeChars, bindExpressionPrefix, bindVariables, bindVariablesToObject, compose, convertEntryToPutEntry, convertToBindExpression, createBatchEnhancer, createCanvasChannel, createDynamicInputVisibilityRule, createDynamicTokenVisibilityRule, createLimitPolicy, createLocaleVisibilityRule, createQuirksVisibilityRule, createUniformApiEnhancer, createVariableReference, enhance, escapeBindExpressionDefaultValue, evaluateNodeVisibilityParameter, evaluatePropertyCriteria, evaluateVisibilityCriteriaGroup, evaluateWalkTreeNodeVisibility, evaluateWalkTreePropertyCriteria, extractLocales, findParameterInNodeTree, flattenValues, generateComponentPlaceholderId, generateHash, getBlockValue, getComponentJsonPointer, getComponentPath, getDataSourceVariantFromRouteGetParams, getEffectivePropertyValue, getLocalizedPropertyValues, getNounForLocation, getNounForNode, getParameterAttributes, getPropertiesValue, hasReferencedVariables, isAddComponentMessage, isAllowedReferrer, isAssetParamValue, isAssetParamValueItem, isAwaitingReadyMessage, isComponentActionMessage, isComponentPlaceholderId, isContextStorageUpdatedMessage, isDismissPlaceholderMessage, isEntryData, isLinkParamValue, isMovingComponentMessage, isNestedNodeType, isOpenParameterEditorMessage, isReadyMessage, isReportRenderedCompositionsMessage, isRequestComponentSuggestionMessage, isRootEntryReference, isSelectComponentMessage, isSelectParameterMessage, isSessionPendingMessage, isSuggestComponentMessage, isSystemComponentDefinition, isTriggerCompositionActionMessage, isUpdateAiActionsMessage, isUpdateComponentParameterMessage, isUpdateComponentReferencesMessage, isUpdateCompositionInternalMessage, isUpdateCompositionMessage, isUpdateContextualEditingStateInternalMessage, isUpdateFeatureFlagsMessage, isUpdatePreviewSettingsMessage, localize, mapSlotToPersonalizedVariations, mapSlotToTestVariations, matchesProjectionPattern, mergeAssetConfigWithDefaults, nullLimitPolicy, parseComponentPlaceholderId, parseVariableExpression, projectionToQuery, queryToProjection, version, walkNodeTree, walkPropertyValues };