@uniformdev/canvas 17.1.0 → 17.1.1-alpha.231

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.
@@ -214,11 +214,11 @@ interface external$1 {
214
214
  roleId: external$1["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
215
215
  /**
216
216
  * @description Permission type for this permission ComponentDefinition:
217
- * read | write | delete
217
+ * read | write | create | delete
218
218
  *
219
219
  * @enum {string}
220
220
  */
221
- permission: "read" | "write" | "delete";
221
+ permission: "read" | "write" | "create" | "delete";
222
222
  /** @description State of the component that this permission applies to */
223
223
  state: number;
224
224
  };
@@ -276,20 +276,8 @@ interface external$1 {
276
276
  * @description Defines a binding from a resource data value to a component parameter value. Do not use.
277
277
  */
278
278
  ComponentParameterBinding: {
279
- /**
280
- * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
281
- * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
282
- * Used to bind to object-type values.
283
- * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
284
- * {
285
- * prop1: {
286
- * thing: "value of /res1/things/value resource"
287
- * }
288
- * }
289
- */
290
- pointer: string | {
291
- [key: string]: string;
292
- };
279
+ /** @description A JSON Pointer expression that defines the binding directly to the parameter value */
280
+ pointer: string;
293
281
  /**
294
282
  * @description The syntax of the binding (currently always 'jptr')
295
283
  * @enum {string}
@@ -322,10 +310,20 @@ interface external$1 {
322
310
  _id?: string;
323
311
  /** @description Indicates this component instance should be sourced from a pattern library pattern. */
324
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
+ };
325
322
  /**
326
323
  * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
327
324
  * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
328
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.
329
327
  *
330
328
  * @enum {string}
331
329
  */
@@ -351,6 +349,141 @@ interface external$1 {
351
349
  _slug?: string | null;
352
350
  /** @description Friendly name of this component. */
353
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 connection */
374
+ id: string;
375
+ /** @description Display name of the data connection */
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 connection. No trailing slash. */
380
+ baseUrl: string;
381
+ /** @description HTTP headers to pass with requests to the data connection */
382
+ headers?: {
383
+ [key: string]: string;
384
+ };
385
+ /** @description Query String parameters to pass with requests to the data connection */
386
+ parameters?: {
387
+ [key: string]: string;
388
+ };
389
+ /** @description Variables needed to make calls to the data connection */
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 type */
404
+ id: string;
405
+ /** @description Display name of the data type */
406
+ displayName: string;
407
+ /** @description Public ID of the associated data connection */
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 type. Merged with headers from the data connection, overriding identical keys. */
418
+ headers?: {
419
+ [key: string]: string;
420
+ };
421
+ /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data connection, overriding identical keys. */
422
+ parameters?: {
423
+ [key: string]: string;
424
+ };
425
+ /** @description Body to pass with requests to the data type (ignored unless method is POST) */
426
+ body?: string;
427
+ /**
428
+ * @description HTTP method to use with requests to the data type.
429
+ * @default GET
430
+ * @enum {string}
431
+ */
432
+ method: "GET" | "POST" | "HEAD";
433
+ /** @description Variables needed to make calls to the data type. Merged with variables from the data connection, overriding identical keys. */
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;
354
487
  };
355
488
  };
356
489
  };
@@ -431,11 +564,11 @@ interface components$1 {
431
564
  roleId: components$1["schemas"]["PublicIdProperty"];
432
565
  /**
433
566
  * @description Permission type for this permission ComponentDefinition:
434
- * read | write | delete
567
+ * read | write | create | delete
435
568
  *
436
569
  * @enum {string}
437
570
  */
438
- permission: "read" | "write" | "delete";
571
+ permission: "read" | "write" | "create" | "delete";
439
572
  /** @description State of the component that this permission applies to */
440
573
  state: number;
441
574
  };
@@ -493,20 +626,8 @@ interface components$1 {
493
626
  * @description Defines a binding from a resource data value to a component parameter value. Do not use.
494
627
  */
495
628
  ComponentParameterBinding: {
496
- /**
497
- * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
498
- * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
499
- * Used to bind to object-type values.
500
- * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
501
- * {
502
- * prop1: {
503
- * thing: "value of /res1/things/value resource"
504
- * }
505
- * }
506
- */
507
- pointer: string | {
508
- [key: string]: string;
509
- };
629
+ /** @description A JSON Pointer expression that defines the binding directly to the parameter value */
630
+ pointer: string;
510
631
  /**
511
632
  * @description The syntax of the binding (currently always 'jptr')
512
633
  * @enum {string}
@@ -539,10 +660,20 @@ interface components$1 {
539
660
  _id?: string;
540
661
  /** @description Indicates this component instance should be sourced from a pattern library pattern. */
541
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
+ };
542
672
  /**
543
673
  * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
544
674
  * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
545
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.
546
677
  *
547
678
  * @enum {string}
548
679
  */
@@ -568,6 +699,141 @@ interface components$1 {
568
699
  _slug?: string | null;
569
700
  /** @description Friendly name of this component. */
570
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 connection */
724
+ id: string;
725
+ /** @description Display name of the data connection */
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 connection. No trailing slash. */
730
+ baseUrl: string;
731
+ /** @description HTTP headers to pass with requests to the data connection */
732
+ headers?: {
733
+ [key: string]: string;
734
+ };
735
+ /** @description Query String parameters to pass with requests to the data connection */
736
+ parameters?: {
737
+ [key: string]: string;
738
+ };
739
+ /** @description Variables needed to make calls to the data connection */
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 type */
754
+ id: string;
755
+ /** @description Display name of the data type */
756
+ displayName: string;
757
+ /** @description Public ID of the associated data connection */
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 type. Merged with headers from the data connection, overriding identical keys. */
768
+ headers?: {
769
+ [key: string]: string;
770
+ };
771
+ /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data connection, overriding identical keys. */
772
+ parameters?: {
773
+ [key: string]: string;
774
+ };
775
+ /** @description Body to pass with requests to the data type (ignored unless method is POST) */
776
+ body?: string;
777
+ /**
778
+ * @description HTTP method to use with requests to the data type.
779
+ * @default GET
780
+ * @enum {string}
781
+ */
782
+ method: "GET" | "POST" | "HEAD";
783
+ /** @description Variables needed to make calls to the data type. Merged with variables from the data connection, overriding identical keys. */
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;
571
837
  };
572
838
  };
573
839
  }
@@ -620,10 +886,12 @@ interface paths {
620
886
  projectId: string;
621
887
  /** Specify a single composition ID to fetch. Changes response from list to single. */
622
888
  compositionId?: string;
889
+ /** Specify multiple composition IDs to fetch. Response type will be a list. */
890
+ compositionIDs?: string[];
623
891
  /** Specify a single composition to fetch by slug. Changes response from list to single. */
624
892
  slug?: string;
625
- /** The component type to filter by */
626
- 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[];
627
895
  /** State of compositions to fetch. 0 = draft, 64 = published. */
628
896
  state?: number;
629
897
  /** Number of records to skip */
@@ -647,6 +915,34 @@ interface paths {
647
915
  * If false, the `_id` will not be present in the API response.
648
916
  */
649
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;
650
946
  };
651
947
  };
652
948
  responses: {
@@ -696,8 +992,6 @@ interface paths {
696
992
  * @default false
697
993
  */
698
994
  pattern?: boolean;
699
- resources?: components["schemas"]["CompositionResourceDefinitions"];
700
- variables?: components["schemas"]["CompositionVariableDefinitions"];
701
995
  /** @description Ignored if present */
702
996
  created?: string;
703
997
  /** @description Ignored if present */
@@ -750,6 +1044,12 @@ interface components {
750
1044
  CompositionApiResponse: {
751
1045
  /** @description State of compositions to fetch. 0 = draft, 64 = published. */
752
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";
753
1053
  /**
754
1054
  * Format: uuid
755
1055
  * @description The project ID that this layout data is part of
@@ -767,53 +1067,11 @@ interface components {
767
1067
  modified: string;
768
1068
  /** @description Whether this composition is a pattern (can be referenced by other compositions, not treated as a composition) */
769
1069
  pattern: boolean;
770
- resources?: components["schemas"]["CompositionResourceDefinitions"];
771
1070
  composition: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["RootComponentInstance"];
772
- variables?: components["schemas"]["CompositionVariableDefinitions"];
773
1071
  };
774
1072
  CompositionListResponse: {
775
1073
  compositions: components["schemas"]["CompositionApiResponse"][];
776
1074
  };
777
- /**
778
- * @deprecated
779
- * @description Variables defined for this composition.
780
- */
781
- CompositionVariableDefinitions: {
782
- [key: string]: components["schemas"]["CompositionVariable"];
783
- };
784
- /**
785
- * @deprecated
786
- * @description Defines a variable value that can be used in resources and bindings.
787
- */
788
- CompositionVariable: {
789
- /**
790
- * @description Whether the variable must have a value when bound to.
791
- * If true, binding a composition without this variable set will return an error.
792
- * If false, binding a composition without this variable set will use the default value instead.
793
- */
794
- required: boolean;
795
- /** @description The default value of the variable, used when binding for editing or when an optional variable value is not provided. */
796
- default: string;
797
- };
798
- /**
799
- * @deprecated
800
- * @description Resource definitions attached to this composition. The property name is the key of the resource in the resource document.
801
- */
802
- CompositionResourceDefinitions: {
803
- [key: string]: components["schemas"]["CompositionResourceDefinition"];
804
- };
805
- /**
806
- * @deprecated
807
- * @description Resource definition attached to this composition
808
- */
809
- CompositionResourceDefinition: {
810
- /** @description Integration that provides this resource */
811
- type: string;
812
- /** @description Type-specific data to configure resource */
813
- data: {
814
- [key: string]: unknown;
815
- };
816
- };
817
1075
  };
818
1076
  }
819
1077
  interface external {
@@ -934,11 +1192,11 @@ interface external {
934
1192
  roleId: external["uniform-canvas-types.swagger.yml"]["components"]["schemas"]["PublicIdProperty"];
935
1193
  /**
936
1194
  * @description Permission type for this permission ComponentDefinition:
937
- * read | write | delete
1195
+ * read | write | create | delete
938
1196
  *
939
1197
  * @enum {string}
940
1198
  */
941
- permission: "read" | "write" | "delete";
1199
+ permission: "read" | "write" | "create" | "delete";
942
1200
  /** @description State of the component that this permission applies to */
943
1201
  state: number;
944
1202
  };
@@ -996,20 +1254,8 @@ interface external {
996
1254
  * @description Defines a binding from a resource data value to a component parameter value. Do not use.
997
1255
  */
998
1256
  ComponentParameterBinding: {
999
- /**
1000
- * @description A JSON Pointer expression that defines the binding directly to the parameter value, or
1001
- * a map of JSON Pointers in the target parameter to JSON Pointers in the source resource data.
1002
- * Used to bind to object-type values.
1003
- * e.g. { "/prop1/thing": "/res1/things/value" } would set the target parameter's `value` to
1004
- * {
1005
- * prop1: {
1006
- * thing: "value of /res1/things/value resource"
1007
- * }
1008
- * }
1009
- */
1010
- pointer: string | {
1011
- [key: string]: string;
1012
- };
1257
+ /** @description A JSON Pointer expression that defines the binding directly to the parameter value */
1258
+ pointer: string;
1013
1259
  /**
1014
1260
  * @description The syntax of the binding (currently always 'jptr')
1015
1261
  * @enum {string}
@@ -1042,10 +1288,20 @@ interface external {
1042
1288
  _id?: string;
1043
1289
  /** @description Indicates this component instance should be sourced from a pattern library pattern. */
1044
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
+ };
1045
1300
  /**
1046
1301
  * @description Describes why the pattern could not be resolved, if a pattern could not be resolved. For PUTs, this is allowed but ignored.
1047
1302
  * CYCLIC: A cyclic pattern graph was detected, which could not be resolved because it would cause an infinite loop.
1048
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.
1049
1305
  *
1050
1306
  * @enum {string}
1051
1307
  */
@@ -1071,6 +1327,141 @@ interface external {
1071
1327
  _slug?: string | null;
1072
1328
  /** @description Friendly name of this component. */
1073
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 connection */
1352
+ id: string;
1353
+ /** @description Display name of the data connection */
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 connection. No trailing slash. */
1358
+ baseUrl: string;
1359
+ /** @description HTTP headers to pass with requests to the data connection */
1360
+ headers?: {
1361
+ [key: string]: string;
1362
+ };
1363
+ /** @description Query String parameters to pass with requests to the data connection */
1364
+ parameters?: {
1365
+ [key: string]: string;
1366
+ };
1367
+ /** @description Variables needed to make calls to the data connection */
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 type */
1382
+ id: string;
1383
+ /** @description Display name of the data type */
1384
+ displayName: string;
1385
+ /** @description Public ID of the associated data connection */
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 type. Merged with headers from the data connection, overriding identical keys. */
1396
+ headers?: {
1397
+ [key: string]: string;
1398
+ };
1399
+ /** @description Query String parameters to pass with requests to the data type. Merged with parameters from the data connection, overriding identical keys. */
1400
+ parameters?: {
1401
+ [key: string]: string;
1402
+ };
1403
+ /** @description Body to pass with requests to the data type (ignored unless method is POST) */
1404
+ body?: string;
1405
+ /**
1406
+ * @description HTTP method to use with requests to the data type.
1407
+ * @default GET
1408
+ * @enum {string}
1409
+ */
1410
+ method: "GET" | "POST" | "HEAD";
1411
+ /** @description Variables needed to make calls to the data type. Merged with variables from the data connection, overriding identical keys. */
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;
1074
1465
  };
1075
1466
  };
1076
1467
  };
@@ -1082,9 +1473,14 @@ declare type Components = components['schemas'];
1082
1473
  declare type SharedComponents = components$1['schemas'];
1083
1474
  declare type Api = paths['/api/v1/canvas'];
1084
1475
  /** Query parameter options for GET /api/v1/canvas */
1085
- 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];
1086
1480
  /** The GET response from /api/v1/canvas when `component` or `slug` params are specified */
1087
1481
  declare type CompositionGetResponse = Components['CompositionApiResponse'];
1482
+ /** @deprecated - internal use, do not rely on this value */
1483
+ declare type CompositionUIStatus = NonNullable<Components['CompositionApiResponse']['uiStatus']>;
1088
1484
  /** The GET response from /api/v1/canvas when `component` or `slug` are not specified */
1089
1485
  declare type CompositionGetListResponse = Components['CompositionListResponse'];
1090
1486
  /** The PUT request body for /api/v1/canvas */
@@ -1107,13 +1503,11 @@ declare type ComponentParameter<TValue = unknown> = Omit<SharedComponents['Compo
1107
1503
  /** Defines a binding from a resource data value to a component parameter value. */
1108
1504
  declare type ComponentParameterBinding = SharedComponents['ComponentParameterBinding'];
1109
1505
  /** Variables defined for this composition. */
1110
- declare type CompositionVariableDefinitions = Components['CompositionVariableDefinitions'];
1111
- /** Defines a variable value that can be used in resources and bindings. */
1112
- declare type CompositionVariable = Components['CompositionVariable'];
1506
+ declare type CompositionDataVariables = SharedComponents['CompositionDataVariables'];
1113
1507
  /** Defines the shape of a resource bound to a composition */
1114
- declare type CompositionResourceDefinitions = components['schemas']['CompositionResourceDefinitions'];
1508
+ declare type CompositionDataDefinitions = SharedComponents['CompositionDataDefinitions'];
1115
1509
  /** Defines the shape of a resource bound to a composition */
1116
- declare type CompositionResourceDefinition = components['schemas']['CompositionResourceDefinition'];
1510
+ declare type CompositionDataDefinition = SharedComponents['CompositionDataDefinition'];
1117
1511
  /** Defines the shape of a component instance served by the composition API. */
1118
1512
  declare type ComponentInstance = SharedComponents['ComponentInstance'] & {
1119
1513
  /** Data for the component instance, provided by a component enhancer. Never set in unenhanced data. */
@@ -1152,4 +1546,4 @@ declare global {
1152
1546
  */
1153
1547
  declare function createEventBus(): Promise<PreviewEventBus | undefined>;
1154
1548
 
1155
- export { CompositionVariableDefinitions as A, CompositionVariable as B, ComponentInstance as C, CompositionResourceDefinitions as D, CompositionResourceDefinition as E, CanvasDefinitions as F, ChannelSubscription as G, createEventBus as H, 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, CompositionGetResponse as i, ComponentDefinitionGetResponse as j, ComponentDefinitionAPIResponse as k, ComponentDefinitionAPIPutRequest as l, ComponentDefinitionAPIDeleteRequest as m, ComponentDefinitionListAPIOptions as n, ComponentDefinitionParameter as o, ComponentDefinitionVariant as p, ComponentDefinitionSlugSettings as q, ComponentDefinitionSlot as r, ComponentDefinitionPermission as s, ComponentDefinition as t, CreatingComponentDefinition as u, CompositionGetOrderBy as v, CompositionUIStatus as w, CompositionGetListResponse as x, CompositionAPIResponse as y, CompositionAPIDeleteRequest as z };