@cplace/test-mcp-server 0.1.15 → 1.1.0

package/dist/widget-specifications/cf.cplace.pdfPreview.widget/_overview.md

@@ -0,0 +1,79 @@
+## Overview
+
+The PDF Preview widget enables you to embed a PDF and shows the first page of the document directly within a cplace page. It provides an inline preview of PDF files that are referenced via Document reference attributes, allowing users to view PDF content without opening or downloading the file. The widget uses PDF.js library to render PDFs in an HTML5 canvas with automatic scaling and optional download functionality.
+
+## Use Cases
+
+### When to Use This Widget
+
+- **Document Preview on Pages**: Display PDF attachments or referenced documents directly on entity pages without requiring users to download or open them separately
+- **Quick Visual Reference**: Provide a quick visual preview of PDF documents (e.g., contracts, reports, diagrams) on dashboards or detail pages
+- **Document Galleries**: Show preview thumbnails of multiple PDF documents in a collection
+- **Form Attachments**: Display PDF forms or documentation alongside data entry forms
+- **Report Previews**: Show generated PDF reports inline on summary pages
+
+Use this widget when:
+- You want to provide immediate visual context of a PDF document
+- The first page of a PDF contains the most relevant information (e.g., cover pages, summary sheets)
+- You want to reduce friction by avoiding the need to download files just to see their content
+- You're building document management interfaces where quick previews enhance usability
+
+### When NOT to Use This Widget
+
+- **Multi-page PDFs**: When users need to view or interact with multiple pages of a PDF (only the first page is displayed)
+- **Non-PDF Documents**: When the referenced attribute points to non-PDF documents (the widget only works with PDF files)
+- **Non-Document References**: When the referenced document is not a Document entity type
+- **Interactive PDFs**: When users need to interact with PDF form fields or annotations
+
+## Design Considerations
+
+### Key Features
+
+- **Inline PDF Rendering**: Displays the first page of a PDF file directly in the widget using HTML5 canvas
+- **Dynamic Scaling**: Automatically scales the PDF to fit the widget width or height (depending on configuration)
+- **Access Control**: Respects cplace's permission system and displays appropriate messages for insufficient rights
+- **Optional Download Button**: Configurable download button for accessing the full PDF
+- **Widget Reload**: Supports dynamic reload to refresh the PDF preview
+- **Error Handling**: Provides user-friendly error messages for various failure scenarios
+
+### Rendering Behavior
+
+The widget offers two scaling modes:
+- **Width-based scaling** (default): When no fixed height is set, the PDF scales to fit the widget width and the widget height adjusts based on the PDF's aspect ratio
+- **Height-based scaling**: When a fixed height is configured, the PDF scales to fit the specified height
+
+### Prerequisites and Dependencies
+
+**System Requirements**:
+- PDF.js library must be available in the frontend
+- Document entity type must be available (platform feature)
+- Modern browser with HTML5 canvas support
+
+**Configuration Prerequisites**:
+- Entity type must have at least one reference attribute pointing to Document entities
+- The attribute must have multiplicity of 1..1 or 0..1
+- Users must have read access to referenced documents
+
+### Limitations
+
+1. **Single Page Only**: Only displays the first page of the PDF
+2. **PDF Files Only**: Does not work with other document types (Word, Excel, images, etc.)
+3. **No Interactivity**: Cannot interact with PDF form fields or annotations
+4. **No Navigation**: Cannot scroll or navigate to other pages
+5. **Canvas Rendering**: Some PDF features may not render perfectly (complex fonts, advanced graphics)
+
+## Related Widgets
+
+### Alternative Widgets
+
+- **Files Widget** (`cf.platform.files`): Shows all attached files, but doesn't provide inline preview
+- **Dynamic Iframe Widget** (`cf.cplace.platform.dynamicIframe`): Can embed external content, but doesn't handle PDF rendering directly
+- **Image Gallery Widget** (`msg.scripts.imagegallery.basic`): Shows image previews but focused on images rather than PDFs
+
+### Integration Context
+
+- Works with any custom entity type that has Document reference attributes
+- Integrates with cplace's permission system for access control
+- Compatible with cplace's widget framework (reload actions, fixed heights, frames)
+- Can be used on any page layout that supports widgets
+- Complements document management capabilities in cplace

package/dist/widget-specifications/cf.cplace.pdfPreview.widget/_summary.md

@@ -0,0 +1 @@
+Enables you to embed a PDF and shows the first page of the document directly within a cplace page as an inline preview. Use when you want to provide immediate visual context of PDF documents without requiring users to download or open them separately.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.attributesGroup",
+  "Description": "{\"en\":\"Allows the flexible arrangement of attributes on a page.\",\"de\":\"Erlaubt die flexible Anordnung von Attributen einer Seite.\"}",
+  "Localized Name": "{\"en\":\"Grouped Attributes of a Page\",\"de\":\"Gruppierte Attribute einer Seite\"}",
+  "Icon": "cf-pencil-group",
+  "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 'Grouped Attributes of a Page' widget is a configurable display component for attributes. It allows a flexible placement of attributes on the page.</p>\n\n<p>The attributes to be displayed are specified in the 'Edit Layout' view by inserting a 'Single Attribute for a Page' widget (ToDo: add link) for each attribute.</p>\n\n<p>The source of the attributes can either be the embedding page itself, a different page that can be explicitly selected, or a relative page that can be specified via the relations attribute of the embedding page.</p>\n\n<p>The attributes can either be displayed for reading or for editing.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Show widget frame*: True/False. Specifies if the widget should be displayed within a visible frame or not.</p>\n\n<p>// * Show attribute in single column*: True/False. Determines if an attribute and its value(s) should be displayed as individual lines within the same column (true) or next to each other in a single line with different columns (false).</p>\n\n<p>// * Data source (Embedding page, Explicit selection, From attribute):</p>\n\n<p>// * Enable multi-edit*: True/False.</p>\n\n<p>// * Layout*: Opens the 'Edit Layout' page on which you can add a 'Heading' widget or a 'Single Attribute on a Page' widget.</p>\n\n<p>// * Height: Value in pixels. Heigth of the widget in pixels. If the specified height is not sufficient for all data to be shown, a scrollbar will be displayed.</p>\n\n<p><strong>Key Benefits</strong></p>\n\n<p><strong>Examples</strong></p>"
+}

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_implementation.md

@@ -0,0 +1,13 @@
+**Configuration Modes** (via `pageSelection`):
+- `embedding`: Display attributes of the current page (the page containing this widget) - most common
+- `absolute`: Display attributes of a specific, statically-configured page (requires `absoluteSelection`)
+- `relative`: Display attributes of a dynamically-referenced page via an attribute (requires `relativeSelection`)
+
+**Typical Configuration Workflow**:
+1. Choose data source mode via `pageSelection` (usually `"embedding"` for current page)
+2. Configure the corresponding selection attribute:
+   - For `absolute`: Set `absoluteSelection` to the target page UID
+   - For `relative`: Set `relativeSelection` to a reference attribute name
+   - For `embedding`: No additional configuration needed
+3. Configure the `layout` using dedicated MCP Tools for Managing Embedded Layouts
+4. Optionally customize appearance (`showFrame`, `singleColumn`) and behavior (`enableMultiEdit`)

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_meta.json

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

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_overview.md

@@ -0,0 +1,108 @@
+## Overview
+
+The Grouped Attributes widget allows the flexible arrangement of attributes on a page. Unlike a standard attribute list that shows all attributes in a fixed format, this widget gives full control over which attributes appear and how they're arranged in a custom grid layout.
+
+## When to Use
+
+**Choose this widget when:**
+- You need to highlight specific attributes rather than showing everything
+- Attributes should be grouped logically (e.g., dates together, people together)
+- The layout requires multiple columns with varying widths
+- Individual attributes need different display settings (labels, editing behavior)
+
+**Choose alternatives when:**
+- You want a quick view of all attributes without customization - use standard Attributes widget
+- Attributes should come from a connected/selected page rather than the current page - use **Connected Attributes**
+
+## Conceptual Architecture
+
+The widget acts as a container holding an embedded layout grid. Each cell in the grid contains a single attribute display:
+
+```
++- Grouped Attributes Container --------------------------+
+|                                                         |
+|  +----------+----------+----------+----------+          |
+|  | Start    | End      | Duration | Owner    |  Row 1   |
+|  +----------+----------+----------+----------+          |
+|  | Parent Project      | Schedule            |  Row 2   |
+|  +---------------------+---------------------+          |
+|  | Status              | Rating              |  Row 3   |
+|  +---------------------+---------------------+          |
+|                                                         |
++---------------------------------------------------------+
+```
+
+This nested structure means:
+- The outer widget defines the container (title, frame, height)
+- The inner grid defines rows and column proportions
+- Each cell contains an individual attribute with its own display settings
+
+## Layout Patterns
+
+### Logical Row Grouping
+
+Arrange related attributes in the same row for visual coherence:
+
+| Row Theme | Typical Attributes |
+|-----------|-------------------|
+| Temporal | Start date, end date, duration |
+| People | Owner, responsible, assignee |
+| Status | State, rating, escalation level |
+| Hierarchy | Parent, schedule, project |
+
+### Column Proportions
+
+The grid uses a 12-unit system. Common arrangements:
+
+| Layout | Suited For |
+|--------|-----------|
+| Four equal columns | Short values like dates |
+| Three equal columns | Medium-length values |
+| Two equal columns | References, longer text |
+| Full width | Descriptions, rich text |
+
+### Progressive Disclosure
+
+Place the Grouped Attributes widget at the top of a page with key summary information. Use Layout Tabs below for secondary details, keeping the primary view focused.
+
+## Design Considerations
+
+### Custom Labels
+
+Individual attributes can have alternative labels. This is useful for:
+- Adding units (e.g., "Duration (days)" instead of "Duration")
+- Shortening labels in tight layouts
+- Providing domain-specific terminology
+
+### Inline Editing
+
+Each attribute can be configured for inline editing, allowing users to modify values directly without opening a dialog. Consider enabling this for frequently-updated fields while keeping computed or sensitive fields read-only.
+
+### Frame and Title
+
+The container can display with or without a visual frame. Use a frame when:
+- The widget sits alongside other widgets and needs visual separation
+- A title helps users understand the grouped content
+- The panel represents a distinct logical section
+
+Skip the frame for seamless integration into the page flow.
+
+## Comparison with Related Widgets
+
+| Aspect | Grouped Attributes | Standard Attributes | Connected Attributes |
+|--------|-------------------|--------------------|-----------------------|
+| Attribute source | Current page | Current page | Selected page from table |
+| Attribute selection | Explicit choice | All or filtered | Explicit choice |
+| Layout control | Full grid customization | Fixed format | Full grid customization |
+| Complexity | Higher | Lower | Higher |
+| Primary use | Custom detail panels | Quick overview | Master-detail patterns |
+
+## Common Use Cases
+
+1. **Detail Page Header**: Show the most important attributes prominently at the top of a page, with logical grouping and custom layout
+
+2. **Settings Panel**: Collect configuration attributes in a dedicated section with appropriate frame and title
+
+3. **Status Overview**: Group status-related attributes (state, rating, escalation) for quick assessment
+
+4. **Scheduling Summary**: Combine temporal attributes (dates, duration, milestones) in a focused view

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/_summary.md

@@ -0,0 +1 @@
+Allows the flexible arrangement of attributes on a page in a custom grid layout. Use when you need to highlight specific attributes with logical grouping and controlled column arrangements rather than showing all attributes.

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/absoluteSelection.md

@@ -0,0 +1,9 @@
+**Note**: Conditionally required based on `pageSelection` mode.
+
+**When Required**:
+- Only when `pageSelection` is set to `"absolute"` (Explicit Selection mode)
+- Inactive/ignored for other pageSelection modes
+
+**Purpose**: Specifies the exact page whose attributes should be displayed in the widget.
+
+**Usage**: Set to the UID of the target page you want to display attributes from.

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/layout.md

@@ -0,0 +1,8 @@
+**Warning**: Do not manually construct layout JSON - use the embedded layout MCP tools!
+
+**Purpose**: Defines the grid layout structure and embedded widget configurations. This is the core of the attributesGroup widget, containing the actual attribute widgets arranged in rows and columns.
+
+**MCP Tools for Managing Embedded Layouts**:
+- `cplace_get_embedded_layout`: Retrieve current embedded layout structure
+- `cplace_add_widget_to_embedded_layout`: Add widgets to the layout
+- `cplace_remove_widget_from_embedded_layout`: Remove widgets from the layout

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/pageSelection.md

@@ -0,0 +1,12 @@
+**Warning**: This is a mode selector, not a data reference!
+
+**Valid Values**:
+- `embedding`: Display attributes of the current page (the page containing this widget)
+- `absolute`: Display attributes of a specific page selected explicitly (requires `absoluteSelection`)
+- `relative`: Display attributes of a page referenced via an attribute on the current page (requires `relativeSelection`)
+
+**Note**:
+- Choosing `absolute` activates the `absoluteSelection` attribute
+- Choosing `relative` activates the `relativeSelection` attribute
+- Choosing `embedding` requires no additional configuration
+- This controls which selection attribute becomes active/required

package/dist/widget-specifications/cf.cplace.platform.attributesGroup/relativeSelection.md

@@ -0,0 +1,14 @@
+**Note**: Conditionally required based on `pageSelection` mode.
+
+**When Required**:
+- Only when `pageSelection` is set to `"relative"` (From Attribute mode)
+- Inactive/ignored for other pageSelection modes
+
+**Purpose**: Specifies a reference attribute on the embedding page that points to the target page.
+
+**Valid Values**:
+- Attribute name of any single-page reference attribute on the embedding page's type
+- The dynamic enumeration provider lists available reference attributes at runtime
+- Common examples: parent references, related entity references, owner references
+
+**Usage**: Enter the attribute name (e.g., `"cf.cplace.myPlugin.relatedPage"`) of the reference attribute to follow.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.batchJobQuickGlance",
+  "Description": "{\"en\":\"Provides a brief overview of a selected job. The job can be started or configured.\",\"de\":\"Gibt einen kurzen Überblick über einen ausgewählten Job. Der Job kann gestartet oder konfiguriert werden.\"}",
+  "Localized Name": "{\"en\":\"Batch Job Quick Access\",\"de\":\"Batch-Job Schnellzugriff\"}",
+  "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 'Batch-Job Quick Access' widget provides you with a quick overview of the properties of a selected batch job. The batch job can also be started and configured from within this widget.</p>\n\n<p><strong>Settings</strong></p>"
+}

package/dist/widget-specifications/cf.cplace.platform.batchJobQuickGlance/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "metadata",
+    "read-only",
+    "dashboard",
+    "detail-view"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.cplace.platform.batchJobQuickGlance/_overview.md

@@ -0,0 +1,52 @@
+## Overview
+
+The Batch Job Quick Access widget provides a brief overview of a selected job. The job can be started or configured directly from within the widget. It displays the status of the most recent execution of a selected batch job and offers action buttons to start, configure, suspend, or resume the job.
+
+This widget serves as a quick-access interface for jobs that run asynchronously in the background, without requiring users to navigate to dedicated job management pages.
+
+## Use Cases
+
+### Administrative Dashboards
+Display status of critical system jobs (data synchronization, cleanup tasks, exports) on admin overview pages. Multiple widget instances can be placed on a single page to monitor several jobs at once.
+
+### Department/Team Pages
+Allow department managers to monitor and trigger department-specific jobs (e.g., employee data exports) directly from their department page.
+
+### Configuration Pages
+Embed on pages related to job configuration to provide immediate execution capability and status feedback after making configuration changes.
+
+### Operational Monitoring
+Create dedicated monitoring pages that aggregate multiple batch jobs using multiple widget instances, providing a single view of all background processing activities.
+
+## Design Considerations
+
+### Extension-Based Architecture
+The widget requires a corresponding `BatchJobQuickGlanceExtension` implementation in a plugin. This means:
+- Widget can only be embedded where at least one extension is selectable
+- Extensions control where they can be used via `isSelectableIn()` method
+- Extensions define which buttons are shown (configuration, download, suspend/resume)
+
+### Real-Time Updates
+The widget automatically polls for updates every 5 seconds when a job is running:
+- Stops polling when job completes
+- Restarts on new job creation
+- Provides loading indicators during operations
+
+### Single Job Focus
+Each widget instance monitors only one batch job and shows only the most recent execution. For job history, users need to navigate to the detailed job view.
+
+### Security Model
+Access control is delegated to extension implementations. Default behavior allows anyone who can view the page to start the job, but extensions can implement custom permission checks.
+
+## When NOT to Use
+
+- For real-time operations that don't use the batch job infrastructure
+- When jobs don't create persistent job records in the system
+- For simple actions that complete immediately (use regular action handlers instead)
+- When you need to show job execution history (use Embedded Search widgets configured to show PersistentJob entities)
+
+## Related Widgets
+
+- **Attributes Widget**: Often used alongside to show job configuration settings on the same page
+- **Comments Widget**: Useful for team communication about job issues or results
+- **Embedded Search Widgets**: Can display a list of all historical job executions if configured to search PersistentJob entities

package/dist/widget-specifications/cf.cplace.platform.batchJobQuickGlance/_summary.md

@@ -0,0 +1 @@
+Provides a brief overview of a selected job. The job can be started or configured directly from the widget. Use for monitoring job execution and enabling users to start, configure, or suspend/resume jobs.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.connectedAttributesGroup",
+  "Description": "{\"en\":\"Allows you to position the attributes from a table flexibly.\",\"de\":\"Erlaubt die flexible Anordnung von Attributen aus einer Tabelle.\"}",
+  "Localized Name": "{\"en\":\"Grouped Attributes of a Table\",\"de\":\"Gruppierte Attribute einer Tabelle\"}",
+  "Icon": "cf-pencil-group",
+  "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 'Grouped Attributes of a Table' widget allows the flexible arrangement of attributes from a table. This coupled widget displays the attributes of the currently selected entry from a linked table.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title: Bilingual Text.</p>\n\n<p>// * Show Widget Frame*: True/false.<br>\n// * Show attribute in single column*: True/false.<br>\n// * Data source*:</p>\n\n<p>// * Enable multi-edit: True/false.</p>\n\n<p>// * Layout*: Opens 'Edit Layout' dialog in which headings and attributes can be combined to form a layout.<br>\n// * Height: Value in pixels. Heigth of the widget in pixels. If the specified height is not sufficient for all data to be shown, a scrollbar will be displayed.</p>\n\n<p>&nbsp;</p>\n\n<p><strong>Key Benefits</strong></p>\n\n<p>&nbsp;</p>\n\n<p><strong>Examples</strong></p>"
+}

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_implementation.md

@@ -0,0 +1,17 @@
+**Purpose**: Displays attributes of the entity selected in a connected table widget, with flexible grid-based layout.
+
+This is a **container widget** that holds an embedded layout grid. It contains nested `cf.platform.connectedSingleAttribute` widgets arranged in customizable rows and columns.
+
+**Typical Workflow**:
+1. First, configure `singleSelectionWidgetId` to connect to a table widget on the same page
+2. Configure the `layout` using dedicated MCP Tools for Managing Embedded Layouts
+3. Optionally set title, height, and frame visibility
+
+**Key Attributes**:
+- `singleSelectionWidgetId`: **Required first step** - ID of the table widget that provides entity selection events
+- `cf.cplace.platform.attributesGroup.layout`: Grid-based layout defining how embedded attribute widgets are arranged
+
+**Widget Behavior**:
+- Widget subscribes to selection events from the connected table widget
+- When user selects a row in the table, this widget refreshes to show attributes of that entity
+- Currently only table widgets (`cf.cplace.platform.table`) can be used as selection sources

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_meta.json

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

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_overview.md

@@ -0,0 +1,103 @@
+## Overview
+
+The Grouped Attributes of a Table widget allows you to position the attributes from a table flexibly. It displays and edits attributes from a page selected in a connected table widget, implementing the master-detail pattern where selecting a row in a table automatically displays that row's attributes in a detail panel.
+
+## Core Concept: Master-Detail Pattern
+
+```
++-------------------------------------------------------------------------------+
+|                              Master-Detail Pattern                             |
++---------------------------------+---------------------------------------------+
+|   Master Table                  |   Connected Attributes Group                |
+|                                 |                                             |
+|   [Row 1: Item A]               |                                             |
+|   [Row 2: Item B] <-- selected  |   +-------------------------------------+   |
+|   [Row 3: Item C]               |   | Displays attributes of Item B      |   |
+|                                 |   | (the selected row)                  |   |
+|                                 |   +-------------------------------------+   |
++---------------------------------+---------------------------------------------+
+```
+
+### How It Works
+
+1. User selects a row in the master table
+2. The connected attributes group receives the selection event
+3. Widget displays attributes from the selected page
+4. When selection changes, the widget automatically updates
+
+### Embedded Layout Structure
+
+This widget contains an **embedded layout** - a nested grid of attribute widgets. Each attribute is displayed using a `cf.platform.connectedSingleAttribute` widget, which can be arranged in rows and columns within the panel.
+
+## Display Modes
+
+### Single Attribute Detail
+
+Display one attribute (like a description or notes field) from the selected row. Best for rich content that benefits from more space.
+
+### Multi-Attribute Grid
+
+Display several attributes in a grid layout for a compact overview of the selected item.
+
+### Vertical Stack
+
+All attributes in a single column for a detailed, form-like view.
+
+## Layout Patterns
+
+### Side-by-Side (Most Common)
+
+Table on the left, detail panel on the right. Users can browse the list while seeing details of their selection.
+
+### Stacked
+
+Table spans full width with the detail panel below. Good when both table columns and detail content need horizontal space.
+
+### Dashboard with Multiple Connected Widgets
+
+A single master table can drive multiple detail widgets - attribute panels, charts, and secondary tables all update based on the selection.
+
+## Design Considerations
+
+### Visual Alignment
+
+Match the height of the detail panel to the master table for visual balance. When they're side-by-side, equal heights create a cohesive layout.
+
+### Label Strategy
+
+- **Single attribute with a titled frame**: Hide individual attribute labels to avoid redundancy
+- **Multiple attributes in one panel**: Show labels to distinguish each field
+
+### In-Place Editing
+
+Individual attributes can enable in-place editing, allowing users to modify values directly in the detail panel without opening a dialog.
+
+### Empty State
+
+The widget shows nothing until the user selects a row. Consider this in your layout - the panel will appear empty on initial page load.
+
+## When to Use This vs. Alternatives
+
+| Scenario | Recommended Widget |
+|----------|-------------------|
+| Custom detail layout with specific attributes | **Connected Attributes** |
+| Quick detail panel showing all attributes | **Table Detail View** |
+| Attributes of the page being viewed | **Grouped Attributes** |
+| Need inline editing of selected item | **Connected Attributes** |
+| Simple preview without customization | **Table Detail View** |
+
+## Comparison: Connected Attributes vs Grouped Attributes
+
+| Aspect | Connected Attributes | Grouped Attributes |
+|--------|----------------------|--------------------|
+| Data source | Selected row in a table | The current page |
+| Requires table connection | Yes | No |
+| Updates dynamically | Yes, on selection change | No |
+| Use case | Master-detail patterns | Page detail layouts |
+
+## Related Widgets
+
+- **Embedded Search Table**: The typical master widget that drives selection
+- **Grouped Attributes**: Same concept but for the current page's own attributes
+- **Table Detail View**: Simpler alternative that shows all attributes automatically
+- **Connected charts**: Charts can also connect to tables using the same master-detail pattern

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/_summary.md

@@ -0,0 +1 @@
+Allows you to position the attributes from a table flexibly. Use for master-detail patterns where selecting a table row should show that item's details in a separate panel.

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/cf.cplace.platform.attributesGroup.layout.md

@@ -0,0 +1,8 @@
+**Warning**: Do not manually construct layout JSON - use the embedded layout MCP tools!
+
+**Purpose**: Defines the grid layout structure and embedded widget configurations. This is the core of the attributesGroup widget, containing the actual attribute widgets arranged in rows and columns.
+
+**MCP Tools for Managing Embedded Layouts**:
+- `cplace_get_embedded_layout`: Retrieve current embedded layout structure
+- `cplace_add_widget_to_embedded_layout`: Add widgets to the layout
+- `cplace_remove_widget_from_embedded_layout`: Remove widgets from the layout

package/dist/widget-specifications/cf.cplace.platform.connectedAttributesGroup/singleSelectionWidgetId.md

@@ -0,0 +1,15 @@
+**Warning**: Despite the localized name "Data source", this is NOT where you provide data - it's a widget ID selector!
+
+**Purpose**: Specifies which widget on the same page provides entity selection events. When a user selects an entity in that widget, this connected attributes group widget refreshes to show that entity's attributes.
+
+**Valid Widget Types**: Currently only table widgets (`cf.cplace.platform.table`) implement the required `ISingleEntitySelectionProducer` interface.
+
+**How to Get Valid Values**: The dropdown is populated dynamically by `SingleSelectionWidgetEnumerationProvider` which finds all widgets on the same page that can provide entity selection events.
+
+**Workflow**:
+1. Ensure there is at least one table widget on the same page
+2. The table widget's ID will appear in the enumeration dropdown
+3. Select the table widget ID you want to connect to
+4. The layout configuration field becomes visible after this is set
+
+**Note**: The layout visibility is controlled by `showPropertyInEdit()` - layout field only shows after a selection widget is configured.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.dynamicIframe",
+  "Description": "{\"de\":\"Bindet den Inhalt einer beliebigen Webseite (als Inlineframe) ein oder erzeugt eine Schaltfläche zum Aufrufen einer festgelegten URL. Die URL kann dabei in Abhängigkeit von Attributwerten dynamisch erzeugt werden.\",\"en\":\"Integrates the content of any site (as an inline frame) or generates a button for calling up a defined URL. Here the URL can be created dynamically depending on attribute values.\"}",
+  "Localized Name": "{\"en\":\"Dynamic Inline Frame\",\"de\":\"Dynamischer Inlineframe\"}",
+  "Icon": "fa-laptop",
+  "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><p>The 'Dynamic Inline Frame' widget can either be used to embed the content of any other webpage by means of an iframe element or to create a button for calling a specified URL. The URL can also be generated dynamically based upon attribute values.</p><p><strong>Settings</strong></p><p>// * Title*: Bilingual text.</p><p>// * URL pattern*: Name generation pattern. You can use attribute names in angle brackets &lt;&gt;, to include attributes of the embedding page.</p><p>// * Show only button*: True/false. If this option is set, instead of displaying an iframe only a button that opens a new tab will be shown.</p><p>// * Button label:</p><p>// * Height:</p>"
+}

package/dist/widget-specifications/cf.cplace.platform.dynamicIframe/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "attributes",
+    "media",
+    "read-only",
+    "detail-view"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.cplace.platform.dynamicIframe/_overview.md

@@ -0,0 +1,49 @@
+## Overview
+
+Integrates the content of any site (as an inline frame) or generates a button for calling up a defined URL. Here the URL can be created dynamically depending on attribute values.
+
+The widget extends the standard Inline Frame widget by enabling dynamic URL construction using page attributes. Instead of a static URL, users define URL patterns with attribute placeholders (using angle bracket syntax `<attributeName>`), which are substituted with actual values at runtime. This allows context-aware embedding of external content based on the data of the current page.
+
+The widget supports two display modes:
+- **Inline Frame Mode** (default): Embeds external content directly within the page
+- **Button Mode**: Shows a button that opens the URL in a new browser tab
+
+## Use Cases
+
+- **External Documentation Integration**: Display context-specific documentation based on page attributes (e.g., `https://docs.company.com/<productId>/manual.html`)
+- **External API Visualization**: Embed dashboards or reports from external systems using page data as parameters
+- **Third-Party Tool Integration**: Integrate with external tools like Jira by constructing URLs from page attributes (e.g., `https://jira.company.com/browse/<ticketId>`)
+- **Dynamic Map Embedding**: Show location-based content using address or coordinate attributes
+- **External Form Integration**: Link to external forms with pre-filled data from page attributes
+
+## Design Considerations
+
+### When to Use Dynamic Inline Frame vs Inline Frame
+
+- Use **Inline Frame** (`cf.platform.iframe`) for static URLs that don't change based on page content
+- Use **Dynamic Inline Frame** when the URL should incorporate values from page attributes
+
+### URL Pattern Syntax
+
+- Attribute references use angle brackets: `<attributeName>`
+- Multiple attributes can be combined in a single URL pattern
+- Attribute values are automatically URL-encoded when part of a larger pattern
+- Special case: When the entire pattern is a single attribute (e.g., `<url>`), no encoding is applied to allow storing complete URLs
+
+### Button Mode
+
+Use button mode when:
+- External sites block iframe embedding (X-Frame-Options)
+- Users prefer opening content in a separate tab
+- The iframe display is not desired for UX reasons
+
+### Validation Requirements
+
+- The URL pattern must contain at least one attribute reference
+- All referenced attributes must exist in the page type
+- Referenced attributes must have non-empty values at runtime
+
+## Related Patterns
+
+- **Inline Frame** (`cf.platform.iframe`): For static URL embedding without dynamic content
+- **Single Attribute** (`cf.platform.singleAttribute`): For displaying attribute values directly rather than embedding external content

package/dist/widget-specifications/cf.cplace.platform.dynamicIframe/_summary.md

@@ -0,0 +1 @@
+Integrates the content of any site (as an inline frame) or generates a button for calling up a defined URL. The URL can be created dynamically depending on attribute values.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.platform.tableWidget",
+  "Description": "{\"en\":\"Displays a list of search results.\",\"de\":\"Zeigt eine Liste von Suchergebnissen an.\"}",
+  "Localized Name": "{\"en\":\"Table 2.0\",\"de\":\"Tabelle 2.0\"}",
+  "Icon": "fa-table",
+  "Plugin": "cf.cplace.platform",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace",
+  "* Details DE": null,
+  "* Details EN": null
+}