@cplace/mcp-server 1.3.14

package/dist/widget-specifications/cf.platform.comments/_overview.md

@@ -0,0 +1,52 @@
+## Purpose
+
+Enables comments to be added to a page.
+
+The Comments widget enables threaded discussions directly on any cplace page. It provides a native collaboration mechanism where users can have conversations, give feedback, and discuss page content without leaving the page context.
+
+## When to Use
+
+- **Collaboration needs**: When team members need to discuss or provide feedback on page content
+- **Review workflows**: For approval processes where reviewers need to leave feedback
+- **Knowledge sharing**: On wiki or documentation pages where questions and clarifications arise
+- **Task coordination**: On work items where team communication is needed
+
+## Design Considerations
+
+### Automatic Scoping
+
+The Comments widget automatically displays the comment thread for the page it's placed on. Unlike other widgets, it requires no data source configuration or search filters—it simply works with the embedding page's comment thread.
+
+### Layout Placement
+
+Comments typically serve a supporting role rather than being the primary content. Consider these placement strategies:
+
+**Below main content**: Place comments in a lower row when discussion is secondary to the main content. Users read the content first, then scroll to participate in discussion. Works well for documentation and wiki pages.
+
+**Side-by-side with content**: Place comments next to the main content when users need to reference what they're discussing. Useful for review pages, task details, or anywhere discussion directly relates to visible content.
+
+**Dedicated section**: Give comments full width when discussion is the primary purpose, such as in a "Discussion" alternative layout tab.
+
+### Pairing with Other Widgets
+
+Comments are frequently paired with the Files widget in a "utilities" row, providing both attachment management and discussion in a compact layout below main content.
+
+When placed beside a content widget, both should have consistent visual height to maintain layout balance.
+
+### Single Instance Principle
+
+Only one Comments widget is needed per layout—multiple instances would show the same thread. If different discussion contexts are needed, consider using alternative layouts with different comment scopes.
+
+## Trade-offs
+
+| Consideration | Implication |
+|---------------|-------------|
+| Notification behavior | Comment activity may trigger notifications based on workspace settings |
+| Permission dependency | Users need appropriate permissions to participate in discussions |
+| Space allocation | Narrow layouts limit readability of longer discussion threads |
+
+## Related Widgets
+
+- **Files**: Often paired in a utilities row for attachments + discussion
+- **Text/Rich String**: Content that users discuss
+- **Attributes Group**: Details that provide context for discussion

package/dist/widget-specifications/cf.platform.comments/_summary.md

@@ -0,0 +1 @@
+Enables comments to be added to a page. Use when team members need to discuss content, provide feedback, or coordinate on work items without leaving the page context.

package/dist/widget-specifications/cf.platform.connectedBarChart/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedBarChart",
+  "Description": "{\"en\":\"Visualizes an attribute of a table or a search configurable in the widget as a bar chart.\",\"de\":\"Visualisiert ein Attribut einer Tabelle oder einer im Widget konfigurierbaren Suche als Säulendiagramm.\"}",
+  "Localized Name": "{\"en\":\"Bar Chart\",\"de\":\"Säulendiagramm\"}",
+  "Icon": "fa-chart-bar",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Bar Chart' widget can be used to visualize an attribute of a table (i.e. a table column) or the result of a configurable search as a bar chart.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Table: The connected table to be used as the source of the bar chart.</p>\n\n<p>// * Search: If no connected table is specified the results of the search specified here will be used to generate the bar chart.</p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Height in pixels:</p>"
+}

package/dist/widget-specifications/cf.platform.connectedBarChart/_implementation.md

@@ -0,0 +1,10 @@
+**Data Source Modes** (one required):
+- **Connected Table** (`tableWidgetId`) **(recommended)**: Uses data from a connected table widget (e.g., Embedded Search as Table) on the same page. Takes precedence if both are set.
+- **Standalone Search** (`search`) **(fallback)**: Uses a configured search query as data source. Use only when no table holds the data to visualize.
+
+**Typical Configuration Workflow**:
+1. Choose data source mode:
+   - Set `tableWidgetId` to connect to an existing table widget, OR
+   - Configure `search` with a search query
+2. Select `attributeName` - the attribute to aggregate/group by (only available after data source is configured)
+3. Optionally set `title` and `height`

package/dist/widget-specifications/cf.platform.connectedBarChart/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "chart",
+    "attributes",
+    "searchable",
+    "filterable",
+    "connected",
+    "dashboard"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.platform.connectedBarChart/_overview.md

@@ -0,0 +1,72 @@
+## Overview
+
+Visualizes an attribute of a table or a search configurable in the widget as a bar chart.
+
+The Connected Bar Chart widget displays the frequency distribution of values for a selected attribute across a dataset. It aggregates data by counting occurrences of each distinct value and renders the results as vertical bars (columns) using Highcharts. The chart is interactive, supporting Y-axis zoom for detailed inspection of data.
+
+## Use Cases
+
+### Status Distribution Analysis
+Visualize how many items exist in each status state (e.g., "Open", "In Progress", "Done"). This is particularly useful for project management dashboards to identify bottlenecks where items accumulate in certain statuses.
+
+### Category Distribution
+Display the distribution of items across categories, types, or priority levels. Examples include showing products by category or issues by priority (Low, Medium, High, Critical).
+
+### Workload Analysis
+Visualize how many items are assigned to each person to identify unbalanced workloads. Useful for resource planning and capacity management.
+
+### Enumeration Value Distribution
+Any enumeration or reference attribute can be visualized to show value distribution across a dataset, helping identify the most and least common values.
+
+## Operating Modes
+
+### Connected Table Mode (Recommended)
+Links to an existing table widget on the same page. The chart inherits the table's search configuration and filters, automatically updating when the table data changes. This mode is ideal for interactive dashboards where users filter data in the table and see the chart update accordingly.
+
+### Standalone Search Mode (Fallback)
+Defines a search directly in the widget configuration, operating independently from other widgets. **Use only when no table on the page holds the data to visualize.** This mode is useful for fixed visualizations where the underlying data is not represented by any table widget.
+
+> **Best Practice**: Always prefer connecting to a table widget. The table provides synchronized filtering, dynamic updates, and a consistent user experience. Only use standalone search mode when the data to visualize is not represented by any table on the page.
+
+## Design Considerations
+
+### When to Use Bar Chart
+- Showing distribution across discrete categories
+- Comparing frequencies of different values
+- Working with attributes that have a reasonable number of distinct values (fewer than 50)
+- Needing vertical/column representation for clarity
+
+### When to Consider Alternatives
+- **Too many values**: When the attribute has many distinct values, the chart becomes cluttered and hard to read
+- **Proportional data**: When showing percentages or proportions is more important than absolute counts, consider a pie chart
+- **Multi-dimensional analysis**: When comparing two attributes simultaneously, consider the Connected Matrix widget
+- **Continuous data**: For time-series or continuous numerical data, line charts may be more appropriate
+
+### Chart Characteristics
+- Vertical column chart with distinct colors for each bar
+- Y-axis zoom enabled for detailed inspection
+- Data labels showing count values on each bar
+- Tooltips on hover for additional detail
+- No legend (each bar represents a unique category)
+
+## Common Pitfalls
+
+- **Selecting attributes with too many distinct values**: Results in an unreadable, cluttered chart. Pre-filter data or choose attributes with limited cardinality.
+- **Not specifying a data source**: The widget requires either a connected table widget or a standalone search configuration.
+- **Standalone search targeting multiple types**: When using standalone search mode, the search must return entities of a single type for attribute selection to work.
+
+## Alternatives to Consider
+
+| Widget | When to Use Instead |
+|--------|---------------------|
+| `cf.platform.connectedPieChart` | When showing proportions/percentages is more important than absolute counts |
+| `cf.platform.connectedMatrix` | When analyzing relationships between two attributes |
+| `cf.platform.connectedNumberOfResults` | When only the total count matters, not distribution |
+
+## Related Patterns
+
+### Dashboard Pattern
+Multiple chart widgets (bar, pie, matrix) connected to the same table widget. The table provides interactive filtering, and all connected charts update together to reflect the filtered data.
+
+### Fixed Report Pattern
+Standalone charts with predefined searches, creating consistent visualizations that are not affected by user interactions. Useful for standardized reports and executive dashboards.

package/dist/widget-specifications/cf.platform.connectedBarChart/_summary.md

@@ -0,0 +1 @@
+Visualizes an attribute of a table or a search configurable in the widget as a bar chart. Connects to a table widget for synchronized filtering or uses a standalone search for independent visualizations.

package/dist/widget-specifications/cf.platform.connectedBarChart/attributeName.md

@@ -0,0 +1,12 @@
+**Warning**: The attribute must exist on the type that is being visualized!
+
+**Important**:
+- **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
+- **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `name`
+
+**Validation**: Before setting this attribute, verify that the attribute actually exists on the type returned by the data source (connected table or standalone search). Using a non-existent attribute will result in an empty or broken chart.
+
+**Workflow**:
+1. Determine the type being visualized (from the connected table's search or from the standalone `search` configuration)
+2. Call the tool to investigate the data model for that type
+3. Find the attribute you want to aggregate/group by

package/dist/widget-specifications/cf.platform.connectedBarChart/search.md

@@ -0,0 +1,17 @@
+**Best Practice**: Only use this attribute when no table widget on the page holds the data to visualize. Prefer connecting to a table via `tableWidgetId` for synchronized filtering and dynamic updates.
+
+**Warning**: Search must have exactly ONE type filter AND ONE space filter to be valid!
+
+**Validation Requirements**:
+- The search configuration must define exactly one type
+- The search configuration must define exactly one space
+- If these requirements are not met, the widget displays an error
+
+**Correct Usage**: Use the `cplaceJson` field from a `cplace_search_pages` response.
+
+**Workflow**:
+1. Call `cplace_search_pages` with filters for the desired type and space
+2. Take the `cplaceJson` field from the response
+3. Use that value for the `search` attribute
+
+**Note**: This attribute is only used when `tableWidgetId` is not set. If both are configured, `tableWidgetId` takes precedence.

package/dist/widget-specifications/cf.platform.connectedMatrix/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedMatrix",
+  "Description": "{\"en\":\"Visualizes the content of a table broken down according to two search criteria.\",\"de\":\"Visualisiert den Inhalt einer Tabelle aufgeteilt nach zwei Suchkriterien.\"}",
+  "Localized Name": "{\"en\":\"Matrix\",\"de\":\"Matrix\"}",
+  "Icon": "fa-th",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Matrix' widget displays the filtered content of table columns in the form of a grid pattern with an x and y axis.</p>\n\n<p>The x and y axes are formed on the basis of two attributes of the types by which the linked search table is filtered.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Table*:</p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Height:</p>\n\n<p>// * Minimum width of matrix:</p>\n\n<p>// * Maximum row height:</p>\n\n<p>// * Label x-axis: Bilingual text.</p>\n\n<p>// * Attribute for x-axis*:</p>\n\n<p>// * Style x-axis*:</p>\n\n<p>// * Label y-axis: Bilingual text.</p>\n\n<p>// * Attribute for y-axis*:</p>\n\n<p>// * Style y-axis*:</p>\n\n<p>// * Attributes for icons</p>\n\n<p>// * Maximum number of results*:</p>\n\n<p>&nbsp;</p>\n\n<p><strong>Examples</strong></p>\n\n<div class=\"cplace-ckeditor-img-full-width\"><img alt=\"\" src=\"/file/9hzaox5ha1h4rz3hby692mqea/Product/cf.platform.connectedMatrix/2019-04-09-10-41-00-443.png\" width=\"1268\"></div>"
+}

package/dist/widget-specifications/cf.platform.connectedMatrix/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "matrix",
+    "searchable",
+    "connected",
+    "references",
+    "navigation",
+    "dashboard"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.platform.connectedMatrix/_overview.md

@@ -0,0 +1,189 @@
+## Overview
+
+Visualizes the content of a table broken down according to two search criteria.
+
+The Connected Matrix Widget organizes pages from a search result into a two-dimensional grid structure based on two configurable attributes. Each axis represents a categorical dimension (such as team members, time periods, risk levels, or features), and the intersection cells contain the pages matching those coordinate combinations.
+
+As part of the "connected widget" family, this widget integrates with a table widget to share search queries, filters, and permissions. This makes it particularly valuable for visualizing relationships and distribution patterns that would be difficult to spot in traditional list or table formats.
+
+## Primary Use Cases
+
+### Responsibility Assignment (RACI Matrix)
+- **X-axis**: Team members or organizational roles
+- **Y-axis**: Tasks, deliverables, or activities
+- **Purpose**: Show who is responsible, accountable, consulted, or informed for each task
+- **Value**: Quickly identify gaps in responsibility coverage or overallocation
+
+### Risk Assessment Matrix
+- **X-axis**: Risk likelihood (Low, Medium, High)
+- **Y-axis**: Risk impact (Low, Medium, High)
+- **Purpose**: Position risks by probability and severity
+- **Value**: Visual prioritization based on standard risk management framework
+
+### Resource Allocation Over Time
+- **X-axis**: Time periods (weeks, months, quarters)
+- **Y-axis**: Projects, teams, or resources
+- **Purpose**: Show which resources are allocated where and when
+- **Value**: Identify scheduling conflicts and resource constraints
+
+### Product Feature Comparison
+- **X-axis**: Products or product versions
+- **Y-axis**: Features or requirements
+- **Purpose**: Show feature availability across product lines
+- **Value**: Gap analysis and feature parity visualization
+
+### Stakeholder Mapping
+- **X-axis**: Interest level in the project
+- **Y-axis**: Influence or power level
+- **Purpose**: Map stakeholders by engagement characteristics
+- **Value**: Guide communication and engagement strategies
+
+### Cross-Functional Dependencies
+- **X-axis**: Departments or organizational units
+- **Y-axis**: Projects or initiatives
+- **Purpose**: Visualize organizational dependencies
+- **Value**: Identify collaboration needs and organizational silos
+
+## Design Considerations
+
+### When to Use This Widget
+
+Choose the Connected Matrix Widget when:
+- You need to visualize relationships between **two categorical dimensions** (not continuous data)
+- Distribution patterns or concentrations matter more than individual details
+- Users need to quickly identify gaps, conflicts, or categorization at a glance
+- The data naturally maps to a grid structure (like assignments, allocations, or assessments)
+- Both dimensions have a manageable number of distinct values (typically 3-20 per axis)
+
+### When to Consider Alternatives
+
+**Use a Table Widget instead** when:
+- You need detailed data with multiple columns
+- Sorting and filtering by many attributes is important
+- Users need to see all attribute values, not just two dimensions
+- The focus is on individual records rather than distribution patterns
+
+**Use a Chart Widget (Bar/Pie) instead** when:
+- You only have one dimension to visualize
+- You need to show proportional distribution rather than absolute positioning
+- Aggregate counts or percentages are more important than individual items
+
+**Use a Timeline/Gantt Widget instead** when:
+- Time is a continuous axis (not discrete periods)
+- Duration and scheduling are the primary concerns
+- Dependencies between tasks need to be visualized
+
+**Use a Tree Table Widget instead** when:
+- Hierarchical relationships are more important than dimensional categorization
+- Parent-child structures define the organization
+- Drill-down through levels is the primary navigation pattern
+
+### Attribute Selection Guidelines
+
+**Good candidates for axes**:
+- Enumeration attributes with 3-20 values (ideal range)
+- Reference attributes to organizational entities (people, teams, departments)
+- Date attributes that naturally group (quarters, months)
+- Categorical attributes that represent discrete states or categories
+
+**Poor candidates for axes**:
+- Free-text strings with many unique values
+- Continuous numeric ranges (use charts instead)
+- Attributes with too many values (matrix becomes unwieldy)
+- Optional attributes where most pages lack values
+
+### Visual Styles
+
+The widget supports different visual styles for axis headers:
+- **Plain**: Simple text labels (default, works for all attribute types)
+- **Label**: Styled label boxes (good for enumeration values)
+- **Arrow**: Labels with arrow indicators (useful for directional progression)
+- **Profile-line/Profile-column**: User profile images (for Person references)
+
+Choose the style that best matches your data type and visual design needs.
+
+### Performance Considerations
+
+- **Default limit**: 500 pages (configurable via `MAX_RESULTS`)
+- Matrices work best with **focused searches** that return relevant subsets
+- Very large matrices (many values on both axes) can impact browser performance
+- Consider using connected table filters to let users narrow down results dynamically
+
+### Cell Population Patterns
+
+**Enumeration attributes**:
+- All enumeration values appear as lanes (rows/columns)
+- Empty cells are visible but contain no links
+- Helps identify gaps (e.g., "no one is responsible for this task")
+
+**Other attribute types**:
+- Only values present in search results create lanes
+- Empty lanes are omitted entirely
+- Matrix size adapts to actual data
+
+## Connection Patterns
+
+### Required Connected Widget
+The matrix widget **requires** a table widget connection:
+- Shares the table's search query and filters
+- Inherits permission settings from the table
+- Updates when table filters change
+
+**Setup**: Configure `TABLE_WIDGET_ID` to point to the source table widget
+
+### Optional Connected Widgets
+Works well with:
+- **Connected Table Filter** widgets: Provide interactive filtering controls
+- **Connected Bar/Pie Chart** widgets: Offer alternative visualizations of the same data
+- **Connected Single Attribute** widgets: Show aggregate metrics alongside the matrix
+
+All connected widgets sharing the same table stay synchronized.
+
+## Common Pitfalls
+
+### Matrix Size Management
+**Problem**: Too many unique values create an unwieldy matrix
+**Solution**:
+- Refine the search query to focus on relevant subsets
+- Use enumeration attributes with controlled value sets
+- Add connected filter widgets to let users narrow results
+- Consider grouping continuous attributes (e.g., date ranges instead of individual dates)
+
+### Attribute Coverage
+**Problem**: Pages without X or Y attribute values are excluded from display
+**Solution**:
+- Ensure the search query targets types with both attributes defined
+- Make attributes required if all pages should appear
+- Use validation rules to ensure data quality
+
+### Multiple Pages Per Cell
+**Problem**: Cells with many pages become crowded and hard to read
+**Solution**:
+- Use icon attributes to provide visual differentiation
+- Refine search to reduce result count
+- Consider whether the axes are granular enough
+- Accept that this is a high-level overview (users click through for details)
+
+### Profile Image Display
+**Problem**: Profile images don't appear even with profile-line/profile-column style
+**Solution**:
+- Ensure the axis uses a Person reference attribute
+- Verify that Person pages have profile images uploaded
+- Check that thumbnail generation is configured correctly in cplace
+
+## Related Patterns
+
+### Connected Widget Family
+All widgets sharing the `cf.platform.connected*` naming pattern integrate with table widgets:
+- `cf.platform.connectedBarChart` - Bar chart visualization
+- `cf.platform.connectedPieChart` - Proportional distribution
+- `cf.platform.connectedTableFilter` - Interactive filtering controls
+- `cf.platform.connectedSingleAttribute` - Single value display
+- `cf.platform.connectedAttributesGroup` - Multi-attribute grouping
+
+### Alternative Visualizations
+Depending on your data and goals, consider:
+- `cf.cplace.platform.tableWidget` - Detailed tabular view
+- `cf.cplace.extendedTreeTableWidget` - Hierarchical data
+- Timeline widgets - Time-phased planning
+- Chart widgets - Aggregated metrics

package/dist/widget-specifications/cf.platform.connectedMatrix/_summary.md

@@ -0,0 +1 @@
+Visualizes the content of a table broken down according to two search criteria. Positions pages based on two configurable attributes (X and Y axes) to show distribution patterns and relationships. Ideal for RACI matrices, risk assessments, resource allocations, and other scenarios requiring categorical two-dimensional analysis.

package/dist/widget-specifications/cf.platform.connectedPieChart/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedPieChart",
+  "Description": "{\"en\":\"Visualizes an attribute of a table or a search configurable in the widget as a pie chart.\",\"de\":\"Visualisiert ein Attribut einer Tabelle oder einer im Widget konfigurierbaren Suche als Kuchendiagramm.\"}",
+  "Localized Name": "{\"en\":\"Pie Chart\",\"de\":\"Kuchendiagramm\"}",
+  "Icon": "fa-chart-pie",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Pie Chart' widget can be used to visualize an attribute of a table (i.e. a table column) or the result of a configurable search as a pie chart.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Table:</p>\n\n<p>// * Search: If no connected table is specified, the search specified here will be used to generate the pie chart.</p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Height in pixels:</p>\n\n<p>&nbsp;</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.platform.connectedPieChart/_implementation.md

@@ -0,0 +1,10 @@
+**Data Source Modes**:
+- `tableWidgetId` **(recommended)**: Links to an existing table widget on the same page (shares its search/filters)
+- `search` **(fallback)**: Standalone search definition — use only when no table holds the data to visualize
+
+**Important**: At least one data source must be specified. If both are set, `tableWidgetId` takes priority.
+
+**Typical Configuration Workflow**:
+1. Choose data source: connect to table widget OR define standalone search
+2. Set `attributeName` to choose which attribute to aggregate (options depend on data source)
+3. Optionally set title and height

package/dist/widget-specifications/cf.platform.connectedPieChart/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "chart",
+    "attributes",
+    "searchable",
+    "connected",
+    "dashboard",
+    "read-only"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.platform.connectedPieChart/_overview.md

@@ -0,0 +1,72 @@
+## Overview
+
+Visualizes an attribute of a table or a search configurable in the widget as a pie chart.
+
+The Connected Pie Chart widget visualizes the distribution of values in a selected attribute as an interactive pie chart. It aggregates data by counting the frequency of each distinct value and displays the results as proportional slices with percentages and a legend.
+
+The widget can operate in two modes: connected to a table widget for dynamic updates based on table filters, or with a direct search query for independent data visualization.
+
+## Use Cases
+
+### Status Distribution Analysis
+Display the distribution of items across different status values to get a quick overview of work progress. For example, a project manager can see how many tasks are in each status category (Open, In Progress, Completed) to understand project health at a glance.
+
+### Category Breakdown
+Visualize how items are distributed across categorical attributes like priority, type, or department. This helps identify where resources should be focused, such as showing the distribution of support tickets by priority level.
+
+### Demographic Analysis
+Display demographic breakdowns such as team distribution, location distribution, or role distribution within an organization.
+
+### Connected Filtering Scenario
+When connected to a table widget, the pie chart updates dynamically based on table filters, providing real-time distribution visualization of filtered data. As users filter the table, the chart automatically reflects the filtered subset.
+
+## Design Considerations
+
+### Data Source Selection
+
+The widget requires exactly one data source:
+
+**Connected Table Mode (Recommended)**
+- Links to an existing table widget on the same page
+- Automatically responds to table filters and updates dynamically
+- Enables interactive exploration of data alongside the table
+
+**Direct Search Mode (Fallback)**
+- Defines a search query directly in the widget
+- Operates independently without dependency on other widgets
+- **Use only when no table on the page holds the data to visualize**
+
+> **Best Practice**: Always prefer connecting to a table widget. The table provides synchronized filtering, dynamic updates, and a consistent user experience. Only use direct search mode when the data to visualize is not represented by any table on the page.
+
+### Attribute Requirements
+
+The selected attribute must be an enumeration or reference attribute that can be aggregated. The widget counts occurrences of each distinct value and displays them as proportional slices.
+
+### Visualization Behavior
+
+- Displays percentages in tooltips
+- Shows a legend with value names on the right side
+- Slices can be selected/highlighted interactively
+- Values are sorted alphabetically by display name
+
+## Alternatives
+
+### Connected Bar Chart
+The `cf.platform.connectedBarChart` widget provides nearly identical functionality but displays data as vertical bars instead of pie slices.
+
+**When to use Pie Chart:**
+- You want to emphasize the proportion of parts to a whole (e.g., "50% of tasks are complete")
+- You have a small number of categories (ideally 5-7 or fewer)
+
+**When to use Bar Chart:**
+- You have many categories
+- You want to compare absolute values more precisely
+- Categories have similar proportions that would be hard to distinguish as slices
+
+## Related Patterns
+
+- **cf.platform.connectedBarChart** - Same data visualization concept with bar chart display
+- **cf.platform.connectedMatrix** - Two-dimensional visualization of relationships
+- **cf.platform.connectedTableFilter** - Provides filtering controls that can drive connected charts
+- **cf.platform.connectedSingleAttribute** - Displays a single attribute value from a selected table row
+- **cf.platform.connectedAttributesGroup** - Displays multiple attributes from a selected table row

package/dist/widget-specifications/cf.platform.connectedPieChart/_summary.md

@@ -0,0 +1 @@
+Visualizes an attribute of a table or a search configurable in the widget as a pie chart. Shows proportions of each distinct value with support for data from a connected table widget or a direct search query.

package/dist/widget-specifications/cf.platform.connectedPieChart/attributeName.md

@@ -0,0 +1,12 @@
+**Warning**: The attribute must exist on the type that is being visualized!
+
+**Important**:
+- **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
+- **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`) are specified without quotes: `name`
+
+**Validation**: Before setting this attribute, verify that the attribute actually exists on the type returned by the data source (connected table or standalone search). Using a non-existent attribute will result in an empty or broken chart.
+
+**Workflow**:
+1. Determine the type being visualized (from the connected table's search or from the standalone `search` configuration)
+2. Call the tool to investigate the data model for that type
+3. Find the attribute you want to aggregate/group by

package/dist/widget-specifications/cf.platform.connectedPieChart/search.md

@@ -0,0 +1,12 @@
+**Best Practice**: Only use this attribute when no table widget on the page holds the data to visualize. Prefer connecting to a table via `tableWidgetId` for synchronized filtering and dynamic updates.
+
+**Warning**: Do not manually construct search JSON!
+
+**Correct Usage**: Use the `cplaceJson` field from `cplace_search_pages` response.
+
+**Workflow**:
+1. Call `cplace_search_pages` with your desired filter criteria
+2. Take the `cplaceJson` field from the response
+3. Use that value for the `search` attribute
+
+**Note**: Only used when `tableWidgetId` is not specified. The search must target a single type for the widget to be valid.

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.connectedSingleAttribute",
+  "Description": "{\"en\":\"Displays a single attribute of a selected table entry dynamically. Prerequisite: There must be a table widget on the page.\",\"de\":\"Zeigt dynamisch ein einzelnes Attribut eines selektierten Tabelleneintrags an. Voraussetzung: Auf der Seite muss ein Tabellen-Widget existieren.\"}",
+  "Localized Name": "{\"en\":\"Single Attribute of a Table\",\"de\":\"Einzelnes Attribut aus Tabelle\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Single Attribute of a Table' widget dynamically displays a single attribute of a selected table entry.</p>\n\n<p>// This widget is a nested widget.</p>\n\n<p><strong>Prerequisite</strong><br>\nThere must be a table widget on the same page.</p>\n\n<p>&nbsp;</p>"
+}

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_implementation.md

@@ -0,0 +1,15 @@
+**Configuration Modes**:
+- **Value only** (`withValue=true`, `withLabel=false`): Shows attribute value inline
+- **Label only** (`withValue=false`, `withLabel=true`): Shows only the attribute name
+- **Value + Label** (`withValue=true`, `withLabel=true`): Shows both label and value (supports two layouts via `singleColumn`)
+
+**Typical Configuration Workflow**:
+1. Set `singleSelectionWidgetId` to the table/selection widget that provides entity selection
+   - Use `"<empty>"` when embedded inside a `cf.platform.connectedAttributesGroup` widget
+2. Set `attributeName`
+3. Configure display options:
+   - `withValue` and `withLabel` (at least one must be true)
+   - `singleColumn` for layout (only relevant when both value and label are shown)
+   - `inPlaceEditing` to allow inline editing
+4. Optional: Set `showAttributeScript` for conditional visibility
+5. Optional: Set `reloadAfterChange` to refresh connected widgets after edits

package/dist/widget-specifications/cf.platform.connectedSingleAttribute/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "attributes",
+    "form",
+    "detail-view",
+    "connected",
+    "inline-edit"
+  ],
+  "requiredApp": null
+}