@uniformdev/canvas 17.0.0 → 17.1.1-alpha.152

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.
@@ -125,6 +125,12 @@ interface external$1 {
125
125
  "application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
126
126
  };
127
127
  };
128
+ /** Resource not found */
129
+ NotFoundError: {
130
+ content: {
131
+ "application/json": external$1["swagger.yml"]["components"]["schemas"]["Error"];
132
+ };
133
+ };
128
134
  /** Too many requests in allowed time period */
129
135
  RateLimitError: unknown;
130
136
  /** Execution error occurred */
@@ -270,25 +276,21 @@ interface external$1 {
270
276
  * @description Defines a binding from a resource data value to a component parameter value. Do not use.
271
277
  */
272
278
  ComponentParameterBinding: {
273
- /**
274
- * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
275
- * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
276
- * Used to bind to object-type values.
277
- * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
278
- * {
279
- * prop1: {
280
- * thing: "value of /res1/things/value resource"
281
- * }
282
- * }
283
- */
284
- pointer: string | {
285
- [key: string]: string;
286
- };
279
+ /** @description A JSON Pointer expression that defines the binding directly to the parameter value */
280
+ pointer: string;
287
281
  /**
288
282
  * @description The syntax of the binding (currently always 'jptr')
289
283
  * @enum {string}
290
284
  */
291
285
  syntax: "jptr";
286
+ /**
287
+ * @description Whether the binding should cause an error if it cannot be resolved.
288
+ * If true, and the binding cannot be resolved, an error will be returned by the binding process.
289
+ * If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
290
+ *
291
+ * @default false
292
+ */
293
+ required?: boolean;
292
294
  };
293
295
  /** @description Defines the shape of a component instance served by the composition API. */
294
296
  ComponentInstance: {
@@ -304,12 +306,24 @@ interface external$1 {
304
306
  slots?: {
305
307
  [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
306
308
  };
309
+ /** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
310
+ _id?: string;
307
311
  /** @description Indicates this component instance should be sourced from a pattern library pattern. */
308
312
  _pattern?: string;
313
+ _data?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
314
+ /**
315
+ * @deprecated
316
+ * @description Data definitions coming from a pattern resolved for this component. Merged with _data during resolution.
317
+ * Means nothing for PUTs; it will be ignored.
318
+ */
319
+ _patternData?: {
320
+ [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
321
+ };
309
322
  /**
310
323
  * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
311
324
  * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
312
325
  * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
326
+ * Means nothing for PUTs; it will be ignored.
313
327
  *
314
328
  * @enum {string}
315
329
  */
@@ -335,6 +349,141 @@ interface external$1 {
335
349
  _slug?: string | null;
336
350
  /** @description Friendly name of this component. */
337
351
  _name: string;
352
+ _data?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
353
+ };
354
+ /**
355
+ * @deprecated
356
+ * @description Basic information about an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). This data is provided to list responses.
357
+ */
358
+ DataConnectionInfo: {
359
+ /** @description Public ID of the data connector */
360
+ id: string;
361
+ /** @description Display name of the data connector */
362
+ displayName: string;
363
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
364
+ connectorType: string;
365
+ /** @description Base resource URL of the data connector. No trailing slash. */
366
+ baseUrl?: string;
367
+ };
368
+ /**
369
+ * @deprecated
370
+ * @description An instance of an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). These are created in the UI and shared across a whole project.
371
+ */
372
+ DataConnection: {
373
+ /** @description Public ID of the data connector */
374
+ id: string;
375
+ /** @description Display name of the data connector */
376
+ displayName: string;
377
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
378
+ connectorType: string;
379
+ /** @description Base resource URL of the data connector. No trailing slash. */
380
+ baseUrl: string;
381
+ /** @description HTTP headers to pass with requests to the data connector */
382
+ headers?: {
383
+ [key: string]: string;
384
+ };
385
+ /** @description Query String parameters to pass with requests to the data connector */
386
+ parameters?: {
387
+ [key: string]: string;
388
+ };
389
+ /** @description Variables needed to make calls to the data connector */
390
+ variables?: {
391
+ [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
392
+ };
393
+ /** @description Custom configuration specific to the data connection being defined */
394
+ custom?: {
395
+ [key: string]: unknown;
396
+ };
397
+ };
398
+ /**
399
+ * @deprecated
400
+ * @description A specific type of data that a Data Connection 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.
401
+ */
402
+ DataType: {
403
+ /** @description Public ID of the data connector */
404
+ id: string;
405
+ /** @description Display name of the data connector */
406
+ displayName: string;
407
+ /** @description Public ID of the associated data connector */
408
+ connectionId: string;
409
+ /**
410
+ * @description A connector-specific archetype for this data type; used to select UI as well as perform any
411
+ * necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
412
+ * no special UI or processing is required.
413
+ */
414
+ archetype?: string;
415
+ /** @description Resource path, appended to the data connection's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have leading slash. */
416
+ path: string;
417
+ /** @description HTTP headers to pass with requests to the data connector */
418
+ headers?: {
419
+ [key: string]: string;
420
+ };
421
+ /** @description Query String parameters to pass with requests to the data connector */
422
+ parameters?: {
423
+ [key: string]: string;
424
+ };
425
+ /** @description Body to pass with requests to the data connector */
426
+ body?: string;
427
+ /**
428
+ * @description HTTP method to use with requests to the data connector.
429
+ * @default GET
430
+ * @enum {string}
431
+ */
432
+ method: "GET" | "POST" | "HEAD";
433
+ /** @description Variables needed to make calls to the data connector */
434
+ variables?: {
435
+ [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
436
+ };
437
+ /** @description Custom configuration specific to the data connection being defined */
438
+ custom?: {
439
+ [key: string]: unknown;
440
+ };
441
+ };
442
+ /**
443
+ * @deprecated
444
+ * @description Defines the shape of a data variable on a Data Connector or Data Type
445
+ */
446
+ DataVariable: {
447
+ /** @description Display name of the data variable */
448
+ displayName?: string;
449
+ /**
450
+ * @description Type of the data variable
451
+ * @default text
452
+ */
453
+ type: string;
454
+ /** @description Default value of the data variable */
455
+ default: string;
456
+ /**
457
+ * @description Where the variable value is set. Static = set to static value by the author. Dynamic = set to a dynamic value by a runtime API request from the frontend (default is used in the editor).
458
+ * @enum {string}
459
+ */
460
+ setBy: "static" | "dynamic";
461
+ };
462
+ /**
463
+ * @deprecated
464
+ * @description Data definitions attached to this component. The property name is the key of the data in the data document.
465
+ * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key).
466
+ */
467
+ CompositionDataDefinitions: {
468
+ [key: string]: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
469
+ };
470
+ /**
471
+ * @deprecated
472
+ * @description Data definition attached to this component
473
+ */
474
+ CompositionDataDefinition: {
475
+ /** @description Public ID of the data type that provides this data */
476
+ type: string;
477
+ /** @description Whether this data is a pattern parameter that has to 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. */
478
+ isPatternParameter?: boolean;
479
+ variables?: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataVariables"];
480
+ };
481
+ /**
482
+ * @deprecated
483
+ * @description Static variable values for this composition.
484
+ */
485
+ CompositionDataVariables: {
486
+ [key: string]: string;
338
487
  };
339
488
  };
340
489
  };
@@ -477,25 +626,21 @@ interface components$1 {
477
626
  * @description Defines a binding from a resource data value to a component parameter value. Do not use.
478
627
  */
479
628
  ComponentParameterBinding: {
480
- /**
481
- * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
482
- * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
483
- * Used to bind to object-type values.
484
- * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
485
- * {
486
- * prop1: {
487
- * thing: "value of /res1/things/value resource"
488
- * }
489
- * }
490
- */
491
- pointer: string | {
492
- [key: string]: string;
493
- };
629
+ /** @description A JSON Pointer expression that defines the binding directly to the parameter value */
630
+ pointer: string;
494
631
  /**
495
632
  * @description The syntax of the binding (currently always 'jptr')
496
633
  * @enum {string}
497
634
  */
498
635
  syntax: "jptr";
636
+ /**
637
+ * @description Whether the binding should cause an error if it cannot be resolved.
638
+ * If true, and the binding cannot be resolved, an error will be returned by the binding process.
639
+ * If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
640
+ *
641
+ * @default false
642
+ */
643
+ required?: boolean;
499
644
  };
500
645
  /** @description Defines the shape of a component instance served by the composition API. */
501
646
  ComponentInstance: {
@@ -511,12 +656,24 @@ interface components$1 {
511
656
  slots?: {
512
657
  [key: string]: components$1["schemas"]["ComponentInstance"][];
513
658
  };
659
+ /** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
660
+ _id?: string;
514
661
  /** @description Indicates this component instance should be sourced from a pattern library pattern. */
515
662
  _pattern?: string;
663
+ _data?: components$1["schemas"]["CompositionDataDefinitions"];
664
+ /**
665
+ * @deprecated
666
+ * @description Data definitions coming from a pattern resolved for this component. Merged with _data during resolution.
667
+ * Means nothing for PUTs; it will be ignored.
668
+ */
669
+ _patternData?: {
670
+ [key: string]: components$1["schemas"]["CompositionDataDefinition"];
671
+ };
516
672
  /**
517
673
  * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
518
674
  * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
519
675
  * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
676
+ * Means nothing for PUTs; it will be ignored.
520
677
  *
521
678
  * @enum {string}
522
679
  */
@@ -542,6 +699,141 @@ interface components$1 {
542
699
  _slug?: string | null;
543
700
  /** @description Friendly name of this component. */
544
701
  _name: string;
702
+ _data?: components$1["schemas"]["CompositionDataDefinitions"];
703
+ };
704
+ /**
705
+ * @deprecated
706
+ * @description Basic information about an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). This data is provided to list responses.
707
+ */
708
+ DataConnectionInfo: {
709
+ /** @description Public ID of the data connector */
710
+ id: string;
711
+ /** @description Display name of the data connector */
712
+ displayName: string;
713
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
714
+ connectorType: string;
715
+ /** @description Base resource URL of the data connector. No trailing slash. */
716
+ baseUrl?: string;
717
+ };
718
+ /**
719
+ * @deprecated
720
+ * @description An instance of an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). These are created in the UI and shared across a whole project.
721
+ */
722
+ DataConnection: {
723
+ /** @description Public ID of the data connector */
724
+ id: string;
725
+ /** @description Display name of the data connector */
726
+ displayName: string;
727
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
728
+ connectorType: string;
729
+ /** @description Base resource URL of the data connector. No trailing slash. */
730
+ baseUrl: string;
731
+ /** @description HTTP headers to pass with requests to the data connector */
732
+ headers?: {
733
+ [key: string]: string;
734
+ };
735
+ /** @description Query String parameters to pass with requests to the data connector */
736
+ parameters?: {
737
+ [key: string]: string;
738
+ };
739
+ /** @description Variables needed to make calls to the data connector */
740
+ variables?: {
741
+ [key: string]: components$1["schemas"]["DataVariable"];
742
+ };
743
+ /** @description Custom configuration specific to the data connection being defined */
744
+ custom?: {
745
+ [key: string]: unknown;
746
+ };
747
+ };
748
+ /**
749
+ * @deprecated
750
+ * @description A specific type of data that a Data Connection 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.
751
+ */
752
+ DataType: {
753
+ /** @description Public ID of the data connector */
754
+ id: string;
755
+ /** @description Display name of the data connector */
756
+ displayName: string;
757
+ /** @description Public ID of the associated data connector */
758
+ connectionId: string;
759
+ /**
760
+ * @description A connector-specific archetype for this data type; used to select UI as well as perform any
761
+ * necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
762
+ * no special UI or processing is required.
763
+ */
764
+ archetype?: string;
765
+ /** @description Resource path, appended to the data connection's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have leading slash. */
766
+ path: string;
767
+ /** @description HTTP headers to pass with requests to the data connector */
768
+ headers?: {
769
+ [key: string]: string;
770
+ };
771
+ /** @description Query String parameters to pass with requests to the data connector */
772
+ parameters?: {
773
+ [key: string]: string;
774
+ };
775
+ /** @description Body to pass with requests to the data connector */
776
+ body?: string;
777
+ /**
778
+ * @description HTTP method to use with requests to the data connector.
779
+ * @default GET
780
+ * @enum {string}
781
+ */
782
+ method: "GET" | "POST" | "HEAD";
783
+ /** @description Variables needed to make calls to the data connector */
784
+ variables?: {
785
+ [key: string]: components$1["schemas"]["DataVariable"];
786
+ };
787
+ /** @description Custom configuration specific to the data connection being defined */
788
+ custom?: {
789
+ [key: string]: unknown;
790
+ };
791
+ };
792
+ /**
793
+ * @deprecated
794
+ * @description Defines the shape of a data variable on a Data Connector or Data Type
795
+ */
796
+ DataVariable: {
797
+ /** @description Display name of the data variable */
798
+ displayName?: string;
799
+ /**
800
+ * @description Type of the data variable
801
+ * @default text
802
+ */
803
+ type: string;
804
+ /** @description Default value of the data variable */
805
+ default: string;
806
+ /**
807
+ * @description Where the variable value is set. Static = set to static value by the author. Dynamic = set to a dynamic value by a runtime API request from the frontend (default is used in the editor).
808
+ * @enum {string}
809
+ */
810
+ setBy: "static" | "dynamic";
811
+ };
812
+ /**
813
+ * @deprecated
814
+ * @description Data definitions attached to this component. The property name is the key of the data in the data document.
815
+ * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key).
816
+ */
817
+ CompositionDataDefinitions: {
818
+ [key: string]: components$1["schemas"]["CompositionDataDefinition"];
819
+ };
820
+ /**
821
+ * @deprecated
822
+ * @description Data definition attached to this component
823
+ */
824
+ CompositionDataDefinition: {
825
+ /** @description Public ID of the data type that provides this data */
826
+ type: string;
827
+ /** @description Whether this data is a pattern parameter that has to 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. */
828
+ isPatternParameter?: boolean;
829
+ variables?: components$1["schemas"]["CompositionDataVariables"];
830
+ };
831
+ /**
832
+ * @deprecated
833
+ * @description Static variable values for this composition.
834
+ */
835
+ CompositionDataVariables: {
836
+ [key: string]: string;
545
837
  };
546
838
  };
547
839
  }
@@ -594,10 +886,12 @@ interface paths {
594
886
  projectId: string;
595
887
  /** Specify a single composition ID to fetch. Changes response from list to single. */
596
888
  compositionId?: string;
889
+ /** Specify multiple composition IDs to fetch. Response type will be a list. */
890
+ compositionIDs?: string[];
597
891
  /** Specify a single composition to fetch by slug. Changes response from list to single. */
598
892
  slug?: string;
599
- /** The component type to filter by */
600
- type?: string;
893
+ /** The component type (by public ID) to filter by. Note that this filters the root composition type only; components in slots are not matched by this filter. */
894
+ type?: string[];
601
895
  /** State of compositions to fetch. 0 = draft, 64 = published. */
602
896
  state?: number;
603
897
  /** Number of records to skip */
@@ -605,7 +899,7 @@ interface paths {
605
899
  /** Max number of records to return */
606
900
  limit?: number;
607
901
  /**
608
- * Signals an enhancer proxy to skip processing enhancements to the data and return raw data only.
902
+ * @deprecated Signals an enhancer proxy to skip processing enhancements to the data and return raw data only.
609
903
  * This improves performance if you do not require enhanced component data.
610
904
  * If calling the Canvas API directly with no enhancer proxy, this has no effect.
611
905
  */
@@ -616,6 +910,39 @@ interface paths {
616
910
  * data embedded into it, and serialize the pattern data separately.
617
911
  */
618
912
  skipPatternResolution?: boolean;
913
+ /**
914
+ * If true the `_id` unique identifier of each non-root component will be part of the response data.
915
+ * If false, the `_id` will not be present in the API response.
916
+ */
917
+ withComponentIDs?: boolean;
918
+ /**
919
+ * Matches compositions where their name, slug, or definition name contains the specified keyword.
920
+ * NOT a full text search; does not match composition contents.
921
+ */
922
+ keyword?: string;
923
+ /**
924
+ * Matches compositions based on whether they are a pattern composition or a regular composition.
925
+ * If true, only pattern compositions will be returned.
926
+ * If false, only regular compositions will be returned.
927
+ * If omitted, both pattern and regular compositions will be returned.
928
+ */
929
+ pattern?: boolean;
930
+ /** Sets the sorting of the results. If unspecified, results are sorted by name ascending. */
931
+ orderBy?: ("updated_at_DESC" | "updated_at_ASC" | "created_at_DESC" | "created_at_ASC" | "name_DESC" | "name_ASC" | "slug_DESC" | "slug_ASC")[];
932
+ /**
933
+ * @deprecated Returns the UI status string of the composition.
934
+ * This internal status is subject to change without notice, and is thus marked deprecated to discourage use of internal data.
935
+ */
936
+ withUIStatus?: boolean;
937
+ /**
938
+ * @deprecated Filters composition lists by the UI status of the composition.
939
+ * This internal status is subject to change without notice, and is thus marked deprecated to discourage use of internal data.
940
+ */
941
+ uiStatus?: ("Draft" | "Modified" | "Published" | "Orphan")[];
942
+ /** Filters composition lists by the user who created them. The user is specified by their identity subject. */
943
+ createdBy?: string;
944
+ /** Filters composition lists by the user who last updated them. The user is specified by their identity subject. */
945
+ updatedBy?: string;
619
946
  };
620
947
  };
621
948
  responses: {
@@ -717,6 +1044,12 @@ interface components {
717
1044
  CompositionApiResponse: {
718
1045
  /** @description State of compositions to fetch. 0 = draft, 64 = published. */
719
1046
  state: number;
1047
+ /**
1048
+ * @deprecated
1049
+ * @description UI status value. Subject to change without notice; do not rely on this value. Only present when `withUIStatus` option is true.
1050
+ * @enum {string}
1051
+ */
1052
+ uiStatus?: "Draft" | "Modified" | "Published" | "Orphan";
720
1053
  /**
721
1054
  * Format: uuid
722
1055
  * @description The project ID that this layout data is part of
@@ -770,6 +1103,12 @@ interface external {
770
1103
  "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
771
1104
  };
772
1105
  };
1106
+ /** Resource not found */
1107
+ NotFoundError: {
1108
+ content: {
1109
+ "application/json": external["swagger.yml"]["components"]["schemas"]["Error"];
1110
+ };
1111
+ };
773
1112
  /** Too many requests in allowed time period */
774
1113
  RateLimitError: unknown;
775
1114
  /** Execution error occurred */
@@ -915,25 +1254,21 @@ interface external {
915
1254
  * @description Defines a binding from a resource data value to a component parameter value. Do not use.
916
1255
  */
917
1256
  ComponentParameterBinding: {
918
- /**
919
- * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
920
- * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
921
- * Used to bind to object-type values.
922
- * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
923
- * {
924
- * prop1: {
925
- * thing: "value of /res1/things/value resource"
926
- * }
927
- * }
928
- */
929
- pointer: string | {
930
- [key: string]: string;
931
- };
1257
+ /** @description A JSON Pointer expression that defines the binding directly to the parameter value */
1258
+ pointer: string;
932
1259
  /**
933
1260
  * @description The syntax of the binding (currently always 'jptr')
934
1261
  * @enum {string}
935
1262
  */
936
1263
  syntax: "jptr";
1264
+ /**
1265
+ * @description Whether the binding should cause an error if it cannot be resolved.
1266
+ * If true, and the binding cannot be resolved, an error will be returned by the binding process.
1267
+ * If false, and the binding cannot be resolved, the parameter will be removed from the bound composition.
1268
+ *
1269
+ * @default false
1270
+ */
1271
+ required?: boolean;
937
1272
  };
938
1273
  /** @description Defines the shape of a component instance served by the composition API. */
939
1274
  ComponentInstance: {
@@ -949,12 +1284,24 @@ interface external {
949
1284
  slots?: {
950
1285
  [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["ComponentInstance"][];
951
1286
  };
1287
+ /** @description Unique identifier of the component within the composition. This is not set unless specifically requested via `withComponentIDs` API parameter. */
1288
+ _id?: string;
952
1289
  /** @description Indicates this component instance should be sourced from a pattern library pattern. */
953
1290
  _pattern?: string;
1291
+ _data?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
1292
+ /**
1293
+ * @deprecated
1294
+ * @description Data definitions coming from a pattern resolved for this component. Merged with _data during resolution.
1295
+ * Means nothing for PUTs; it will be ignored.
1296
+ */
1297
+ _patternData?: {
1298
+ [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
1299
+ };
954
1300
  /**
955
1301
  * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
956
1302
  * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
957
1303
  * NOTFOUND: The pattern ID referenced could not be found. It may have been deleted, or not be published yet.
1304
+ * Means nothing for PUTs; it will be ignored.
958
1305
  *
959
1306
  * @enum {string}
960
1307
  */
@@ -980,6 +1327,141 @@ interface external {
980
1327
  _slug?: string | null;
981
1328
  /** @description Friendly name of this component. */
982
1329
  _name: string;
1330
+ _data?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinitions"];
1331
+ };
1332
+ /**
1333
+ * @deprecated
1334
+ * @description Basic information about an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). This data is provided to list responses.
1335
+ */
1336
+ DataConnectionInfo: {
1337
+ /** @description Public ID of the data connector */
1338
+ id: string;
1339
+ /** @description Display name of the data connector */
1340
+ displayName: string;
1341
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
1342
+ connectorType: string;
1343
+ /** @description Base resource URL of the data connector. No trailing slash. */
1344
+ baseUrl?: string;
1345
+ };
1346
+ /**
1347
+ * @deprecated
1348
+ * @description An instance of an integration data connector (i.e. "Master environment of the stable space", "Yelp API", "Sanity dev dataset"). These are created in the UI and shared across a whole project.
1349
+ */
1350
+ DataConnection: {
1351
+ /** @description Public ID of the data connector */
1352
+ id: string;
1353
+ /** @description Display name of the data connector */
1354
+ displayName: string;
1355
+ /** @description The type of data connector this connects to (e.g. 'cms-items', provided by an intalled integration) */
1356
+ connectorType: string;
1357
+ /** @description Base resource URL of the data connector. No trailing slash. */
1358
+ baseUrl: string;
1359
+ /** @description HTTP headers to pass with requests to the data connector */
1360
+ headers?: {
1361
+ [key: string]: string;
1362
+ };
1363
+ /** @description Query String parameters to pass with requests to the data connector */
1364
+ parameters?: {
1365
+ [key: string]: string;
1366
+ };
1367
+ /** @description Variables needed to make calls to the data connector */
1368
+ variables?: {
1369
+ [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
1370
+ };
1371
+ /** @description Custom configuration specific to the data connection being defined */
1372
+ custom?: {
1373
+ [key: string]: unknown;
1374
+ };
1375
+ };
1376
+ /**
1377
+ * @deprecated
1378
+ * @description A specific type of data that a Data Connection 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.
1379
+ */
1380
+ DataType: {
1381
+ /** @description Public ID of the data connector */
1382
+ id: string;
1383
+ /** @description Display name of the data connector */
1384
+ displayName: string;
1385
+ /** @description Public ID of the associated data connector */
1386
+ connectionId: string;
1387
+ /**
1388
+ * @description A connector-specific archetype for this data type; used to select UI as well as perform any
1389
+ * necessary post-processing on the response. e.g. 'cms-entry', 'cms-query'. Can be undefined if
1390
+ * no special UI or processing is required.
1391
+ */
1392
+ archetype?: string;
1393
+ /** @description Resource path, appended to the data connection's baseUrl (e.g. baseUrl = https://base.url, path = /v1/endpoint -> final URL https://base.url/v1/endpoint). Must have leading slash. */
1394
+ path: string;
1395
+ /** @description HTTP headers to pass with requests to the data connector */
1396
+ headers?: {
1397
+ [key: string]: string;
1398
+ };
1399
+ /** @description Query String parameters to pass with requests to the data connector */
1400
+ parameters?: {
1401
+ [key: string]: string;
1402
+ };
1403
+ /** @description Body to pass with requests to the data connector */
1404
+ body?: string;
1405
+ /**
1406
+ * @description HTTP method to use with requests to the data connector.
1407
+ * @default GET
1408
+ * @enum {string}
1409
+ */
1410
+ method: "GET" | "POST" | "HEAD";
1411
+ /** @description Variables needed to make calls to the data connector */
1412
+ variables?: {
1413
+ [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["DataVariable"];
1414
+ };
1415
+ /** @description Custom configuration specific to the data connection being defined */
1416
+ custom?: {
1417
+ [key: string]: unknown;
1418
+ };
1419
+ };
1420
+ /**
1421
+ * @deprecated
1422
+ * @description Defines the shape of a data variable on a Data Connector or Data Type
1423
+ */
1424
+ DataVariable: {
1425
+ /** @description Display name of the data variable */
1426
+ displayName?: string;
1427
+ /**
1428
+ * @description Type of the data variable
1429
+ * @default text
1430
+ */
1431
+ type: string;
1432
+ /** @description Default value of the data variable */
1433
+ default: string;
1434
+ /**
1435
+ * @description Where the variable value is set. Static = set to static value by the author. Dynamic = set to a dynamic value by a runtime API request from the frontend (default is used in the editor).
1436
+ * @enum {string}
1437
+ */
1438
+ setBy: "static" | "dynamic";
1439
+ };
1440
+ /**
1441
+ * @deprecated
1442
+ * @description Data definitions attached to this component. The property name is the key of the data in the data document.
1443
+ * Note: data definitions are inherited from ancestors at runtime (and may be overridden by descendants that use the same key).
1444
+ */
1445
+ CompositionDataDefinitions: {
1446
+ [key: string]: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataDefinition"];
1447
+ };
1448
+ /**
1449
+ * @deprecated
1450
+ * @description Data definition attached to this component
1451
+ */
1452
+ CompositionDataDefinition: {
1453
+ /** @description Public ID of the data type that provides this data */
1454
+ type: string;
1455
+ /** @description Whether this data is a pattern parameter that has to 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. */
1456
+ isPatternParameter?: boolean;
1457
+ variables?: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["CompositionDataVariables"];
1458
+ };
1459
+ /**
1460
+ * @deprecated
1461
+ * @description Static variable values for this composition.
1462
+ */
1463
+ CompositionDataVariables: {
1464
+ [key: string]: string;
983
1465
  };
984
1466
  };
985
1467
  };
@@ -991,9 +1473,14 @@ declare type Components = components['schemas'];
991
1473
  declare type SharedComponents = components$1['schemas'];
992
1474
  declare type Api = paths['/api/v1/canvas'];
993
1475
  /** Query parameter options for GET /api/v1/canvas */
994
- declare type CompositionGetParameters = Api['get']['parameters']['query'];
1476
+ declare type CompositionGetParameters = Omit<Api['get']['parameters']['query'], 'type'> & {
1477
+ type?: string | string[];
1478
+ };
1479
+ declare type CompositionGetOrderBy = NonNullable<Api['get']['parameters']['query']['orderBy']>[0];
995
1480
  /** The GET response from /api/v1/canvas when `component` or `slug` params are specified */
996
1481
  declare type CompositionGetResponse = Components['CompositionApiResponse'];
1482
+ /** @deprecated - internal use, do not rely on this value */
1483
+ declare type CompositionUIStatus = NonNullable<Components['CompositionApiResponse']['uiStatus']>;
997
1484
  /** The GET response from /api/v1/canvas when `component` or `slug` are not specified */
998
1485
  declare type CompositionGetListResponse = Components['CompositionListResponse'];
999
1486
  /** The PUT request body for /api/v1/canvas */
@@ -1015,6 +1502,12 @@ declare type ComponentParameter<TValue = unknown> = Omit<SharedComponents['Compo
1015
1502
  };
1016
1503
  /** Defines a binding from a resource data value to a component parameter value. */
1017
1504
  declare type ComponentParameterBinding = SharedComponents['ComponentParameterBinding'];
1505
+ /** Variables defined for this composition. */
1506
+ declare type CompositionDataVariables = SharedComponents['CompositionDataVariables'];
1507
+ /** Defines the shape of a resource bound to a composition */
1508
+ declare type CompositionDataDefinitions = SharedComponents['CompositionDataDefinitions'];
1509
+ /** Defines the shape of a resource bound to a composition */
1510
+ declare type CompositionDataDefinition = SharedComponents['CompositionDataDefinition'];
1018
1511
  /** Defines the shape of a component instance served by the composition API. */
1019
1512
  declare type ComponentInstance = SharedComponents['ComponentInstance'] & {
1020
1513
  /** Data for the component instance, provided by a component enhancer. Never set in unenhanced data. */
@@ -1053,4 +1546,4 @@ declare global {
1053
1546
  */
1054
1547
  declare function createEventBus(): Promise<PreviewEventBus | undefined>;
1055
1548
 
1056
- export { CanvasDefinitions as A, ChannelSubscription as B, ComponentInstance as C, createEventBus as D, PreviewEventBus as P, RootComponentInstance as R, ComponentParameter as a, CompositionGetParameters as b, CompositionPutParameters as c, CompositionDeleteParameters as d, ComponentDefinitionGetParameters as e, ComponentDefinitionPutParameters as f, ComponentDefinitionDeleteParameters as g, ComponentDefinitionGetResponse as h, ComponentDefinitionAPIResponse as i, ComponentDefinitionAPIPutRequest as j, ComponentDefinitionAPIDeleteRequest as k, ComponentDefinitionListAPIOptions as l, ComponentDefinitionParameter as m, ComponentDefinitionVariant as n, ComponentDefinitionSlugSettings as o, ComponentDefinitionSlot as p, ComponentDefinitionPermission as q, ComponentDefinition as r, CreatingComponentDefinition as s, CompositionGetResponse as t, CompositionGetListResponse as u, CompositionAPIResponse as v, CompositionAPIDeleteRequest as w, CompositionListAPIResponse as x, CompositionAPIOptions as y, ComponentParameterBinding as z };
1549
+ export { CompositionListAPIResponse as A, CompositionAPIOptions as B, ComponentInstance as C, ComponentParameterBinding as D, CompositionDataVariables as E, CompositionDataDefinitions as F, CompositionDataDefinition as G, CanvasDefinitions as H, ChannelSubscription as I, createEventBus as J, PreviewEventBus as P, RootComponentInstance as R, ComponentParameter as a, CompositionGetParameters as b, components$1 as c, CompositionPutParameters as d, CompositionDeleteParameters as e, ComponentDefinitionGetParameters as f, ComponentDefinitionPutParameters as g, ComponentDefinitionDeleteParameters as h, ComponentDefinitionGetResponse as i, ComponentDefinitionAPIResponse as j, ComponentDefinitionAPIPutRequest as k, ComponentDefinitionAPIDeleteRequest as l, ComponentDefinitionListAPIOptions as m, ComponentDefinitionParameter as n, ComponentDefinitionVariant as o, ComponentDefinitionSlugSettings as p, ComponentDefinitionSlot as q, ComponentDefinitionPermission as r, ComponentDefinition as s, CreatingComponentDefinition as t, CompositionGetOrderBy as u, CompositionGetResponse as v, CompositionUIStatus as w, CompositionGetListResponse as x, CompositionAPIResponse as y, CompositionAPIDeleteRequest as z };