@cplace/test-mcp-server 0.1.15 → 1.1.0

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

@@ -0,0 +1,25 @@
+## Overview
+
+Creates a QR code from the URL of the embedding page.
+
+The widget dynamically generates a QR code that encodes the absolute URL of the embedding cplace page. When users scan the QR code with a mobile device camera or QR code reader app, they are directed to that specific page. The widget uses the ZXing (Zebra Crossing) library for QR code generation with high error correction (Level H) to ensure readability even when a custom logo is overlaid.
+
+## Use Cases
+
+- **Mobile Access to Pages**: Enable quick access to cplace pages from mobile devices by scanning a QR code displayed on screen during presentations
+- **Physical-Digital Integration**: Print QR codes for display in physical spaces (offices, warehouses, production floors) to link physical assets or locations to their corresponding digital pages
+- **Meeting and Presentation Support**: Display QR codes during meetings so attendees can quickly access related pages without manually typing URLs
+- **Asset and Inventory Tracking**: Generate QR codes for equipment, inventory items, or project assets; print and attach codes to physical items for quick lookups
+- **Documentation and Reports**: Include QR codes in exported documents so readers can access the live, up-to-date page version
+
+## Design Considerations
+
+- **When to Use**: URLs are long/difficult to type, users need mobile access to pages on large screens, physical items need links to digital records, or quick touchless access is preferred
+- **Visual Customization**: Adjustable size (larger for presentations, smaller for inline use), color customization for branding, optional logo overlay for brand recognition, frame/quiet zone control
+- **Error Correction**: Uses Level H (highest, ~30% data recovery), ensuring the code remains scannable even with a centered logo overlay, partial damage, or reduced print quality
+
+## Related Patterns/Alternatives
+
+- **Link Widgets**: For simple URL sharing without QR codes, standard link or button widgets may suffice
+- **Video Widget** (`cf.cplace.videoWidget`): Another utility widget from the same repository for embedding media content
+- **External QR Generators**: For offline or static QR codes, external generators could be used, but this widget provides dynamic, always-current URLs

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

@@ -0,0 +1 @@
+Creates a QR code from the URL of the embedding page, allowing users to quickly access the page by scanning the code with a mobile device.

package/dist/widget-specifications/cf.cplace.resourceManagement.resourcePlannerDefinition/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.resourceManagement.resourcePlannerDefinition",
+  "Description": "{\"en\":\"Overview of resource allocations and utilization.\",\"de\":\"Überblick über Ressourcenzuordnungen und Auslastung.\"}",
+  "Localized Name": "{\"en\":\"Resource Planner\",\"de\":\"Ressourcenplaner\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.resourceManagement",
+  "App": "cf.cplace.resourceManagement",
+  "Localized App Name": "{\"en\":\"Resource Management\",\"de\":\"Ressourcenmanagement\"}",
+  "Repository": "cplace-resource-management",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.resourceManagement.resourcePlannerDefinition/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "table",
+    "tree",
+    "time-series",
+    "scheduling",
+    "inline-edit",
+    "dashboard"
+  ],
+  "requiredApp": "cf.cplace.resourceManagement"
+}

package/dist/widget-specifications/cf.cplace.resourceManagement.resourcePlannerDefinition/_overview.md

@@ -0,0 +1,78 @@
+## Overview
+
+Overview of resource allocations and utilization.
+
+The Resource Planner is a sophisticated visualization widget for managing resource allocations across time periods. It combines a hierarchical tree structure with a time-phased grid, enabling users to see how resources are allocated and utilized over configurable intervals.
+
+**Purpose**: Provide a comprehensive view of resource capacity, allocation, and utilization that enables informed planning decisions.
+
+**Use when**:
+- You need to visualize resource allocations across multiple projects or teams
+- Users must understand utilization levels at a glance through color-coded indicators
+- Planning requires comparing different allocation scenarios or data series
+- Hierarchical organization of resources (e.g., departments, teams, individuals) needs to be represented
+
+**Alternatives**:
+- **Embedded Search Table**: When you only need tabular data without time-phased visualization
+- **Highcharts**: When you need pure chart visualization without the interactive tree structure
+- **Gantt Chart**: When task scheduling and dependencies are more important than resource utilization
+
+## Use Cases
+
+### Strategic Portfolio Planning
+Executives and portfolio managers use this widget to gain visibility across all projects and resources. The focus is on long time horizons (quarters to years) with aggregated views that support strategic resource decisions.
+
+### Operational Resource Management
+Team leads and resource managers use this widget for day-to-day allocation decisions. The focus is on shorter time frames (weeks to months) with detailed utilization tracking to identify capacity issues.
+
+### Context-Specific Resource Views
+When embedded within a specific project or resource page, the widget shows allocations relevant to that context. This supports focused decision-making without the noise of unrelated data.
+
+### Comparison and Scenario Analysis
+The widget supports displaying multiple data series side by side, enabling users to compare planned versus actual allocations, or to evaluate different resource scenarios before committing to changes.
+
+## Behavior and Capabilities
+
+### Hierarchical Tree Structure
+Resources are organized in a collapsible tree that can represent organizational hierarchies, project structures, or any parent-child relationship defined in the data model. Users can expand and collapse levels to focus on relevant detail.
+
+### Time-Phased Grid
+The main visualization area displays values across configurable time intervals. Users can typically switch between different granularities (daily, weekly, monthly, quarterly, yearly) depending on their planning needs.
+
+### Utilization Color Coding
+Values are color-coded based on configurable thresholds, providing instant visual feedback about resource health. Common patterns include traffic-light coloring (green for healthy, yellow for warning, red for critical) or uniform coloring when status indication is not needed.
+
+### Dynamic Time Ranges
+Time ranges can be configured relative to the current date (e.g., "from 1 month ago to 12 months ahead"), ensuring the view stays relevant without manual updates.
+
+### Integrated Charts
+The widget can display summary charts that aggregate the grid data, providing visual summaries alongside the detailed tree view.
+
+### Configurable Actions
+Users can be given access to resource operations directly from the widget, streamlining workflows that involve allocation changes.
+
+## Design Considerations
+
+### Tree Depth vs. Performance
+Deeper hierarchies with many nodes can impact rendering performance and user experience. Consider collapsing deeper levels by default and ensuring searches return a reasonable number of nodes.
+
+### Time Granularity Trade-offs
+Finer granularity (days, weeks) provides more detail but can make the grid harder to read and slower to render. Coarser granularity (quarters, years) is better for strategic views but may hide short-term fluctuations.
+
+### Utilization Threshold Philosophy
+The choice of thresholds and colors communicates what "good" looks like. Tight bands (e.g., 90-110%) suit high-utilization environments where small deviations matter. Wider bands (e.g., 60-100%) allow more flexibility. Uniform coloring removes status indication entirely, making the view purely informational.
+
+### Context-Aware Root Selection
+When embedding this widget, consider what should be the "root" of the tree. Using the current page as root creates a focused view; using a broader search creates a portfolio view. The choice significantly affects user experience.
+
+### Comparison Groups
+Showing multiple data series adds analytical power but also visual complexity. Use comparison groups when the analytical benefit justifies the added cognitive load.
+
+## Related Widgets
+
+| Widget | Relationship |
+|--------|--------------|
+| **Highcharts** | Often paired above the Resource Planner to provide summary visualizations of the same data |
+| **Embedded Search Table** | Shows related tabular data (requests, assignments) alongside the planner view |
+| **Navigation Tiles** | Provides dashboard navigation context when the planner is part of a larger dashboard |
+| **Attributes Group** | Displays resource properties and details in sidebar or header positions |

package/dist/widget-specifications/cf.cplace.resourceManagement.resourcePlannerDefinition/_summary.md

@@ -0,0 +1 @@
+Overview of resource allocations and utilization. Visualizes allocations across time periods with a hierarchical tree and time-phased grid with color-coded capacity indicators.

package/dist/widget-specifications/cf.cplace.rest.config.widget.productionModeHintWidget/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.rest.config.widget.productionModeHintWidget",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Production mode hint\",\"de\":\"Produktionsmodus Hinweis\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.rest.config",
+  "App": "cf.cplace.rest.config",
+  "Localized App Name": "{\"en\":\"REST-API Configuration\",\"de\":\"REST-API-Konfiguration\"}",
+  "Repository": "cplace-rest",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.rest.config.widget.productionModeHintWidget/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "metadata",
+    "read-only",
+    "detail-view",
+    "dashboard"
+  ],
+  "requiredApp": "cf.cplace.rest.config"
+}

package/dist/widget-specifications/cf.cplace.rest.config.widget.productionModeHintWidget/_overview.md

@@ -0,0 +1,44 @@
+## Overview
+
+The Production Mode Hint widget is a configuration safety assistant for REST API settings. It detects when cplace is running in production mode and displays alerts about REST API configurations that may be inappropriate for production environments, helping administrators ensure secure and optimized deployments.
+
+## Use Cases
+
+### Production Environment Validation
+During or after deployment to production, the widget validates that REST API configurations meet production best practices. It identifies settings that may have been carried over from development environments and provides guidance on what should be changed.
+
+### Development-to-Production Migration
+When transitioning an instance from development to production, the widget highlights configurations that need updating. This prevents common oversight errors during environment promotion.
+
+### Security Audits
+For regular reviews of production configurations, the widget provides a checklist of security-critical REST API settings, helping maintain compliance with security policies.
+
+### Multi-Environment Management
+When managing multiple cplace instances, the widget serves as a quick visual indicator of which environments are production-ready and helps track configuration drift across environments.
+
+## Design Considerations
+
+### Administrator-Only Context
+This widget is designed for system administrators with configuration rights. It should be placed on REST API configuration pages or system administration dashboards where administrators manage environment settings.
+
+### Informational, Not Blocking
+The widget displays warnings but does not automatically fix issues or block deployments. Warnings are informational guidance, allowing administrators to make informed decisions based on their specific requirements.
+
+### Environment-Aware
+The widget detects the platform's operational mode (development vs. production) and tailors its warnings accordingly. In development mode, it may display fewer or different warnings.
+
+## Common Pitfalls
+
+- Ignoring warnings without understanding their implications - each warning has a security or performance rationale
+- Assuming all warnings must be addressed - some may be acceptable for specific internal or controlled environments
+- Not reviewing the widget after configuration changes - re-check whenever REST API settings are modified
+
+## Alternatives
+
+For general alert or notification needs unrelated to REST API production configuration, consider standard notification widgets. This widget is specifically designed for REST API configuration validation and integrates with cplace's REST API system.
+
+## Related Patterns
+
+- System administration dashboards with configuration status overview
+- Deployment checklists that include widget review as a verification step
+- Environment comparison views showing configuration differences across instances

package/dist/widget-specifications/cf.cplace.rest.config.widget.productionModeHintWidget/_summary.md

@@ -0,0 +1 @@
+Displays warnings and recommendations about REST API configuration settings that should be reviewed or modified for production environments. Use to validate REST API configurations against security and performance best practices.

package/dist/widget-specifications/cf.cplace.simpleCalendar.calendar/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.simpleCalendar.calendar",
+  "Description": "{\"en\":\"Used to display events in a calendar view.\",\"de\":\"Dient zur Anzeige von Ereignissen in einer Kalenderansicht.\"}",
+  "Localized Name": "{\"en\":\"Calendar\",\"de\":\"Kalender\"}",
+  "Icon": "fa-calendar",
+  "Plugin": "cf.cplace.simpleCalendar",
+  "App": "cf.cplace.simpleCalendar",
+  "Localized App Name": "{\"en\":\"cplace Calendar\",\"de\":\"cplace Kalender\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.simpleCalendar.calendar/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "scheduling",
+    "filterable",
+    "selectable",
+    "dashboard",
+    "reporting"
+  ],
+  "requiredApp": "cf.cplace.simpleCalendar"
+}

package/dist/widget-specifications/cf.cplace.simpleCalendar.calendar/_overview.md

@@ -0,0 +1,42 @@
+## Overview
+
+Used to display events in a calendar view.
+
+The Calendar Widget transforms cplace pages into interactive calendar events by mapping date attributes to visual calendar entries. It provides a unified calendar view for displaying multiple event types from one or more spaces, with support for event categorization through event classes, color-coding, and interactive filtering.
+
+The widget operates on an Event Type Configuration model where cplace types are mapped to calendar events through configuration pages stored in each space. Each event type specifies start and end date attributes, default colors, and optional display name patterns. Event classes provide fine-grained categorization within event types based on attribute values (e.g., status, priority).
+
+Four calendar view modes are supported: Month View (default), Week View, Day View, and List Year View. The widget requires the cplace Calendar App to be installed in target spaces where events are configured.
+
+## Use Cases
+
+- **Project Timeline Visualization**: Display project milestones, tasks, or phases to understand temporal distribution and identify scheduling conflicts across multiple projects.
+
+- **Resource Scheduling**: Track resource availability, bookings, or absences across team members with event classes for different absence types (vacation, sick leave, training).
+
+- **Multi-Type Event Aggregation**: Combine different event types (meetings, deadlines, releases) into a single calendar view for executive dashboards showing all important dates.
+
+- **Compliance and Deadline Tracking**: Monitor regulatory deadlines, audit dates, or compliance milestones with categorization by priority or regulatory body.
+
+- **Event Management**: Display and manage conferences, workshops, or company events with categorization by event type.
+
+## Design Considerations
+
+- **Event Selection**: Events can be defined via search queries (fine-grained control) or by selecting shown event types (simpler configuration). Search-based selection requires specifying the embedding space.
+
+- **Interactive Features**: Optional year selector provides slider navigation when multiple years have events. Event class filtering allows users to show/hide events by category with color-coded buttons showing event counts.
+
+- **Event Creation**: When enabled, displays action buttons to create events directly from the calendar, adapting to show a dropdown for multiple types or a single button for one type.
+
+- **Multi-Space Support**: Can aggregate events from multiple spaces, with each space maintaining its own event type configurations.
+
+- **Color Hierarchy**: Colors are resolved from event class first, then event type, with a default cplace blue fallback.
+
+- **Performance**: Configuration is cached globally per space, and events load dynamically for the visible date range only.
+
+## Related Patterns/Alternatives
+
+- **Table Widget**: For tabular display of the same time-based data when calendar visualization is not needed.
+- **Timeline/Gantt Widgets**: For duration-focused visualization with dependency relationships between items.
+- **Board Widget**: For status-focused views of items that happen to have dates.
+- **Connected Table Filter**: Can be combined with the calendar for additional filtering capabilities.

package/dist/widget-specifications/cf.cplace.simpleCalendar.calendar/_summary.md

@@ -0,0 +1 @@
+Used to display events in a calendar view. Supports month, week, day, and list views with color-coded event classes, year navigation, event filtering, and direct event creation.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.simpleForm.widget",
+  "Description": "{\"en\":\"Allows easy creation of multiple instances of a type\",\"de\":\"Ermöglicht die einfache Erstellung von mehreren Instanzen eines Typs\"}",
+  "Localized Name": "{\"en\":\"Creation Form\",\"de\":\"Anlageformular\"}",
+  "Icon": "cf-pencil-group",
+  "Plugin": "cf.cplace.simpleForm",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": "<p><strong>More Details</strong></p>\n\n<p>The 'Creation Form' widget provides a simple form for creating multiple pages of the same cplace type without having to reopen the normal creation form for each page.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title: Bilingual text.</p>\n\n<p>// * Show widget frame*: True/false.</p>\n\n<p>// * Single column*: True/false.</p>\n\n<p>// * Type to create*:</p>\n\n<p>// * Reference to embedding page: Only shown after a type has been selected. The specified attribute will automatically be set to the embedding page.</p>\n\n<p>// * Attributes layout*: Only shown after a type has been selected.</p>\n\n<p>// * Height:</p>"
+}

package/dist/widget-specifications/cf.cplace.simpleForm.widget/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "form",
+    "inline-edit",
+    "references",
+    "container",
+    "navigation"
+  ],
+  "requiredApp": null
+}

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

@@ -0,0 +1,85 @@
+## Overview
+
+The Creation Form widget allows easy creation of multiple instances of a type. It streamlines the process of creating multiple related pages by embedding a creation form directly into the current page. Instead of navigating away to create new pages individually, users can create many instances in succession without losing context. After submitting the form, it automatically resets to allow immediate creation of the next instance.
+
+Key characteristics:
+- Always displays in edit mode (always editable)
+- Automatically resets after successful submission
+- Can preset reference attributes to link created pages to the embedding page
+- Supports custom layouts for attribute arrangement
+
+## Use Cases
+
+### Rapid Data Entry
+When users need to create many instances of the same type in succession:
+- Creating multiple tasks within a project page
+- Adding multiple risk items to a risk register
+- Logging multiple issues or incidents
+- Entering a series of related records (meeting minutes, action items)
+
+### Contextual Page Creation
+Creating pages that are automatically linked to the current context:
+- A project page with a form to create tasks that are automatically linked to that project
+- A parent entity with a form to create child entities
+- A workflow stage with a form to create items in that stage
+
+### Simplified User Experience
+Reducing navigation complexity for non-technical users:
+- Providing a focused creation interface without the full page creation workflow
+- Hiding complexity by showing only relevant attributes in the form
+- Maintaining user context by keeping them on the same page
+
+### Embedded Creation Workflows
+Supporting specific business processes:
+- Feedback collection forms
+- Quick entry forms for repetitive data
+- Intake forms for requests or submissions
+- Data collection interfaces embedded in dashboards
+
+## Design Considerations
+
+### When to Use This Pattern
+Use the Creation Form widget when:
+- Users need to create multiple related pages in succession
+- Created pages should automatically reference the embedding page (parent-child relationships)
+- Only a subset of attributes needs to be filled during creation
+- Maintaining user context and minimizing navigation is important
+- The creation process is part of a larger workflow on the page
+
+### When Not to Use This Pattern
+Consider alternatives when:
+- Users typically create only one page at a time
+- All attributes should be filled during creation
+- The page type requires complex configuration that benefits from full-page creation flow
+- Post-creation navigation to the created page is desired
+
+### Permission Handling
+The widget performs permission checks before displaying the form:
+- Verifies that the current user has rights to create pages of the specified type
+- Checks creation permissions in the context of the specified space
+- If an attribute matching embedded is configured, validates that the user can create pages with that reference preset
+- If the user lacks permissions, the form is not displayed
+
+## Comparison with Standard Page Creation
+
+| Aspect | Creation Form Widget | Standard Page Creation |
+|--------|-------------------|----------------------|
+| Navigation | Stays on same page | Navigates to creation form |
+| Workflow | Optimized for multiple creations | One at a time |
+| Context | Preserves current page context | New page context |
+| Customization | Configurable attribute subset | All attributes shown |
+| Linking | Automatic reference to embedding page | Manual relationship setup |
+| Button Labels | "Create and continue" | "Save" |
+| After Save | Form resets for next entry | Navigates to created page |
+
+## Related Patterns
+
+### Attribute in Form Widget
+**Widget ID**: `cf.cplace.simpleForm.attributeInForm`
+
+This companion widget can only be embedded inside the Creation Form widget. It is used within the layout configuration to specify individual attributes that should be displayed in the form.
+
+Purpose:
+- Provides granular control over which attributes appear in the form
+- Allows ordering of attributes
+- Enables selective display of only relevant attributes

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

@@ -0,0 +1 @@
+Allows easy creation of multiple instances of a type by embedding a creation form directly into the current page. The form automatically resets after submission for immediate creation of the next instance.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.tableDetailViewWidget.widget",
+  "Description": "{\"en\":\"Dynamically displays attributes of a selected table entry and therefore requires a table.\",\"de\":\"Zeigt dynamisch Attribute eines selektierten Tabelleneintrags an und setzt daher eine Tabelle voraus.\"}",
+  "Localized Name": "{\"en\":\"Page Details\",\"de\":\"Seitendetails\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.tableDetailViewWidget",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.tableDetailViewWidget.widget/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "attributes",
+    "table",
+    "detail-view",
+    "connected",
+    "read-only",
+    "selectable"
+  ],
+  "requiredApp": null
+}

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

@@ -0,0 +1,92 @@
+## Legacy Notice
+
+**This widget is considered legacy.** For new implementations, use `cf.cplace.platform.connectedAttributesGroup` (Grouped Attributes of a Table) instead, which offers:
+- Flexible embedded layout (vs. fixed 3-column)
+- Inline editing support (vs. read-only only)
+- Part of core platform (vs. separate plugin)
+
+This widget remains functional for existing implementations but is not recommended for new master-detail layouts.
+
+---
+
+## Overview
+
+The Page Details widget dynamically displays attributes of a selected table entry and therefore requires a table. It creates a master-detail interface by displaying selected attributes of a page chosen from a connected table widget. The detail panel automatically updates when users select different rows in the table, showing a configurable set of attributes in a structured layout.
+
+This widget implements the classic master-detail UI pattern where a table widget (the master) shows multiple rows of data, and this widget (the detail) shows comprehensive information about the selected row. The synchronization is automatic - clicking a table row instantly updates the detail view.
+
+## Use Cases
+
+### When to Use This Widget
+
+**Space-Constrained Table Views**
+When a table has many columns that don't all fit comfortably on screen, use this widget to show key columns in the table while displaying detailed attributes in the detail panel. For example, a project list might show only name and status in the table, with full details (description, dates, owner, budget) appearing in the detail panel.
+
+**Read-Only Detail Information**
+Ideal for displaying additional context about a selected item without providing editing capabilities. Use when users need to review details but not modify them, such as viewing full specifications of a product selected from a catalog table.
+
+**Dashboard and Reporting Layouts**
+Create dashboard pages with table plus detail layouts, or master-detail reports where the table provides overview and the detail provides depth. For example, a risk register showing all risks in a table, with detailed risk assessment displayed when a risk is selected.
+
+**Improved User Experience**
+Avoid navigation away from the current page to see details, keeping users in context while browsing list data. Provides quick preview of full information without opening separate pages, such as a task list where selecting a task shows its full description and metadata.
+
+**Structured Information Display**
+Show related but categorized information when details are too verbose for table columns but important to have readily accessible. For example, incident management where the table shows incident titles and status, while the detail panel shows full description, timestamps, and involved parties.
+
+### Problem This Widget Solves
+
+The widget addresses the challenge of displaying detailed information from tables without overwhelming the table view or requiring navigation:
+
+- **Limited horizontal space**: Tables with many columns become unwieldy and hard to scan
+- **Information density**: Users need both overview (table) and details simultaneously
+- **Navigation overhead**: Opening individual pages disrupts workflow and context
+- **Context switching**: Users want to browse multiple items quickly without leaving the page
+
+It provides a responsive detail panel that keeps users on the same page while exploring data, combining efficient scanning of list data with instant access to comprehensive details.
+
+## Design Considerations
+
+### Display Layout
+
+The widget uses a fixed 3-column layout for displaying attributes:
+- Attributes are automatically distributed across three columns using modulo logic
+- Each attribute is shown with its label and value
+- Optional header section can display rich text content above the attributes
+- All attributes are displayed in read-only mode (no in-place editing)
+
+### Initial Selection Behavior
+
+When the page first loads, if no table row has been explicitly selected, the widget displays attributes for the first entry from the connected table's search results. This ensures the detail panel always shows something useful rather than being empty.
+
+### Event-Driven Architecture
+
+The widget listens for row selection events from the connected table widget and updates its content dynamically via AJAX. This creates a seamless, responsive experience without page reloads.
+
+## Common Pitfalls
+
+- **Same-Page Requirement**: The table and detail widgets must be on the same page. You cannot connect to tables on other pages or workspaces.
+- **Read-Only Limitation**: This widget displays attributes in read-only mode. If you need editing capabilities, consider using the Tuples Widget instead.
+- **Fixed Layout**: The 3-column layout is not configurable. You cannot adjust to 1, 2, or 4 columns.
+- **Single Selection Only**: The widget shows details for only one selected page at a time. Multi-selection is not supported.
+
+## Related Widgets
+
+**cf.cplace.platform.tableWidget** (Table Widget)
+Required companion widget that serves as the master in the master-detail relationship. The table provides the list of pages, and this widget displays details of the selected item.
+
+**cf.platform.embeddedSearchAsTable** (Embedded Search as Table)
+Can be used as the master table widget, displaying search results in table format with details shown in this widget when a result is selected.
+
+**cf.cplace.tuplesWidget.widget** (Tuples Widget)
+Alternative when editing is required. Tuples Widget provides inline editing capabilities and CRUD operations on references, while Page Details is read-only and focused on viewing details.
+
+**cf.cplace.platform.connectedAttributesGroup** (Connected Attributes Group)
+Different use case - shows attributes of a fixed referenced page (static 1-to-1 relationship), while Page Details shows attributes of a dynamically selected table row.
+
+## Alternatives
+
+- If you need **editing capabilities** for the selected item, use the **Tuples Widget** which supports inline editing and CRUD operations.
+- If you need to display attributes of a **static referenced page** (not table-driven selection), use the **Connected Attributes Group** widget.
+- If you want to display all attributes of the **current embedding page** itself, use the **Attributes Widget** instead.
+- If you need a **custom layout** or more than 3 columns, consider building a custom low-code widget with the desired layout.

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

@@ -0,0 +1 @@
+**Legacy widget** - prefer `cf.cplace.platform.connectedAttributesGroup` for new implementations. Displays attributes of a selected table row in a fixed 3-column read-only layout. Use the preferred alternative for flexible layouts and inline editing.

package/dist/widget-specifications/cf.cplace.tableDetailViewWidget.widget/attributes.md

@@ -0,0 +1,7 @@
+**Warning**: Custom attribute names must use their fully qualified internal names.
+
+**Value Format**:
+- **Custom attributes**: Use fully qualified names like `'cf.cplace.solution.taskTitle'`
+- **Built-in attributes**: Use simple feature names like `name`, `creator`, `created`
+
+**Note**: The enumeration provider dynamically populates available attributes based on the connected table widget's type. Only attributes from the table's result type are selectable.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.treeTableWidget",
+  "Description": "{\"en\":\"Table with tree functionality\",\"de\":\"Tabelle mit Baumfunktionalität\"}",
+  "Localized Name": "{\"en\":\"Tree-structure Table\",\"de\":\"Baumstruktur-Tabelle\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.treeTableWidget",
+  "App": "cf.cplace.treeTableWidget",
+  "Localized App Name": "{\"en\":\"Tree-structure Table\",\"de\":\"Baumstruktur-Tabelle\"}",
+  "Repository": "cplace-utility-widgets",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.treeTableWidget/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "tree",
+    "table",
+    "references",
+    "navigation",
+    "filterable",
+    "selectable"
+  ],
+  "requiredApp": "cf.cplace.treeTableWidget"
+}

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

@@ -0,0 +1,51 @@
+## Overview
+
+The Tree-structure Table widget provides a table with tree functionality. It displays hierarchical page relationships in a combined tree-table format, enabling users to navigate through parent-child page structures while viewing associated attribute data in configurable columns. The widget supports expand/collapse functionality for tree nodes and includes a rich context menu with common page operations.
+
+This widget is a concrete implementation of the platform's abstract `TreeTableWidgetDefinition`, providing ready-to-use functionality without requiring custom frontend development. It leverages 100% platform rendering capabilities for reliability and maintainability.
+
+## Use Cases
+
+### Project and Work Breakdown Structures
+Display project hierarchies with tasks, sub-tasks, and deliverables. Navigate through complex project organizations and work package breakdowns in a structured format.
+
+### Organizational Hierarchies
+Visualize organizational structures including departments, teams, and roles. Display reporting relationships and navigate through organizational units.
+
+### Document and Content Hierarchies
+Show document folder structures and content hierarchies such as chapters, sections, and sub-sections. Useful for navigating through knowledge bases.
+
+### Product and Component Structures
+Display product hierarchies, component breakdowns, and system architectures. Navigate through technical structures and dependencies.
+
+### Navigation and Overview Pages
+Create dashboard pages with hierarchical navigation, provide overview pages showing entire page structures, and serve as entry points to complex information architectures.
+
+## Design Considerations
+
+### When to Use
+- Displaying parent-child page relationships with associated data columns
+- Users need to navigate through multi-level hierarchies efficiently
+- Combining tree navigation with tabular data display
+- Quick access to context menu actions on hierarchical items is valuable
+
+### When Not to Use
+- Simple lists without hierarchy (use Table widget instead)
+- Data without parent-child relationships (use regular Table widget)
+- Complex custom interactions that exceed platform rendering capabilities
+
+### Configuration Requirements
+- Pages must have a parent-child relationship attribute defined
+- At least one attribute must be configured for column display
+- Search configuration defines which page types appear in the tree
+- Default depth setting affects initial load performance for large hierarchies
+
+### Context Menu Features
+The widget provides context menu actions including: New Subpage, Open in New Tab, Expand All Children, Copy, Move, and Delete. These actions require appropriate user permissions.
+
+## Related Patterns and Alternatives
+
+- **Table Widget** (`cf.cplace.platform.tableWidget`): For flat data without hierarchical relationships
+- **Extended Tree Table Widget** (`cf.cplace.extendedTreeTableWidget`): For more advanced tree-table configurations
+- **Tree widgets**: When only tree navigation is needed without tabular data columns
+- **Connected Table Filter**: For tables with external filtering capabilities

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

@@ -0,0 +1 @@
+Table with tree functionality that displays hierarchical page structures with expandable/collapsible nodes and configurable data columns. Combines tree navigation for parent-child relationships with tabular data display.