@salesforce/afv-skills 1.59.0 → 1.61.0

package/skills/tableau-next-asset-create/references/schemas/edit-dashboard/upsert_navigation_widget.json

@@ -0,0 +1,80 @@
+{
+  "title": "upsert_navigation_widget",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["operation", "widget"],
+  "properties": {
+    "operation": { "const": "upsert_navigation_widget" },
+    "widget": {
+      "type": "object",
+      "description": "Complete navigation (in-dashboard page navigation) widget definition for create or full replacement. Omitted fields are dropped on replacement. parameters.navigationItems is the ordered list of destinations; an omitted or empty list is an empty nav bar. Upsert defines the widget only; it neither places it nor changes existing placements. This is a gated pilot type: persisting the batch or using save_dashboard fails with ACCESS_DENIED unless the org has the navigation-widget pilot enabled.",
+      "required": ["type", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Existing widget ID. Required when fully replacing a persisted widget; omit when creating a widget. Never invent this value. An unsaved draft widget has no ID and may be replaced by matching widget.name."
+        },
+        "type": { "const": "navigation" },
+        "name": {
+          "type": "string",
+          "description": "Stable widget key, e.g. \"navigation_1\". On persisted replacement, it must match the widget identified by id."
+        },
+        "label": { "type": "string", "description": "Display label." },
+        "description": { "type": "string", "description": "Optional widget description (distinct from label)." },
+        "actions": {
+          "type": "array",
+          "description": "Optional click/select interactions. Full per-type shape: _shared-widget-fields.json.",
+          "items": { "type": "object", "required": ["actionType", "eventType"] }
+        },
+        "dynamicTokens": {
+          "type": "object",
+          "description": "Optional dynamic value bindings keyed by token name. Full shape: _shared-widget-fields.json.",
+          "additionalProperties": { "type": "object" }
+        },
+        "parameters": {
+          "type": "object",
+          "description": "Navigation widget parameters.",
+          "properties": {
+            "viewType": { "type": "string", "description": "How the navigation renders, e.g. \"tabs\"." },
+            "navigationItems": {
+              "type": "array",
+              "description": "Ordered navigation destinations.",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "id": { "type": "string", "description": "Item id." },
+                  "name": { "type": "string", "description": "Item dev name." },
+                  "label": { "type": "string", "description": "Display label for this item." },
+                  "description": { "type": "string", "description": "Optional item description." },
+                  "type": { "type": "string", "description": "Item type, e.g. \"page\"." },
+                  "target": { "type": "string", "description": "Target identifier (e.g. a page name)." },
+                  "order": { "type": "integer", "description": "Explicit position in the navigation order." },
+                  "hidden": { "type": "boolean", "description": "Whether the item is hidden." }
+                }
+              }
+            },
+            "labelStyle": { "type": "object", "description": "NavigationLabelStyle. Full shape: _shared-widget-fields.json#/styleBlocks/NavigationLabelStyle." },
+            "widgetStyle": { "type": "object", "description": "ButtonStyle. Full shape: _shared-widget-fields.json#/styleBlocks/ButtonStyle." },
+            "defaultStyle": { "type": "object", "description": "ButtonStyle applied to unselected items. Full shape: _shared-widget-fields.json#/styleBlocks/ButtonStyle." },
+            "selectedStyle": { "type": "object", "description": "ButtonStyle applied to the selected item. Full shape: _shared-widget-fields.json#/styleBlocks/ButtonStyle." },
+            "dropdownValueStyle": { "type": "object", "description": "WidgetTextStyle for a dropdown-rendered viewType. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." }
+          }
+        }
+      }
+    }
+  },
+  "example": {
+    "operation": "upsert_navigation_widget",
+    "widget": {
+      "type": "navigation",
+      "name": "navigation_1",
+      "label": "Pages",
+      "parameters": {
+        "viewType": "tabs",
+        "navigationItems": [
+          { "type": "page", "target": "page_1", "order": 0, "hidden": false }
+        ]
+      }
+    }
+  }
+}

package/skills/tableau-next-asset-create/references/schemas/edit-dashboard/upsert_parameter_widget.json

@@ -0,0 +1,160 @@
+{
+  "title": "upsert_parameter_widget",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["operation", "widget"],
+  "properties": {
+    "operation": { "const": "upsert_parameter_widget" },
+    "widget": {
+      "type": "object",
+      "description": "Complete parameter widget definition for create or full replacement. Omitted fields are dropped on replacement. source is optional; parameters carry the view type and the parameter option. Upsert defines the widget only; it neither places it nor changes existing placements.",
+      "required": ["type", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Existing widget ID. Required when fully replacing a persisted widget; omit when creating a widget. Never invent this value. An unsaved draft widget has no ID and may be replaced by matching widget.name."
+        },
+        "type": { "const": "parameter" },
+        "name": {
+          "type": "string",
+          "description": "Stable widget key, e.g. \"parameter_1\". On persisted replacement, it must match the widget identified by id."
+        },
+        "label": { "type": "string", "description": "Display label." },
+        "description": { "type": "string", "description": "Optional widget description (distinct from label)." },
+        "actions": {
+          "type": "array",
+          "description": "Optional click/select interactions. Full per-type shape: _shared-widget-fields.json.",
+          "items": { "type": "object", "required": ["actionType", "eventType"] }
+        },
+        "dynamicTokens": {
+          "type": "object",
+          "description": "Optional dynamic value bindings keyed by token name. Full shape: _shared-widget-fields.json.",
+          "additionalProperties": { "type": "object" }
+        },
+        "source": {
+          "type": "object",
+          "description": "Optional data source reference.",
+          "properties": {
+            "id": { "type": "string", "description": "Data source record id." },
+            "name": { "type": "string", "description": "Data source apiName." }
+          }
+        },
+        "initialValues": {
+          "type": "object",
+          "description": "Optional default parameter value applied when the dashboard loads.",
+          "properties": {
+            "details": { "description": "Untyped — shape depends on parameterOption.dataType (a scalar for text/number/date/boolean/percentage). No fixed schema; do not assume FilterDetails' shape here." }
+          }
+        },
+        "parameters": {
+          "description": "Parameter widget parameters — shape depends on viewType. oneOf ListParameterParameters | ListCardParameterParameters | ToggleParameterParameters | InputParameterParameters | InputCardParameterParameters. Send only the fields for your chosen viewType.",
+          "oneOf": [
+            {
+              "title": "ListParameterParameters",
+              "type": "object",
+              "required": ["viewType", "isLabelHidden"],
+              "properties": {
+                "viewType": { "const": "list" },
+                "isLabelHidden": { "type": "boolean", "description": "REQUIRED for viewType list/listcard." },
+                "parameterName": { "type": "string", "description": "The parameter's field/dev name." },
+                "parameterOption": {
+                  "type": "object",
+                  "description": "Parameter input configuration.",
+                  "properties": {
+                    "dataType": {
+                      "type": "string",
+                      "enum": ["text", "number", "date", "boolean", "percentage"],
+                      "description": "Input data type. Lowercase — a different casing convention than the filter widget's dataType; do not cross-copy."
+                    }
+                  }
+                },
+                "widgetStyle": { "type": "object", "description": "WidgetStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetStyle." },
+                "titleStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "valueStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "receiveParameterSource": { "type": "object", "description": "Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." }
+              }
+            },
+            {
+              "title": "ListCardParameterParameters",
+              "type": "object",
+              "required": ["viewType", "isLabelHidden"],
+              "properties": {
+                "viewType": { "const": "listcard" },
+                "isLabelHidden": { "type": "boolean", "description": "REQUIRED for viewType list/listcard." },
+                "parameterName": { "type": "string" },
+                "parameterOption": { "type": "object", "description": "Same shape as ListParameterParameters.parameterOption above." },
+                "widgetStyle": { "type": "object", "description": "WidgetStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetStyle." },
+                "titleStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "valueStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "receiveParameterSource": { "type": "object", "description": "Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." }
+              }
+            },
+            {
+              "title": "ToggleParameterParameters",
+              "type": "object",
+              "required": ["viewType"],
+              "description": "isLabelHidden is not required here (unlike list/listcard).",
+              "properties": {
+                "viewType": { "const": "toggle" },
+                "parameterName": { "type": "string" },
+                "parameterOption": { "type": "object", "description": "Same shape as ListParameterParameters.parameterOption above." },
+                "widgetStyle": { "type": "object", "description": "WidgetStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetStyle." },
+                "textStyle": { "type": "object", "description": "ToggleTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/ToggleTextStyle." },
+                "defaultStyle": { "type": "object", "description": "ToggleDefaultStyle. Full shape: _shared-widget-fields.json#/styleBlocks/ToggleDefaultStyle." },
+                "selectedStyle": { "type": "object", "description": "ToggleSelectedStyle. Full shape: _shared-widget-fields.json#/styleBlocks/ToggleSelectedStyle." },
+                "receiveParameterSource": { "type": "object", "description": "Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." }
+              }
+            },
+            {
+              "title": "InputParameterParameters",
+              "type": "object",
+              "required": ["viewType"],
+              "description": "isLabelHidden is optional (not required) for input/inputcard.",
+              "properties": {
+                "viewType": { "const": "input" },
+                "isLabelHidden": { "type": "boolean", "description": "Optional for viewType input/inputcard." },
+                "parameterName": { "type": "string" },
+                "parameterOption": { "type": "object", "description": "Same shape as ListParameterParameters.parameterOption above." },
+                "valueSource": { "type": "object", "description": "Optional source feeding the input's current/default value." },
+                "widgetStyle": { "type": "object", "description": "WidgetStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetStyle." },
+                "titleStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "valueStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "receiveParameterSource": { "type": "object", "description": "Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." }
+              }
+            },
+            {
+              "title": "InputCardParameterParameters",
+              "type": "object",
+              "required": ["viewType"],
+              "description": "isLabelHidden is optional (not required) for input/inputcard.",
+              "properties": {
+                "viewType": { "const": "inputcard" },
+                "isLabelHidden": { "type": "boolean", "description": "Optional for viewType input/inputcard." },
+                "parameterName": { "type": "string" },
+                "parameterOption": { "type": "object", "description": "Same shape as ListParameterParameters.parameterOption above." },
+                "valueSource": { "type": "object", "description": "Optional source feeding the input's current/default value." },
+                "widgetStyle": { "type": "object", "description": "WidgetStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetStyle." },
+                "titleStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "valueStyle": { "type": "object", "description": "WidgetTextStyle. Full shape: _shared-widget-fields.json#/styleBlocks/WidgetTextStyle." },
+                "receiveParameterSource": { "type": "object", "description": "Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." }
+              }
+            }
+          ]
+        }
+      }
+    }
+  },
+  "example": {
+    "operation": "upsert_parameter_widget",
+    "widget": {
+      "type": "parameter",
+      "name": "parameter_1",
+      "label": "Target",
+      "parameters": {
+        "viewType": "input",
+        "parameterOption": { "dataType": "number" },
+        "isLabelHidden": false
+      }
+    }
+  }
+}

package/skills/tableau-next-asset-create/references/schemas/edit-dashboard/upsert_text_widget.json

@@ -0,0 +1,103 @@
+{
+  "title": "upsert_text_widget",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["operation", "widget"],
+  "properties": {
+    "operation": { "const": "upsert_text_widget" },
+    "widget": {
+      "type": "object",
+      "description": "Complete text widget definition for create or full replacement. Omitted fields are dropped on replacement. No data source. Rich text lives in parameters.content as Quill-Delta ops. Upsert defines the widget only; it neither places it nor changes existing placements.",
+      "required": ["type", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Existing widget ID. Required when fully replacing a persisted widget; omit when creating a widget. Never invent this value. An unsaved draft widget has no ID and may be replaced by matching widget.name."
+        },
+        "type": { "const": "text" },
+        "name": {
+          "type": "string",
+          "description": "Stable widget key within the dashboard, e.g. \"text_1\". On persisted replacement, it must match the widget identified by id."
+        },
+        "label": { "type": "string", "description": "Display label." },
+        "description": { "type": "string", "description": "Optional widget description (distinct from label)." },
+        "actions": {
+          "type": "array",
+          "description": "Optional click/select interactions (navigate, run a flow, set a parameter, set a filter, record action). Full per-type shape: _shared-widget-fields.json.",
+          "items": { "type": "object", "required": ["actionType", "eventType"] }
+        },
+        "dynamicTokens": {
+          "type": "object",
+          "description": "Optional dynamic value bindings keyed by token name. Full shape: _shared-widget-fields.json.",
+          "additionalProperties": { "type": "object" }
+        },
+        "parameters": {
+          "type": "object",
+          "description": "Text widget parameters.",
+          "properties": {
+            "content": {
+              "type": "array",
+              "description": "Quill-Delta ops list. Each op is { insert, attributes? }. Plain text ends with a trailing \"\\n\".",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "insert": { "description": "Inserted text or embed token." },
+                  "attributes": {
+                    "type": "object",
+                    "description": "Inline formatting for the inserted text.",
+                    "properties": {
+                      "bold": { "type": "boolean" },
+                      "italic": { "type": "boolean" },
+                      "underline": { "type": "boolean" },
+                      "strike": { "type": "boolean" },
+                      "color": { "type": "string", "description": "Hex color, e.g. \"#FF0000\"." },
+                      "background": { "type": "string", "description": "Hex background color." },
+                      "align": { "type": "string", "description": "\"left\" | \"center\" | \"right\"." },
+                      "link": { "type": "string", "description": "URL." },
+                      "size": { "type": "string", "description": "e.g. \"18px\" or \"large\"." },
+                      "list": { "type": "string", "description": "\"bullet\" | \"ordered\"." }
+                    }
+                  },
+                  "rules": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "description": "Echoed back by the server on each op even if you didn't send one — harmless, don't be surprised reading it back."
+                  }
+                }
+              }
+            },
+            "verticalAlignment": {
+              "type": "string",
+              "enum": ["top", "center", "bottom"],
+              "description": "Vertical alignment of the content."
+            },
+            "lineSpacing": { "type": "number", "description": "Line spacing multiplier." },
+            "overflow": { "type": "string", "enum": ["scroll", "truncate"], "description": "How content overflowing the widget's bounds is handled." },
+            "wrap": { "type": "string", "enum": ["wrap", "nowrap"], "description": "Whether text wraps within the widget." },
+            "tooltip": { "type": "string", "description": "Tooltip text." },
+            "widgetStyle": { "type": "object", "description": "WidgetStyle (backgroundColor/borderEdges/borderColor/borderWidth/borderRadius). Full shape: _shared-widget-fields.json#/styleBlocks/WidgetStyle." },
+            "receiveFilterSource": { "type": "object", "description": "Which published filters this widget listens to. Full shape: _shared-widget-fields.json#/receiveSources/receiveFilterSource." },
+            "receiveParameterSource": { "type": "object", "description": "Which published parameters this widget listens to. Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." },
+            "conditionalFormattingRules": {
+              "type": "array",
+              "description": "Rules that restyle content based on a bucketed value. Full shape: _shared-widget-fields.json#/conditionalFormatting.",
+              "items": { "type": "object" }
+            }
+          }
+        }
+      }
+    }
+  },
+  "example": {
+    "operation": "upsert_text_widget",
+    "widget": {
+      "type": "text",
+      "name": "text_1",
+      "parameters": {
+        "content": [
+          { "insert": "Q4 Summary\n", "attributes": { "bold": true, "align": "center" } }
+        ]
+      }
+    }
+  }
+}

package/skills/tableau-next-asset-create/references/schemas/edit-dashboard/upsert_visualization_widget.json

@@ -0,0 +1,68 @@
+{
+  "title": "upsert_visualization_widget",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["operation", "widget"],
+  "properties": {
+    "operation": { "const": "upsert_visualization_widget" },
+    "widget": {
+      "type": "object",
+      "description": "Complete visualization widget definition for create or full replacement. Omitted fields are dropped on replacement. source references the saved visualization { id, name }. Upsert defines the widget only; it neither places it nor changes existing placements.",
+      "required": ["type", "name"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Existing widget ID. Required when fully replacing a persisted widget; omit when creating a widget. Never invent this value. An unsaved draft widget has no ID and may be replaced by matching widget.name."
+        },
+        "type": { "const": "visualization" },
+        "name": {
+          "type": "string",
+          "description": "Stable widget key, e.g. \"viz_1\". On persisted replacement, it must match the widget identified by id."
+        },
+        "label": { "type": "string", "description": "Display label." },
+        "description": { "type": "string", "description": "Optional widget description (distinct from label)." },
+        "actions": {
+          "type": "array",
+          "description": "Optional click/select interactions. Full per-type shape: _shared-widget-fields.json.",
+          "items": { "type": "object", "required": ["actionType", "eventType"] }
+        },
+        "dynamicTokens": {
+          "type": "object",
+          "description": "Optional dynamic value bindings keyed by token name. Full shape: _shared-widget-fields.json.",
+          "additionalProperties": { "type": "object" }
+        },
+        "source": {
+          "type": "object",
+          "description": "Saved visualization reference.",
+          "properties": {
+            "id": { "type": "string", "description": "Visualization record id." },
+            "name": { "type": "string", "description": "Visualization apiName." }
+          }
+        },
+        "parameters": {
+          "type": "object",
+          "description": "Visualization widget parameters.",
+          "properties": {
+            "legendPosition": {
+              "type": "string",
+              "enum": ["Top", "Bottom", "Left", "Right"],
+              "description": "Position of the visualization legend."
+            },
+            "shareState": { "type": "boolean", "description": "Whether the widget shares interaction state." },
+            "widgetStyle": { "type": "object", "description": "VisualizationStyle (WidgetStyle + textColor/lineColor/headerBackgroundColor/textSize). Full shape: _shared-widget-fields.json#/styleBlocks/VisualizationStyle." },
+            "receiveFilterSource": { "type": "object", "description": "Which published filters this widget listens to. Full shape: _shared-widget-fields.json#/receiveSources/receiveFilterSource." },
+            "receiveParameterSource": { "type": "object", "description": "Which published parameters this widget listens to. Full shape: _shared-widget-fields.json#/receiveSources/receiveParameterSource." }
+          }
+        }
+      }
+    }
+  },
+  "example": {
+    "operation": "upsert_visualization_widget",
+    "widget": {
+      "type": "visualization",
+      "name": "viz_1",
+      "source": { "id": "0Fx000000000123", "name": "SalesByRegion" }
+    }
+  }
+}