@splunk/visualization-schemas 28.5.2 → 28.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +13 -0
- package/dist/cjs/index.js +527 -7
- package/dist/cjs/index.js.map +3 -3
- package/dist/esm/index.js +527 -7
- package/dist/esm/index.js.map +3 -3
- package/dist/types/optionsSchemas/index.d.ts +2 -0
- package/dist/types/optionsSchemas/processtree.d.ts +1 -0
- package/dist/types/optionsSchemas/richtext.d.ts +15 -0
- package/package.json +7 -7
- package/LICENSE.md +0 -449
package/dist/esm/index.js
CHANGED
|
@@ -329,6 +329,11 @@ var enhanceOptionsSchemaWithDynamicOptions = (optionsSchema) => {
|
|
|
329
329
|
|
|
330
330
|
// src/optionsSchemas/area.ts
|
|
331
331
|
var areaOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
332
|
+
acceleratedRender: {
|
|
333
|
+
default: false,
|
|
334
|
+
description: "Specify whether to enable canvas rendering to render large datasets more efficiently. This mode improves initial render time and interaction responsiveness for large time-series datasets.",
|
|
335
|
+
type: "boolean"
|
|
336
|
+
},
|
|
332
337
|
x: {
|
|
333
338
|
default: "> primary | seriesByIndex(0)",
|
|
334
339
|
description: "Specify the data source to apply to the x-axis.",
|
|
@@ -440,6 +445,17 @@ var areaOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
440
445
|
"longDash", "dashDot", "longDashDot", "longDashDotDot".`,
|
|
441
446
|
type: "object"
|
|
442
447
|
},
|
|
448
|
+
stepPosition: {
|
|
449
|
+
description: 'Specify stepped interpolation position for area series in accelerated render mode. Valid values: "off", "before", "after".',
|
|
450
|
+
pattern: getPattern(["off", "before", "after"]),
|
|
451
|
+
type: "string",
|
|
452
|
+
default: "off"
|
|
453
|
+
},
|
|
454
|
+
stepPositionsByField: {
|
|
455
|
+
description: `Specify stepped interpolation position for each field in accelerated render mode. For example, {"count": "before", "percent": "off"}.
|
|
456
|
+
Valid values: "off", "before", "after".`,
|
|
457
|
+
type: "object"
|
|
458
|
+
},
|
|
443
459
|
lineWidth: {
|
|
444
460
|
default: 2,
|
|
445
461
|
description: "Specify the line width (px) for overlay field lines.",
|
|
@@ -489,6 +505,11 @@ var areaOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
489
505
|
type: "boolean",
|
|
490
506
|
default: false
|
|
491
507
|
},
|
|
508
|
+
showLineSmoothing: {
|
|
509
|
+
default: false,
|
|
510
|
+
description: "Specify whether lines are straight or smoothed using curves. Only supported in accelerated render mode.",
|
|
511
|
+
type: "boolean"
|
|
512
|
+
},
|
|
492
513
|
showLines: {
|
|
493
514
|
description: "Specify whether to show lines in area charts.",
|
|
494
515
|
default: true,
|
|
@@ -569,6 +590,20 @@ var areaOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
569
590
|
type: "boolean",
|
|
570
591
|
description: "Specify whether all visualizations will share the same scale in the trellis container."
|
|
571
592
|
},
|
|
593
|
+
trellisSortBy: {
|
|
594
|
+
default: "result",
|
|
595
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, or name to sort alphabetically by visualization label.",
|
|
596
|
+
type: "string",
|
|
597
|
+
pattern: getPattern(["result", "name"]),
|
|
598
|
+
enum: ["result", "name"]
|
|
599
|
+
},
|
|
600
|
+
trellisSortOrder: {
|
|
601
|
+
default: "ascending",
|
|
602
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
603
|
+
type: "string",
|
|
604
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
605
|
+
enum: ["ascending", "descending"]
|
|
606
|
+
},
|
|
572
607
|
trellisSplitBy: {
|
|
573
608
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
574
609
|
type: "string"
|
|
@@ -849,7 +884,7 @@ var barOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
849
884
|
},
|
|
850
885
|
dataValuesDisplay: {
|
|
851
886
|
default: "off",
|
|
852
|
-
description: 'Specify the labels to display. Enter "all" to show
|
|
887
|
+
description: 'Specify the labels to display. Enter "all" to show labels for all data points, "off" to show no labels, or "minmax" to show high and low values.',
|
|
853
888
|
pattern: getPattern(["off", "all", "minmax"]),
|
|
854
889
|
type: "string"
|
|
855
890
|
},
|
|
@@ -1032,6 +1067,20 @@ var barOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
1032
1067
|
type: "boolean",
|
|
1033
1068
|
description: "Specify whether all visualizations will share the same scale in the trellis container."
|
|
1034
1069
|
},
|
|
1070
|
+
trellisSortBy: {
|
|
1071
|
+
default: "result",
|
|
1072
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, or name to sort alphabetically by visualization label.",
|
|
1073
|
+
type: "string",
|
|
1074
|
+
pattern: getPattern(["result", "name"]),
|
|
1075
|
+
enum: ["result", "name"]
|
|
1076
|
+
},
|
|
1077
|
+
trellisSortOrder: {
|
|
1078
|
+
default: "ascending",
|
|
1079
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
1080
|
+
type: "string",
|
|
1081
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
1082
|
+
enum: ["ascending", "descending"]
|
|
1083
|
+
},
|
|
1035
1084
|
trellisSplitBy: {
|
|
1036
1085
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
1037
1086
|
type: "string"
|
|
@@ -1819,6 +1868,20 @@ var columnOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
1819
1868
|
type: "boolean",
|
|
1820
1869
|
description: "Specify whether all visualizations will share the same scale in the trellis container."
|
|
1821
1870
|
},
|
|
1871
|
+
trellisSortBy: {
|
|
1872
|
+
default: "result",
|
|
1873
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, or name to sort alphabetically by visualization label.",
|
|
1874
|
+
type: "string",
|
|
1875
|
+
pattern: getPattern(["result", "name"]),
|
|
1876
|
+
enum: ["result", "name"]
|
|
1877
|
+
},
|
|
1878
|
+
trellisSortOrder: {
|
|
1879
|
+
default: "ascending",
|
|
1880
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
1881
|
+
type: "string",
|
|
1882
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
1883
|
+
enum: ["ascending", "descending"]
|
|
1884
|
+
},
|
|
1822
1885
|
trellisSplitBy: {
|
|
1823
1886
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
1824
1887
|
type: "string"
|
|
@@ -2179,6 +2242,11 @@ var eventsOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
2179
2242
|
pattern: getPattern(validSegmentationModes),
|
|
2180
2243
|
default: "none"
|
|
2181
2244
|
},
|
|
2245
|
+
pageCount: {
|
|
2246
|
+
description: "Specify the maximum number of rows to display per page.",
|
|
2247
|
+
type: "number",
|
|
2248
|
+
default: 10
|
|
2249
|
+
},
|
|
2182
2250
|
showFieldSummary: {
|
|
2183
2251
|
description: "Specify that a field summary popup appears when a field is selected. To show field summaries for a search, configure an additional datasource called `fieldsummary` using the original search followed by the `... | fieldsummary maxvals=10` SPL command.",
|
|
2184
2252
|
type: "boolean",
|
|
@@ -2253,6 +2321,20 @@ var fillerGaugeOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
2253
2321
|
description: "Specify the height, in pixels, of each visualization in the trellis container. If the window or panel is resized, the remaining visualizations may be viewed by scrolling. The minimum value is 1.",
|
|
2254
2322
|
type: "number"
|
|
2255
2323
|
},
|
|
2324
|
+
trellisSortBy: {
|
|
2325
|
+
default: "result",
|
|
2326
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, name to sort alphabetically by visualization label, or value to sort by the major value.",
|
|
2327
|
+
type: "string",
|
|
2328
|
+
pattern: getPattern(["result", "name", "value"]),
|
|
2329
|
+
enum: ["result", "name", "value"]
|
|
2330
|
+
},
|
|
2331
|
+
trellisSortOrder: {
|
|
2332
|
+
default: "ascending",
|
|
2333
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
2334
|
+
type: "string",
|
|
2335
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
2336
|
+
enum: ["ascending", "descending"]
|
|
2337
|
+
},
|
|
2256
2338
|
trellisSplitBy: {
|
|
2257
2339
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
2258
2340
|
type: "string"
|
|
@@ -2280,6 +2362,10 @@ var imageOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
2280
2362
|
default: false,
|
|
2281
2363
|
description: "Set to true to maintain the aspect ratio of an image when the screen is resized.",
|
|
2282
2364
|
type: "boolean"
|
|
2365
|
+
},
|
|
2366
|
+
title: {
|
|
2367
|
+
description: "Specify the title used as alternative text for the image. This text is read by screen readers and displayed when the image cannot be shown.",
|
|
2368
|
+
type: "string"
|
|
2283
2369
|
}
|
|
2284
2370
|
});
|
|
2285
2371
|
|
|
@@ -2287,7 +2373,7 @@ var imageOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
2287
2373
|
var lineOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
2288
2374
|
acceleratedRender: {
|
|
2289
2375
|
default: false,
|
|
2290
|
-
description: "Specify whether to
|
|
2376
|
+
description: "Specify whether to enable canvas rendering to render large datasets more efficiently. This mode improves initial render time and interaction responsiveness for large time-series datasets.",
|
|
2291
2377
|
type: "boolean"
|
|
2292
2378
|
},
|
|
2293
2379
|
x: {
|
|
@@ -2537,6 +2623,20 @@ var lineOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
2537
2623
|
type: "boolean",
|
|
2538
2624
|
description: "Specify whether all visualizations will share the same scale in the trellis container."
|
|
2539
2625
|
},
|
|
2626
|
+
trellisSortBy: {
|
|
2627
|
+
default: "result",
|
|
2628
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, or name to sort alphabetically by visualization label.",
|
|
2629
|
+
type: "string",
|
|
2630
|
+
pattern: getPattern(["result", "name"]),
|
|
2631
|
+
enum: ["result", "name"]
|
|
2632
|
+
},
|
|
2633
|
+
trellisSortOrder: {
|
|
2634
|
+
default: "ascending",
|
|
2635
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
2636
|
+
type: "string",
|
|
2637
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
2638
|
+
enum: ["ascending", "descending"]
|
|
2639
|
+
},
|
|
2540
2640
|
trellisSplitBy: {
|
|
2541
2641
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
2542
2642
|
type: "string"
|
|
@@ -2805,7 +2905,7 @@ var linkGraphOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
2805
2905
|
default: "> nodeColor | maxContrast(nodeTextColorMaxContrast)"
|
|
2806
2906
|
},
|
|
2807
2907
|
nodeLabelOverflow: {
|
|
2808
|
-
description: '
|
|
2908
|
+
description: 'Specify the text overflow for node labels. Valid types include "break-word", "anywhere", and "ellipsis".',
|
|
2809
2909
|
type: "string",
|
|
2810
2910
|
pattern: getPattern(validTextOverflows),
|
|
2811
2911
|
default: "ellipsis"
|
|
@@ -3318,6 +3418,20 @@ var markerGaugeOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
3318
3418
|
description: "Specify the height, in pixels, of each visualization in the trellis container. If the window or panel is resized, the remaining visualizations may be viewed by scrolling. The minimum value is 1.",
|
|
3319
3419
|
type: "number"
|
|
3320
3420
|
},
|
|
3421
|
+
trellisSortBy: {
|
|
3422
|
+
default: "result",
|
|
3423
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, name to sort alphabetically by visualization label, or value to sort by the major value.",
|
|
3424
|
+
type: "string",
|
|
3425
|
+
pattern: getPattern(["result", "name", "value"]),
|
|
3426
|
+
enum: ["result", "name", "value"]
|
|
3427
|
+
},
|
|
3428
|
+
trellisSortOrder: {
|
|
3429
|
+
default: "ascending",
|
|
3430
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
3431
|
+
type: "string",
|
|
3432
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
3433
|
+
enum: ["ascending", "descending"]
|
|
3434
|
+
},
|
|
3321
3435
|
trellisSplitBy: {
|
|
3322
3436
|
description: 'Specify the field name of the column with categories used, or "aggregations", to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.',
|
|
3323
3437
|
type: "string"
|
|
@@ -3664,9 +3778,9 @@ var pieOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
3664
3778
|
default: "values"
|
|
3665
3779
|
},
|
|
3666
3780
|
percentagePrecision: {
|
|
3667
|
-
description: "Specify the number of decimal places to display for percentages. The minimum value is 0. The maximum value is
|
|
3781
|
+
description: "Specify the number of decimal places to display for percentages. The minimum value is 0. The maximum value is 16.",
|
|
3668
3782
|
type: "number",
|
|
3669
|
-
minimum:
|
|
3783
|
+
minimum: 0,
|
|
3670
3784
|
maximum: 16,
|
|
3671
3785
|
default: 0
|
|
3672
3786
|
},
|
|
@@ -3729,8 +3843,22 @@ var pieOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
3729
3843
|
description: "Specify the height, in pixels, of each visualization in the trellis container. If the window or panel is resized, the remaining visualizations may be viewed by scrolling. The minimum value is 1.",
|
|
3730
3844
|
type: "number"
|
|
3731
3845
|
},
|
|
3846
|
+
trellisSortBy: {
|
|
3847
|
+
default: "result",
|
|
3848
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, or name to sort alphabetically by visualization label.",
|
|
3849
|
+
type: "string",
|
|
3850
|
+
pattern: getPattern(["result", "name"]),
|
|
3851
|
+
enum: ["result", "name"]
|
|
3852
|
+
},
|
|
3853
|
+
trellisSortOrder: {
|
|
3854
|
+
default: "ascending",
|
|
3855
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
3856
|
+
type: "string",
|
|
3857
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
3858
|
+
enum: ["ascending", "descending"]
|
|
3859
|
+
},
|
|
3732
3860
|
trellisSplitBy: {
|
|
3733
|
-
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable.",
|
|
3861
|
+
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
3734
3862
|
type: "string"
|
|
3735
3863
|
},
|
|
3736
3864
|
value: {
|
|
@@ -3748,6 +3876,157 @@ var pieOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
3748
3876
|
}
|
|
3749
3877
|
});
|
|
3750
3878
|
|
|
3879
|
+
// src/optionsSchemas/processtree.ts
|
|
3880
|
+
var processTreeOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
3881
|
+
backgroundColor: {
|
|
3882
|
+
default: "> themes.defaultBackgroundColor",
|
|
3883
|
+
description: "Specify the color for the background.",
|
|
3884
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA,
|
|
3885
|
+
type: "string"
|
|
3886
|
+
},
|
|
3887
|
+
source: {
|
|
3888
|
+
default: '> primary | frameBySeriesTypes("string") | seriesByIndex(0)',
|
|
3889
|
+
description: "Specify the source node id for each link row.",
|
|
3890
|
+
type: "array",
|
|
3891
|
+
items: {
|
|
3892
|
+
type: "string"
|
|
3893
|
+
}
|
|
3894
|
+
},
|
|
3895
|
+
target: {
|
|
3896
|
+
default: '> primary | frameBySeriesTypes("string") | seriesByIndex(1)',
|
|
3897
|
+
description: "Specify the target node id for each link row.",
|
|
3898
|
+
type: "array",
|
|
3899
|
+
items: {
|
|
3900
|
+
type: "string"
|
|
3901
|
+
}
|
|
3902
|
+
},
|
|
3903
|
+
nodeId: {
|
|
3904
|
+
default: '> nodeSource | seriesByName("node_id")',
|
|
3905
|
+
description: "Specify node ids for node metadata lookup when using a secondary node datasource.",
|
|
3906
|
+
type: "array",
|
|
3907
|
+
items: {
|
|
3908
|
+
type: "string"
|
|
3909
|
+
}
|
|
3910
|
+
},
|
|
3911
|
+
nodeColors: {
|
|
3912
|
+
default: [],
|
|
3913
|
+
description: "Specify optional node colors aligned with nodeSource rows. Currently applied only to network chip text color. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3914
|
+
type: ["array", "string"],
|
|
3915
|
+
items: {
|
|
3916
|
+
type: "string"
|
|
3917
|
+
}
|
|
3918
|
+
},
|
|
3919
|
+
nodeIcons: {
|
|
3920
|
+
default: [],
|
|
3921
|
+
description: "Specify optional node icons aligned with nodeSource rows. Supported built-in values are fire, rectangleDashed, cube, servers, and container. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3922
|
+
type: ["array", "string"],
|
|
3923
|
+
items: {
|
|
3924
|
+
type: "string"
|
|
3925
|
+
}
|
|
3926
|
+
},
|
|
3927
|
+
linkValues: {
|
|
3928
|
+
default: [],
|
|
3929
|
+
description: "Specify link values for each link row.",
|
|
3930
|
+
type: "array",
|
|
3931
|
+
items: {
|
|
3932
|
+
type: ["number", "string"]
|
|
3933
|
+
}
|
|
3934
|
+
},
|
|
3935
|
+
highlightedNodeId: {
|
|
3936
|
+
default: "",
|
|
3937
|
+
description: "Specify a node id to highlight in the process tree.",
|
|
3938
|
+
type: "string"
|
|
3939
|
+
},
|
|
3940
|
+
highlightColor: {
|
|
3941
|
+
default: "rgba(129, 51, 74, 0.82)",
|
|
3942
|
+
description: "Specify the background color used for the highlighted node row.",
|
|
3943
|
+
type: "string"
|
|
3944
|
+
},
|
|
3945
|
+
highlightIcon: {
|
|
3946
|
+
default: "",
|
|
3947
|
+
description: "Specify an optional built-in icon to render for the highlighted node. Supported values are fire, rectangleDashed, cube, servers, and container.",
|
|
3948
|
+
type: "string"
|
|
3949
|
+
},
|
|
3950
|
+
highlightIconColor: {
|
|
3951
|
+
default: "",
|
|
3952
|
+
description: "Specify an optional color override for the highlighted node icon.",
|
|
3953
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA,
|
|
3954
|
+
type: "string"
|
|
3955
|
+
},
|
|
3956
|
+
treeNodeLabelFields: {
|
|
3957
|
+
default: [],
|
|
3958
|
+
description: "Specify nodeSource field names to render in each tree node label, joined by spaces. Empty or null values are skipped. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3959
|
+
type: ["array", "string"],
|
|
3960
|
+
items: {
|
|
3961
|
+
type: "string"
|
|
3962
|
+
}
|
|
3963
|
+
},
|
|
3964
|
+
fieldsToShowAsChip: {
|
|
3965
|
+
default: [],
|
|
3966
|
+
description: "Specify treeNodeLabelFields names whose values should be rendered as chips. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3967
|
+
type: ["array", "string"],
|
|
3968
|
+
items: {
|
|
3969
|
+
type: "string"
|
|
3970
|
+
}
|
|
3971
|
+
},
|
|
3972
|
+
showFieldName: {
|
|
3973
|
+
default: false,
|
|
3974
|
+
description: "Specify whether tree node labels render as field=value. When false, only the field value is shown.",
|
|
3975
|
+
type: "boolean"
|
|
3976
|
+
},
|
|
3977
|
+
disableExpansionPerNode: {
|
|
3978
|
+
default: [],
|
|
3979
|
+
description: "Specify per-node expansion behavior aligned with nodeSource rows. Use 'disable' to prevent collapsing/expanding that node; 'enable' or null allows expansion. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3980
|
+
type: ["array", "string"],
|
|
3981
|
+
items: {
|
|
3982
|
+
type: "string"
|
|
3983
|
+
}
|
|
3984
|
+
},
|
|
3985
|
+
filteredNodeField: {
|
|
3986
|
+
description: "Specify node field name used to classify which nodes render in the right panel and are excluded from the left tree.",
|
|
3987
|
+
type: "string"
|
|
3988
|
+
},
|
|
3989
|
+
filteredNodeValues: {
|
|
3990
|
+
description: "Specify field value(s) used with filteredNodeField to classify which nodes render in the right panel. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3991
|
+
type: ["array", "string"],
|
|
3992
|
+
items: {
|
|
3993
|
+
type: "string"
|
|
3994
|
+
}
|
|
3995
|
+
},
|
|
3996
|
+
filterButtonFields: {
|
|
3997
|
+
default: [],
|
|
3998
|
+
description: "Specify nodeSource field names used by connection filter buttons. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
3999
|
+
type: ["array", "string"],
|
|
4000
|
+
items: {
|
|
4001
|
+
type: "string"
|
|
4002
|
+
}
|
|
4003
|
+
},
|
|
4004
|
+
filterButtonMatchValues: {
|
|
4005
|
+
default: [],
|
|
4006
|
+
description: "Specify match values used by connection filter buttons. Provide an array, or use a string DSL expression that resolves to an array.",
|
|
4007
|
+
type: ["array", "string"],
|
|
4008
|
+
items: {
|
|
4009
|
+
type: "string"
|
|
4010
|
+
}
|
|
4011
|
+
},
|
|
4012
|
+
filterButtonNames: {
|
|
4013
|
+
default: [],
|
|
4014
|
+
description: "Specify display names for connection filter buttons. Provide an array, or use a string DSL expression that resolves to an array. Falls back to filterButtonMatchValues when omitted.",
|
|
4015
|
+
type: ["array", "string"],
|
|
4016
|
+
items: {
|
|
4017
|
+
type: "string"
|
|
4018
|
+
}
|
|
4019
|
+
},
|
|
4020
|
+
filterButtonColors: {
|
|
4021
|
+
default: [],
|
|
4022
|
+
description: "Specify optional colors for connection filter buttons (for example #FF0000). Provide an array, or use a string DSL expression that resolves to an array.",
|
|
4023
|
+
type: ["array", "string"],
|
|
4024
|
+
items: {
|
|
4025
|
+
type: "string"
|
|
4026
|
+
}
|
|
4027
|
+
}
|
|
4028
|
+
});
|
|
4029
|
+
|
|
3751
4030
|
// src/optionsSchemas/punchcard.ts
|
|
3752
4031
|
var punchcardOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
3753
4032
|
x: {
|
|
@@ -3880,6 +4159,157 @@ var punchcardOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
3880
4159
|
}
|
|
3881
4160
|
});
|
|
3882
4161
|
|
|
4162
|
+
// src/optionsSchemas/richtext.ts
|
|
4163
|
+
var pureRichTextOptionsSchema = {
|
|
4164
|
+
// Container styling
|
|
4165
|
+
backgroundColor: {
|
|
4166
|
+
description: 'Specify the background color using a Hex code such as "#FF0000" or "transparent".',
|
|
4167
|
+
type: "string",
|
|
4168
|
+
default: "transparent",
|
|
4169
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA
|
|
4170
|
+
},
|
|
4171
|
+
// Font styling
|
|
4172
|
+
fontColor: {
|
|
4173
|
+
description: 'Specify the text color using Hex codes or RGBA values, such as "#FF0000" or "rgba(25,12,13,0.1)". The default for enterprise light is "#3c444d". The default for enterprise dark is "#FFFFFF". The default for prisma dark is "rgba(255, 255, 255, 0.7)".',
|
|
4174
|
+
type: "string",
|
|
4175
|
+
default: "> themes.defaultFontColor",
|
|
4176
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA
|
|
4177
|
+
},
|
|
4178
|
+
highlightColor: {
|
|
4179
|
+
description: "Specify the highlight/background color for selected text using Hex codes or RGBA values.",
|
|
4180
|
+
type: "string",
|
|
4181
|
+
default: "transparent",
|
|
4182
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA
|
|
4183
|
+
},
|
|
4184
|
+
fontFamily: {
|
|
4185
|
+
description: 'Specify the font family for rich text content, such as "Arial" or "Times New Roman". Note: the font needs to be available to your end user.',
|
|
4186
|
+
type: "string",
|
|
4187
|
+
default: "Splunk Data Sans",
|
|
4188
|
+
pattern: getPattern([
|
|
4189
|
+
"Splunk Data Sans",
|
|
4190
|
+
"Splunk Platform Sans Mono",
|
|
4191
|
+
"Arial",
|
|
4192
|
+
"Helvetica",
|
|
4193
|
+
"Times New Roman",
|
|
4194
|
+
"Comic Sans MS",
|
|
4195
|
+
"Georgia",
|
|
4196
|
+
"Verdana",
|
|
4197
|
+
"Courier New"
|
|
4198
|
+
])
|
|
4199
|
+
},
|
|
4200
|
+
fontSize: {
|
|
4201
|
+
description: "Specify the base font size preset. Font sizes range from extra small (10px) to extra large (20px) with the default being 14px.",
|
|
4202
|
+
type: "string",
|
|
4203
|
+
default: "default",
|
|
4204
|
+
pattern: getPattern(["extraSmall", "small", "default", "large", "extraLarge", "custom"])
|
|
4205
|
+
},
|
|
4206
|
+
customFontSize: {
|
|
4207
|
+
description: 'Specify the custom font size in pixels when fontSize is set to "custom". Valid range is 1-200.',
|
|
4208
|
+
type: "number",
|
|
4209
|
+
default: 14,
|
|
4210
|
+
minimum: 1,
|
|
4211
|
+
maximum: 200
|
|
4212
|
+
},
|
|
4213
|
+
// Text formatting
|
|
4214
|
+
bold: {
|
|
4215
|
+
description: "Apply bold font weight to all text by default.",
|
|
4216
|
+
type: "boolean",
|
|
4217
|
+
default: false
|
|
4218
|
+
},
|
|
4219
|
+
italic: {
|
|
4220
|
+
description: "Apply italic font style to all text by default.",
|
|
4221
|
+
type: "boolean",
|
|
4222
|
+
default: false
|
|
4223
|
+
},
|
|
4224
|
+
underline: {
|
|
4225
|
+
description: "Apply underline text decoration to all text by default.",
|
|
4226
|
+
type: "boolean",
|
|
4227
|
+
default: false
|
|
4228
|
+
},
|
|
4229
|
+
strikethrough: {
|
|
4230
|
+
description: "Apply strikethrough text decoration to all text by default.",
|
|
4231
|
+
type: "boolean",
|
|
4232
|
+
default: false
|
|
4233
|
+
},
|
|
4234
|
+
// List type
|
|
4235
|
+
listType: {
|
|
4236
|
+
description: "Specify the default list type for the content.",
|
|
4237
|
+
type: "string",
|
|
4238
|
+
default: "",
|
|
4239
|
+
pattern: getPattern(["", "unordered", "ordered"])
|
|
4240
|
+
},
|
|
4241
|
+
// Alignment
|
|
4242
|
+
horizontalAlignment: {
|
|
4243
|
+
description: "Specify the horizontal text alignment.",
|
|
4244
|
+
type: "string",
|
|
4245
|
+
default: "left",
|
|
4246
|
+
pattern: getPattern(["left", "center", "right", "justify"])
|
|
4247
|
+
},
|
|
4248
|
+
verticalAlign: {
|
|
4249
|
+
description: "Specify the vertical alignment of content within the container.",
|
|
4250
|
+
type: "string",
|
|
4251
|
+
default: "top",
|
|
4252
|
+
pattern: getPattern(["top", "middle", "bottom"])
|
|
4253
|
+
},
|
|
4254
|
+
// Line height
|
|
4255
|
+
lineHeight: {
|
|
4256
|
+
description: "Specify the line height as a number (e.g., 1.5 means 150% of font size) or string value.",
|
|
4257
|
+
type: ["number", "string"],
|
|
4258
|
+
default: "1.5"
|
|
4259
|
+
},
|
|
4260
|
+
// Link
|
|
4261
|
+
link: {
|
|
4262
|
+
description: "Specify a URL to make the entire rich text content a clickable link.",
|
|
4263
|
+
type: "string",
|
|
4264
|
+
default: ""
|
|
4265
|
+
},
|
|
4266
|
+
// Border configuration
|
|
4267
|
+
border: {
|
|
4268
|
+
description: "Border configuration for the rich text container.",
|
|
4269
|
+
type: "object",
|
|
4270
|
+
properties: {
|
|
4271
|
+
color: {
|
|
4272
|
+
description: "Border color using Hex codes or RGBA values.",
|
|
4273
|
+
type: "string",
|
|
4274
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA
|
|
4275
|
+
},
|
|
4276
|
+
width: {
|
|
4277
|
+
description: "Border width in pixels.",
|
|
4278
|
+
type: "number",
|
|
4279
|
+
default: 0,
|
|
4280
|
+
minimum: 0,
|
|
4281
|
+
maximum: 20
|
|
4282
|
+
},
|
|
4283
|
+
style: {
|
|
4284
|
+
description: "Border style.",
|
|
4285
|
+
type: "string",
|
|
4286
|
+
default: "solid",
|
|
4287
|
+
pattern: getPattern(["solid", "dashed", "dotted", "none"])
|
|
4288
|
+
},
|
|
4289
|
+
radius: {
|
|
4290
|
+
description: "Border radius (corner radius) in pixels.",
|
|
4291
|
+
type: "number",
|
|
4292
|
+
default: 0,
|
|
4293
|
+
minimum: 0,
|
|
4294
|
+
maximum: 100
|
|
4295
|
+
}
|
|
4296
|
+
}
|
|
4297
|
+
},
|
|
4298
|
+
// Padding
|
|
4299
|
+
padding: {
|
|
4300
|
+
description: "Padding in pixels. Can be a single number (all sides), array of 2 (vertical, horizontal), or array of 4 (top, right, bottom, left).",
|
|
4301
|
+
type: ["number", "array"],
|
|
4302
|
+
default: 8
|
|
4303
|
+
},
|
|
4304
|
+
// Rich text content (HTML)
|
|
4305
|
+
richTextContent: {
|
|
4306
|
+
description: "HTML content for the rich text editor. Inline styles should only include differences from default text styles.",
|
|
4307
|
+
type: "string",
|
|
4308
|
+
default: "<p></p>"
|
|
4309
|
+
}
|
|
4310
|
+
};
|
|
4311
|
+
var richTextOptionsSchema = pureRichTextOptionsSchema;
|
|
4312
|
+
|
|
3883
4313
|
// src/optionsSchemas/rectangle.ts
|
|
3884
4314
|
var rectangleOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
3885
4315
|
fillColor: {
|
|
@@ -4147,8 +4577,22 @@ var scatterOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4147
4577
|
type: "boolean",
|
|
4148
4578
|
description: "Specify whether all visualizations will share the same scale in the trellis container."
|
|
4149
4579
|
},
|
|
4580
|
+
trellisSortBy: {
|
|
4581
|
+
default: "result",
|
|
4582
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, or name to sort alphabetically by visualization label.",
|
|
4583
|
+
type: "string",
|
|
4584
|
+
pattern: getPattern(["result", "name"]),
|
|
4585
|
+
enum: ["result", "name"]
|
|
4586
|
+
},
|
|
4587
|
+
trellisSortOrder: {
|
|
4588
|
+
default: "ascending",
|
|
4589
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
4590
|
+
type: "string",
|
|
4591
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
4592
|
+
enum: ["ascending", "descending"]
|
|
4593
|
+
},
|
|
4150
4594
|
trellisSplitBy: {
|
|
4151
|
-
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `
|
|
4595
|
+
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
4152
4596
|
type: "string"
|
|
4153
4597
|
},
|
|
4154
4598
|
xAxisLabelRotation: {
|
|
@@ -4480,6 +4924,20 @@ var singleValueOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4480
4924
|
description: "Specify the height, in pixels, of each visualization in the trellis container. If the window or panel is resized, the remaining visualizations may be viewed by scrolling. The minimum value is 1.",
|
|
4481
4925
|
type: "number"
|
|
4482
4926
|
},
|
|
4927
|
+
trellisSortBy: {
|
|
4928
|
+
default: "result",
|
|
4929
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, name to sort alphabetically by visualization label, value to sort by the major value, or trend to sort by the trend value.",
|
|
4930
|
+
type: "string",
|
|
4931
|
+
pattern: getPattern(["result", "name", "value", "trend"]),
|
|
4932
|
+
enum: ["result", "name", "value", "trend"]
|
|
4933
|
+
},
|
|
4934
|
+
trellisSortOrder: {
|
|
4935
|
+
default: "ascending",
|
|
4936
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
4937
|
+
type: "string",
|
|
4938
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
4939
|
+
enum: ["ascending", "descending"]
|
|
4940
|
+
},
|
|
4483
4941
|
trellisSplitBy: {
|
|
4484
4942
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
4485
4943
|
type: "string"
|
|
@@ -4488,6 +4946,12 @@ var singleValueOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4488
4946
|
description: "Specify the text that appears below the major value.",
|
|
4489
4947
|
type: "string"
|
|
4490
4948
|
},
|
|
4949
|
+
underLabelColor: {
|
|
4950
|
+
default: "> majorColor",
|
|
4951
|
+
description: "Specify the color for the under label text. You may use a dataSource to apply the color. The hex value format should be \u201C#FFFFFF\u201D. By default it follows the major value color.",
|
|
4952
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA,
|
|
4953
|
+
type: "string"
|
|
4954
|
+
},
|
|
4491
4955
|
underLabelFontSize: {
|
|
4492
4956
|
default: 12,
|
|
4493
4957
|
description: "Specify the font size (px) for the under label text.",
|
|
@@ -4649,6 +5113,20 @@ var singleValueIconOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4649
5113
|
description: "Specify the height, in pixels, of each visualization in the trellis container. If the window or panel is resized, the remaining visualizations may be viewed by scrolling. The minimum value is 1.",
|
|
4650
5114
|
type: "number"
|
|
4651
5115
|
},
|
|
5116
|
+
trellisSortBy: {
|
|
5117
|
+
default: "result",
|
|
5118
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, name to sort alphabetically by visualization label, value to sort by the major value, or trend to sort by the trend value.",
|
|
5119
|
+
type: "string",
|
|
5120
|
+
pattern: getPattern(["result", "name", "value", "trend"]),
|
|
5121
|
+
enum: ["result", "name", "value", "trend"]
|
|
5122
|
+
},
|
|
5123
|
+
trellisSortOrder: {
|
|
5124
|
+
default: "ascending",
|
|
5125
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
5126
|
+
type: "string",
|
|
5127
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
5128
|
+
enum: ["ascending", "descending"]
|
|
5129
|
+
},
|
|
4652
5130
|
trellisSplitBy: {
|
|
4653
5131
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
4654
5132
|
type: "string"
|
|
@@ -4657,6 +5135,12 @@ var singleValueIconOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4657
5135
|
description: "Specify the text that appears below the major value.",
|
|
4658
5136
|
type: "string"
|
|
4659
5137
|
},
|
|
5138
|
+
underLabelColor: {
|
|
5139
|
+
default: "> majorColor",
|
|
5140
|
+
description: "Specify the color for the under label text. You may use a dataSource to apply the color. The hex value format should be \u201C#FFFFFF\u201D. By default it follows the major value color.",
|
|
5141
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA,
|
|
5142
|
+
type: "string"
|
|
5143
|
+
},
|
|
4660
5144
|
unit: {
|
|
4661
5145
|
description: "Specify text to show next to the major value.",
|
|
4662
5146
|
type: "string"
|
|
@@ -4820,6 +5304,20 @@ var singleValueRadialOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4820
5304
|
description: "Specify the height, in pixels, of each visualization in the trellis container. If the window or panel is resized, the remaining visualizations may be viewed by scrolling. The minimum value is 1.",
|
|
4821
5305
|
type: "number"
|
|
4822
5306
|
},
|
|
5307
|
+
trellisSortBy: {
|
|
5308
|
+
default: "result",
|
|
5309
|
+
description: "Specify the sort method for the individual visualizations in the trellis container. Use result to sort by search result order, name to sort alphabetically by visualization label, value to sort by the major value, or trend to sort by the trend value.",
|
|
5310
|
+
type: "string",
|
|
5311
|
+
pattern: getPattern(["result", "name", "value", "trend"]),
|
|
5312
|
+
enum: ["result", "name", "value", "trend"]
|
|
5313
|
+
},
|
|
5314
|
+
trellisSortOrder: {
|
|
5315
|
+
default: "ascending",
|
|
5316
|
+
description: "Specify the sort order for the individual visualizations in the trellis container. This setting applies to the sort method specified in trellisSortBy.",
|
|
5317
|
+
type: "string",
|
|
5318
|
+
pattern: getPattern(["ascending", "descending"]),
|
|
5319
|
+
enum: ["ascending", "descending"]
|
|
5320
|
+
},
|
|
4823
5321
|
trellisSplitBy: {
|
|
4824
5322
|
description: "Specify the field name of the column with categories used, or \u201Caggregations\u201D, to split the data into individual visualizations for trellis display, if applicable. If a SPL `timechart` command is used, this may default to the SPL `by` clause field. If a SPL `chart` command is used, this may default to the first string field.",
|
|
4825
5323
|
type: "string"
|
|
@@ -4828,6 +5326,12 @@ var singleValueRadialOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
4828
5326
|
description: "Specify the text that appears below the major value.",
|
|
4829
5327
|
type: "string"
|
|
4830
5328
|
},
|
|
5329
|
+
underLabelColor: {
|
|
5330
|
+
default: "> majorColor",
|
|
5331
|
+
description: "Specify the color for the under label text. You may use a dataSource to apply the color. The hex value format should be \u201C#FFFFFF\u201D. By default it follows the major value color.",
|
|
5332
|
+
pattern: COLOR_OR_TOKEN_PATTERN_WITH_RGBA,
|
|
5333
|
+
type: "string"
|
|
5334
|
+
},
|
|
4831
5335
|
unit: {
|
|
4832
5336
|
description: "Specify text to show next to the major value.",
|
|
4833
5337
|
type: "string"
|
|
@@ -5004,6 +5508,13 @@ var tableOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
5004
5508
|
description: "Specify whether to show a row at the bottom of the table that displays total values for applicable columns.",
|
|
5005
5509
|
type: "boolean"
|
|
5006
5510
|
},
|
|
5511
|
+
showColumnAsExpandedJson: {
|
|
5512
|
+
description: "Specify row expansion content as stringified JSON. Provide either a DSL expression that resolves to an array of stringified JSON values, or a static array of stringified JSON values. Each item is rendered in the matching expanded row with JSONTree.",
|
|
5513
|
+
type: ["string", "array"],
|
|
5514
|
+
items: {
|
|
5515
|
+
type: "string"
|
|
5516
|
+
}
|
|
5517
|
+
},
|
|
5007
5518
|
showInternalFields: {
|
|
5008
5519
|
default: true,
|
|
5009
5520
|
description: "Specify whether to show internal fields that start with an underscore. The _time field will still be shown if false.",
|
|
@@ -5203,6 +5714,12 @@ var timelineOptionsSchema = enhanceOptionsSchemaWithDynamicOptions({
|
|
|
5203
5714
|
description: "Specify the field that should be mapped to the x-axis.",
|
|
5204
5715
|
type: "string"
|
|
5205
5716
|
},
|
|
5717
|
+
durationUnit: {
|
|
5718
|
+
default: "milliseconds",
|
|
5719
|
+
description: "Specify the unit of the values in the duration data source used to apply duration to events.",
|
|
5720
|
+
pattern: getPattern(["milliseconds", "seconds", "minutes", "hours"]),
|
|
5721
|
+
type: "string"
|
|
5722
|
+
},
|
|
5206
5723
|
categoryField: {
|
|
5207
5724
|
default: "> category | getField()",
|
|
5208
5725
|
description: "Specify the field that should be mapped to the y-axis.",
|
|
@@ -5284,10 +5801,13 @@ export {
|
|
|
5284
5801
|
networkGraphOptionsSchema,
|
|
5285
5802
|
parallelCoordinatesOptionsSchema,
|
|
5286
5803
|
pieOptionsSchema,
|
|
5804
|
+
processTreeOptionsSchema,
|
|
5287
5805
|
punchcardOptionsSchema,
|
|
5806
|
+
pureRichTextOptionsSchema,
|
|
5288
5807
|
rectangleOptionsSchema,
|
|
5289
5808
|
rgbColorPattern,
|
|
5290
5809
|
rgbaColorPattern,
|
|
5810
|
+
richTextOptionsSchema,
|
|
5291
5811
|
sankeyOptionsSchema,
|
|
5292
5812
|
scatterOptionsSchema,
|
|
5293
5813
|
schemaDraft07,
|