@cplace/mcp-server 1.3.14

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.richString",
+  "Description": "{\"en\":\"Widget for entering formatted text with a title.\",\"de\":\"Widget zur Eingabe von formatiertem Text mit Titel.\"}",
+  "Localized Name": "{\"en\":\"Text\",\"de\":\"Text\"}",
+  "Icon": "fa-font",
+  "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 'Text' widget provides a title and a framed text box for entering formatted text in the layout view.</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Title*: Bilingual text.</p>\n\n<p>// * Content:</p>\n\n<p>&nbsp;</p>\n\n<p>&nbsp;</p>"
+}

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

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "rich-text",
+    "read-only",
+    "searchable",
+    "detail-view",
+    "collaboration"
+  ],
+  "requiredApp": null
+}

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

@@ -0,0 +1,43 @@
+## Overview
+
+Widget for entering formatted text with a title. The Rich String widget provides a way to add formatted HTML content to pages within a titled frame. Unlike attribute-based widgets that display data from entities, this widget stores its content directly in the widget configuration, making it ideal for static informational content that doesn't need to update dynamically with data changes.
+
+The widget supports the full range of HTML formatting options including headings, lists, links, tables, and embedded images, while ensuring security through automatic content sanitization.
+
+## Use Cases
+
+- **Documentation and Instructions**: Add formatted help sections, step-by-step guides, or explanatory content with headings and lists
+- **Announcements and Notices**: Display important messages with highlighted text, bold formatting, or colored content
+- **Rich Content Pages**: Build knowledge base articles, landing pages, or onboarding pages with structured content
+- **Meeting Notes and Summaries**: Capture formatted minutes with bullet points, action items, and decisions
+- **Embedded Links and References**: Create navigation sections or resource lists with hyperlinks to internal pages or external URLs
+- **Formatted Reports**: Present status summaries or executive overviews with rich formatting for clarity
+
+## Design Considerations
+
+### When to Use This Widget
+
+Use the Rich String widget when you need:
+- Static text content that doesn't change based on data
+- Formatted content with titles in a consistent framed presentation
+- Content that should be searchable via fulltext search
+- Multi-language title support (content itself is not localized)
+
+### When to Use Alternative Widgets
+
+- **Displaying entity attribute values**: Use `cf.platform.customRichStringAttribute` instead, which binds to a rich string attribute on an entity
+- **Frameless presentation**: Consider other approaches if you don't want the widget frame
+- **Dynamic content**: For content that should update when data changes, use attribute-display widgets
+
+### Content Limitations
+
+- All content is automatically sanitized for security (XSS protection)
+- Custom scripts and some HTML elements/attributes are stripped
+- Very large content may impact page load performance
+- Content is not versioned - no built-in history of changes
+
+## Related Patterns
+
+- **cf.platform.customRichStringAttribute** - Displays a rich string attribute from an entity (data-bound content)
+- **cf.platform.singleAttribute** - Displays any single attribute value from the current page
+- **cf.cplace.pageViewHeadline.widget** - Alternative for simple titled text sections

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

@@ -0,0 +1 @@
+Widget for entering formatted text with a title. Use for static content sections like documentation, announcements, instructions, or meeting notes in a framed widget container.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.singleAttribute",
+  "Description": "{\"de\":\"Ausgabe des Werts eines Attributs.\",\"en\":\"Output of the value of an attribute.\"}",
+  "Localized Name": "{\"en\":\"Single Attribute of a page\",\"de\":\"Einzelnes Attribut einer Seite\"}",
+  "Icon": "fa-pen-square",
+  "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 on a Page' widget displays the information that is available about an individual attribute.</p>\n\n<p>This widget cannot be used on its own but has to be embedded in a 'Grouped Attributes of a Page' widget (ToD: Add link) or in a 'Richstring' widget (ToDo:&nbsp; Add link).</p>\n\n<p><strong>Settings</strong></p>\n\n<p>// * Attribute name: List of available custom and system attributes.<br>\n// * Show attribute value*: True/false.<br>\n// * Show attribute name*: True/false.<br>\n// * Alternative attribute label: Bilingual text.<br>\n// * Allow in-place editing*: True/false.<br>\n// * Reload grouped widget after attribute change*: True/false.<br>\n// * Show attribute: cplaceJS script. The script entered here determines if the attribute is to be displayed.</p>\n\n<p><strong>Key Benefits</strong></p>\n\n<p><strong>Examples</strong></p>\n\n<p>&nbsp;</p>"
+}

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

@@ -0,0 +1,18 @@
+**Configuration Modes**:
+- **Value only** (`withValue=true`, `withLabel=false`): Shows attribute value inline
+- **Value + Label** (`withValue=true`, `withLabel=true`): Shows both label and value (supports two layouts via `singleColumn`)
+
+**Typical Configuration Workflow**:
+1. Set `entity` to the page whose attribute should be displayed
+   - Leave empty for current page
+   - Use `"<empty>"` when embedded inside a `cf.platform.attributesGroup` widget
+2. Set `quotedAttributeName` to the attribute to display
+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 `localizedAlternativeLabel` for a custom label
+5. Optional: Set `showAttributeScript` for conditional visibility
+6. Optional: Set `reloadAfterChange` to refresh parent widgets after edits
+
+**Embedding in AttributesGroup**: When this widget is embedded inside a `cf.platform.attributesGroup` widget, the following parameters are controlled by the parent widget: `entity`, `useParent`, `singleColumn`, `useNewFrontend`.

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

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

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

@@ -0,0 +1,83 @@
+## Overview
+
+Output of the value of an attribute. The Single Attribute widget displays one specific attribute from a page with fine-grained control over its presentation. Unlike the full Attributes widget that shows all attributes, this widget focuses on a single attribute with maximum configuration flexibility, including custom labels, in-place editing, and conditional visibility based on business logic.
+
+## Use Cases
+
+### Custom Attribute Layout
+
+Display specific attributes in a custom page layout without showing all attributes. Create summary sections at the top of pages showing only critical attributes (status, priority, owner) while keeping detailed attributes in separate sections.
+
+### Quick Edit Interface
+
+Enable rapid editing of specific attributes without opening full edit forms. Allow users to quickly update task status or priority directly from a page view, reducing clicks and page transitions.
+
+### Read-Only Display with Alternative Labels
+
+Show attribute values with custom, user-friendly labels instead of technical attribute names. Display a technical attribute like an internal code with a friendlier label for business users, with multi-language support.
+
+### Conditional Attribute Display
+
+Show or hide attributes based on dynamic conditions using cplaceJS scripts. Display "Rejection Reason" only when a request's status is "Rejected", or show "Approval Date" only for approved items.
+
+### Parent Page Attribute Display
+
+Display attributes from a parent page in hierarchical structures. Show project-level attributes on task pages without duplicating data across the hierarchy.
+
+### Value-Only Display
+
+Show attribute values without labels in compact layouts. Display status badges, icons, or values in dense UIs where labels would be redundant.
+
+### Building Block for Complex Forms
+
+Use as a building block within Attributes Group widgets to create custom multi-column forms with precise attribute placement and mixed widget types.
+
+## Design Considerations
+
+### Display Mode Options
+
+The widget supports three primary display modes:
+- **Label and Value**: Standard display showing both the attribute name and its current value
+- **Value Only**: Clean rendering without labels for compact layouts
+- **Label Only**: Show just the attribute name without its value
+
+At least one of label or value must be shown - the widget validates this requirement.
+
+### In-Place Editing
+
+When enabled, in-place editing allows users to modify attribute values directly in the display without form submission. Consider enabling the reload option if other widgets on the page depend on the edited attribute's value.
+
+### Conditional Visibility Scripts
+
+The visibility script receives two bindings:
+- `targetEntity`: The entity whose attribute is displayed
+- `embeddingPage`: The page where the widget is embedded
+
+The script should return a boolean - returning `false` hides the attribute.
+
+### Layout Control
+
+The single-column option controls whether the attribute displays in full-width or two-column layout. This setting is only relevant when showing the label.
+
+When embedded within an Attributes Group widget, layout settings are inherited from the parent widget.
+
+## Alternatives
+
+| Scenario | Recommended Widget |
+|----------|-------------------|
+| Display all attributes | `cf.platform.attributes` |
+| Multiple attributes with custom layout | `cf.cplace.platform.attributesGroup` |
+| Attribute from selected table row | `cf.platform.connectedSingleAttribute` |
+| Simple default display | `cf.platform.attributes` |
+
+## Common Pitfalls
+
+- **Forgetting display mode**: At least one of "Show attribute name" or "Show attribute value" must be enabled
+- **Missing reload setting**: When in-place editing is enabled and other widgets depend on the attribute, enable "Reload grouped widget after attribute change"
+- **Script binding confusion**: In visibility scripts, use `targetEntity` for the data source and `embeddingPage` for the widget's location
+
+## Related Patterns
+
+- **Master-Detail**: Use `cf.platform.connectedSingleAttribute` when the attribute source should change based on table selection
+- **Grouped Attributes**: Embed multiple Single Attribute widgets within an Attributes Group for complex form layouts
+- **Hierarchical Display**: Use the "Use parent page" option to show inherited attributes from parent entities

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

@@ -0,0 +1 @@
+Output of the value of an attribute. Displays a single attribute from a page with flexible label, value, and editing options, including in-place editing and conditional visibility for precise control over individual attribute placement.

package/dist/widget-specifications/cf.platform.singleAttribute/cf.platform.entity.md

@@ -0,0 +1,10 @@
+**Default Behavior**: When left empty, the widget displays an attribute from the page where it is embedded.
+
+**Valid Values**:
+- Empty/null: Use the current (embedding) page
+- Page UID: Reference to a specific page whose attribute should be displayed
+- `"<empty>"`: Special value when embedded inside a `cf.platform.attributesGroup` widget
+
+**Warning**: When embedded inside a `cf.platform.attributesGroup` widget, leave this empty or use `"<empty>"` - the parent widget provides the target entity.
+
+**Note**: This parameter is hidden from the edit UI when the widget is embedded inside `cf.platform.attributesGroup`.

package/dist/widget-specifications/cf.platform.singleAttribute/cf.platform.quotedAttributeName.md

@@ -0,0 +1,12 @@
+**Warning**: Use the full internal attribute name, not the simple/short name!
+
+**Important**:
+- **Custom attributes** require single quotes around the attribute name: `'cf.cplace.myApp.myAttribute'`
+- **Builtin attributes** (e.g., `name`, `createdAt`, `creator`, `modifiedAt`, `modifier`, `owner`, `_writers`) are specified without quotes: `name`
+
+**Workflow**:
+1. Call `cplace_get_type_datamodel` for the type of the target page
+2. Find the custom attribute you want to display
+3. Use the custom attribute's `name` field (the full internal name), wrapped in single quotes
+
+**Configuration Completeness**: The widget is incomplete if no attribute is selected. The selected attribute must also exist on the target type definition.

package/dist/widget-specifications/cf.platform.singleAttribute/cf.platform.singleColumn.md

@@ -0,0 +1,9 @@
+**Note**: This attribute is only relevant when both `withValue=true` AND `withLabel=true`.
+
+**Layout Modes**:
+- `false` (default): Two-column layout with label and value side by side
+- `true`: Single-column layout with label above value
+
+**Parent Widget Override**: When this widget is embedded inside a `cf.platform.attributesGroup` widget, the parent widget's `singleColumn` setting takes precedence over this widget's setting. The parent's layout configuration will override the individual widget's setting.
+
+**Hidden When Embedded**: This parameter is hidden from the edit UI when the widget is embedded inside `cf.platform.attributesGroup`.

package/dist/widget-specifications/cf.platform.singleAttribute/cf.platform.useParent.md

@@ -0,0 +1,11 @@
+**Purpose**: When enabled, displays an attribute from the parent page of the target entity instead of the target entity itself.
+
+**Valid Values**:
+- `false` (default): Display attribute from the target entity
+- `true`: Display attribute from the target entity's parent page
+
+**Use Case**: Useful for showing parent page attributes in child page layouts, such as displaying project-level information on task detail pages.
+
+**Behavior**: Only takes effect when the target entity is a Page type. If `useParent=true` and the target entity has no parent, the behavior depends on the implementation.
+
+**Note**: This parameter is hidden from the edit UI when the widget is embedded inside `cf.platform.attributesGroup`.

package/dist/widget-specifications/cf.platform.singleAttribute/cf.platform.withLabel.md

@@ -0,0 +1,11 @@
+**Warning**: At least one of `withValue` or `withLabel` must be `true` for the widget configuration to be complete!
+
+**Valid Values**:
+- `false` (default): Hide the attribute's label/name
+- `true`: Show the attribute's localized label/name
+
+**Configuration Completeness Check**: The widget validates that at least one display option is enabled. If both `withValue=false` and `withLabel=false`, the configuration is considered incomplete and the widget will not render properly.
+
+**Note**: The `singleColumn` attribute is only relevant when `withLabel=true` and `withValue=true` - it controls whether the label and value are displayed side by side or stacked vertically.
+
+**Frontend Behavior**: When `withLabel=false` and `inPlaceEditing=false`, the widget renders in inline mode using a span element. Otherwise, it uses a block-level div element.

package/dist/widget-specifications/cf.platform.singleAttribute/cf.platform.withValue.md

@@ -0,0 +1,12 @@
+**Warning**: At least one of `withValue` or `withLabel` must be `true` for the widget configuration to be complete!
+
+**Valid Values**:
+- `true` (default): Show the attribute's value
+- `false`: Hide the attribute's value (only valid if `withLabel=true`)
+
+**Configuration Completeness Check**: The widget validates that at least one display option is enabled. If both `withValue=false` and `withLabel=false`, the configuration is considered incomplete and the widget will not render properly.
+
+**Common Patterns**:
+- `withValue=true, withLabel=false`: Display value only (inline mode)
+- `withValue=true, withLabel=true`: Display both label and value
+- `withValue=false, withLabel=true`: Display label only (useful for showing which attribute is selected without showing its value)

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.tags",
+  "Description": "{\"en\":\"Shows all the tags of a page and allows you to edit them.\",\"de\":\"Zeigt alle Tags einer Seite und erlaubt ihre Bearbeitung.\"}",
+  "Localized Name": "{\"en\":\"Tags\",\"de\":\"Tags\"}",
+  "Icon": "fa-hashtag",
+  "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 'Tags' widget shows all tags added to a cplace page. The tags can be edited.</p>\n\n<p>&nbsp;</p>"
+}

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

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "metadata",
+    "inline-edit",
+    "searchable",
+    "detail-view",
+    "collaboration"
+  ],
+  "requiredApp": null
+}

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

@@ -0,0 +1,49 @@
+## Overview
+
+Shows all the tags of a page and allows you to edit them. The Tags widget displays and manages tags on pages. Tags provide a lightweight, flexible categorization system that complements formal data model attributes. Unlike fixed hierarchies or predefined categories, tags allow users to create ad-hoc classifications without modifying the data model.
+
+Every page in the cplace platform can have tags through the built-in `Taggable` mixin. Tags are normalized to lowercase, trimmed of whitespace, and fully integrated with search and versioning.
+
+## Use Cases
+
+- **Content Categorization**: Organize pages with flexible, user-defined labels (e.g., "important", "draft", "q1-2024")
+- **Search and Filtering**: Find pages with specific tags or build tag clouds based on frequency
+- **Workflow and Status Tracking**: Mark pages with workflow states (e.g., "review", "approved", "archived")
+- **Team Collaboration**: Share informal classifications across team members without formal schema changes
+- **Ad-hoc Organization**: Quick categorization for evolving needs without creating formal attributes
+
+## Design Considerations
+
+### When to Use Tags vs. Attributes
+
+Use tags when:
+- Classification needs are fluid and user-driven
+- Multiple cross-cutting categories apply to a single page
+- You want to avoid data model changes
+- Users need to experiment with different organizational schemes
+
+Use formal attributes when:
+- Values must be controlled or validated
+- Classification is part of core business logic
+- Reporting requires consistent, structured data
+
+### Visual Integration
+
+The Tags widget renders without a frame or padding, creating a clean appearance that blends seamlessly into page layouts. The hashtag icon provides instant visual recognition.
+
+### Search Integration
+
+Tags are fully indexed and support:
+- Exact tag matching via filters
+- Prefix-based autocomplete for tag suggestions
+- Tag cloud visualizations based on frequency
+- Space-scoped suggestions for relevance
+
+## Related Patterns
+
+- **cf.platform.attributes** - Display page attributes (formal structured data)
+- **cf.platform.modificationInfo** - Show creation/modification metadata
+- **cf.platform.incomingLinks** - Display references to a page
+- **cf.platform.comments** - Show page comments
+
+These widgets often appear together on page views to provide comprehensive metadata visualization.

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

@@ -0,0 +1 @@
+Shows all the tags of a page and allows you to edit them. Enables flexible categorization and classification of pages for better organization and searchability.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.platform.wiki",
+  "Description": "{\"en\":\"Adds a wiki to the page.\",\"de\":\"Fügt ein Wiki zur Seite hinzu.\"}",
+  "Localized Name": "{\"en\":\"Wiki\",\"de\":\"Wiki\"}",
+  "Icon": "fa-wikipedia-w",
+  "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 'Wiki' widget adds a fully-fledged Wiki editor component to a cplace page.</p>"
+}

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

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

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

@@ -0,0 +1,32 @@
+## Overview
+
+Adds a wiki to the page. The Wiki widget provides a Wikipedia-style rich-text editing experience for the built-in content field of pages, documents, and principal entities. It renders and allows in-place editing of HTML-formatted content including text, links, images, and embedded widgets.
+
+Unlike the Custom Rich String Attribute widget which works with custom attributes, the Wiki widget is specifically designed for the system's built-in content/description fields and requires no configuration.
+
+## Use Cases
+
+- **Page content management**: Create documentation pages, knowledge bases, project descriptions, and meeting notes with collaborative wiki-style editing
+- **Document descriptions**: Add contextual descriptions and explanations to uploaded files
+- **User profiles and group descriptions**: Create rich bio information, team descriptions, and document roles and responsibilities
+- **Type definition documentation**: Document custom types with usage guidelines and examples
+
+## Design Considerations
+
+### Zero Configuration
+The widget has no configurable attributes. It automatically determines which content field to use based on the entity type:
+- Pages and Documents: Uses the `_content()` field
+- Persons and Groups: Uses the `_description()` field
+- Type Definitions: Uses the `_description()` field
+
+### Single Instance Per Entity
+Only one Wiki widget should be embedded per entity since each entity has only one built-in content/description field.
+
+### In-Place Editing
+The widget provides modal-free, in-place editing rather than opening a separate dialog, making for a seamless content editing experience.
+
+## Related Patterns
+
+- **Custom Rich String Attribute Widget** (`cf.platform.customRichStringAttribute`): Use when you need to display/edit a custom rich-text attribute rather than the built-in content field. Offers configuration options like frame visibility and attribute selection.
+- **Attributes Widget**: Displays all entity attributes in a form layout
+- **Single Attribute Widget** (`cf.platform.singleAttribute`): Displays a single attribute value

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

@@ -0,0 +1 @@
+Adds a wiki to the page. Displays and enables in-place editing of the built-in rich-text content field for pages, documents, and user profiles with zero configuration.

package/dist/widget-specifications/cf.projektplanung.gantt/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.projektplanung.gantt",
+  "Description": "{\"en\":\"Provides the \\\"New Gantt\\\" widget, which enables the visualization and editing of planning elements and hybrid elements.\",\"de\":\"Stellt das Widget “Neues Gantt” bereit, welches das Visualisieren und Editieren von Planungselementen und hybriden Elementen ermöglicht.\"}",
+  "Localized Name": "{\"en\":\"New Gantt\",\"de\":\"Neues Gantt\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.projectPlanning",
+  "App": "cf.cplace.projectPlanning.app.gantt2.gantt2",
+  "Localized App Name": "{\"en\":\"New Gantt\",\"de\":\"Neues Gantt\"}",
+  "Repository": "cplace-project-planning",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.projektplanung.gantt/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "timeline",
+    "scheduling",
+    "tree",
+    "drag-drop",
+    "inline-edit",
+    "connected"
+  ],
+  "requiredApp": "cf.cplace.projectPlanning.app.gantt2.gantt2"
+}

package/dist/widget-specifications/cf.projektplanung.gantt/_overview.md

@@ -0,0 +1,61 @@
+## Overview
+
+The New Gantt widget enables the visualization and editing of planning elements and hybrid elements. Built on the Bryntum Gantt framework, it displays tasks as horizontal bars on a timeline, showing start dates, end dates, duration, and progress. The widget supports hierarchical task structures with expandable/collapsible tree views and allows users to manage dependencies between tasks.
+
+Key capabilities include:
+- **Visual timeline representation** of tasks with bars showing duration and progress
+- **Interactive editing** through drag-and-drop repositioning and bar resizing
+- **Dependency management** for creating and visualizing task relationships
+- **Hierarchical structure** with parent-child task relationships
+- **Multi-schedule support** for displaying tasks from one or multiple schedules
+- **Real-time synchronization** between the chart and cplace backend
+- **Hybrid element support** for tasks referenced from external systems
+
+## Use Cases
+
+### Project Planning Visualization
+Display the entire project timeline at a glance to understand task sequences, identify critical paths and bottlenecks, and monitor progress through percent completion indicators.
+
+### Interactive Schedule Management
+Adjust task dates by dragging bars, modify durations by resizing, create predecessor/successor relationships, and update task properties inline without leaving the chart view.
+
+### Multi-Schedule Planning
+Consolidate and compare timelines across different projects or work packages by displaying tasks from multiple schedules in a single unified view for portfolio-level planning.
+
+### Hybrid Element Planning
+Work with both native planning elements and hybrid elements that reference tasks from other systems, including delegated tasks sourced from external schedules and mirrored tasks that reflect changes from source tasks.
+
+## Design Considerations
+
+### When to Use
+- Users need a graphical timeline view rather than a table/list view
+- Visual planning and scheduling is important for understanding the project
+- Users need to interactively adjust dates through drag-and-drop
+- Understanding task relationships and dependencies is critical
+- Working with complex project hierarchies that benefit from tree + timeline views
+- Real-time collaboration on schedule adjustments is needed
+
+### When to Consider Alternatives
+- Users only need a simple task list without timeline visualization (use Schedule Tree Widget)
+- Primary focus is on data entry and bulk editing (table views may be more efficient)
+- Detailed attribute editing is the main activity (use detail pages or forms)
+- Very large datasets (1000+ tasks) may require filtering for performance
+
+### Configuration Options
+- **Schedule Selection**: Either explicitly specify schedules via the SCHEDULE attribute, or automatically load from the embedding page (SCHEDULE_SELECTION attribute)
+- **Widget Title**: Custom title for display (defaults to "Gantt chart for the schedules {names}")
+- **Height**: Fixed height setting for vertical space allocation
+- **Root Node Configuration**: Specify which nodes should appear as root elements in the hierarchy
+
+### Embedding Restrictions
+- Only one Gantt widget instance allowed per page
+- Requires the Gantt2 feature to be enabled
+- Cannot be configured directly in view mode
+
+## Related Patterns/Alternatives
+
+| Widget | When to Use Instead |
+|--------|---------------------|
+| **Schedule Tree Widget** (`cf.projektplanung.scheduleTreeTable`) | For table-based schedule views without timeline visualization; better suited for data-heavy operations and bulk editing. Often used alongside the Gantt on the same page. |
+| **Schedule Lock State Widget** (`cf.projektplanung.scheduleLockState`) | Used alongside Gantt to show lock state of schedules and prevent concurrent editing conflicts |
+| **Single Gantt Widget** (`cf.projektplanung.singleGantt`) | For simpler single-schedule Gantt views |

package/dist/widget-specifications/cf.projektplanung.gantt/_summary.md

@@ -0,0 +1 @@
+Enables the visualization and editing of planning elements and hybrid elements in an interactive Gantt chart. Built on the Bryntum Gantt framework, it supports drag-and-drop scheduling, dependency management, hierarchical task structures, and real-time synchronization with the cplace backend.

package/dist/widget-specifications/cf.projektplanung.ganttTaskDemo/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.projektplanung.ganttTaskDemo",
+  "Description": "{\"en\":\"Shows a preview of the task class.\",\"de\":\"Zeigt eine Vorschau der Vorgangsklasse.\"}",
+  "Localized Name": "{\"en\":\"Task Class Preview\",\"de\":\"Vorgangsklassen-Vorschau\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.projektplanungMasterData",
+  "App": "cf.cplace.projektplanungMasterData",
+  "Localized App Name": "{\"en\":\"Task Classes\",\"de\":\"Vorgangsklassen\"}",
+  "Repository": "cplace-project-planning",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.projektplanung.ganttTaskDemo/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "timeline",
+    "read-only",
+    "detail-view",
+    "scheduling",
+    "media"
+  ],
+  "requiredApp": "cf.cplace.projektplanungMasterData"
+}

package/dist/widget-specifications/cf.projektplanung.ganttTaskDemo/_overview.md

@@ -0,0 +1,65 @@
+## Overview
+
+The Task Class Preview widget shows a preview of the task class. It serves as a configuration assistant for Task Classes (Activity Classes) in the cplace project planning module, providing immediate visual feedback as administrators configure visual properties, showing how tasks and milestones of that class will appear in actual Gantt charts.
+
+The widget displays four preview variants simultaneously:
+- **Activity**: Regular task bar appearance
+- **Milestone**: Point-in-time marker appearance
+- **Rollup Activity**: Collapsed summary bar appearance
+- **Rollup Milestone**: Collapsed milestone indicator appearance
+
+## Use Cases
+
+### Primary Use Case: Task Class Configuration
+
+Users don't explicitly "choose" this widget - it's automatically included in the default layout of every Task Class page. It is useful when:
+
+1. **Creating New Task Classes**: Setting up visual distinctions for different types of tasks (e.g., "Development", "Testing", "Review"), choosing colors, and selecting shapes that intuitively represent task characteristics.
+
+2. **Customizing Existing Task Classes**: Adjusting colors for better contrast or accessibility, changing bar patterns to distinguish similar task types, configuring rollup appearance for hierarchical project views.
+
+3. **Visual Consistency Verification**: Ensuring that task visual styles are consistent across the organization, previewing how tasks will appear before applying changes.
+
+### Problem It Solves
+
+Without this widget, administrators would have to configure Task Class properties blindly, save changes, navigate to a Gantt chart, find a task with that class, evaluate the appearance, navigate back to make adjustments, and repeat the cycle. The preview widget eliminates this cycle by providing immediate WYSIWYG feedback.
+
+## Design Considerations
+
+### Embedding Context
+
+This widget can only be embedded on pages of type `cf.activityClass` (Task Class). It reads all custom attributes from the embedding Task Class page and renders the preview accordingly.
+
+### No Configuration Required
+
+The widget itself has no configuration options - it's a pure preview/display widget. It visualizes the Task Class attributes:
+- Shape selections (activity and milestone shapes)
+- Colors (bar color, border color)
+- Patterns (stripes, dots, solid fill)
+- Rollup colors (optional fallback to main colors)
+- Label positions
+
+### Live Updates
+
+Changes to any Task Class attribute trigger immediate re-rendering of the preview. The widget uses SVG-based rendering for scalable, crisp shapes.
+
+## Related Patterns
+
+### Part of Project Planning Master Data
+
+This widget is part of the Master Data configuration layer that supports the visualization layer:
+
+- **Task Classes** define how tasks look
+- **Gantt Chart Widgets** (`cf.projektplanung.gantt`, `cf.projektplanung.multiGantt`, `cf.projektplanung.singleGantt`) consume Task Class styling
+- **Schedule Tree Widget** also uses Task Class styling for visual indicators
+
+### Typical Page Layout
+
+On Task Class pages, the default layout typically places:
+- Attributes widget (left, 8-width) for editing properties
+- This preview widget (right, 4-width) for visual feedback
+- Wiki widget below for documentation
+
+## Alternatives
+
+There is no alternative widget for previewing Task Class styling. The preview functionality is unique to this widget.

package/dist/widget-specifications/cf.projektplanung.ganttTaskDemo/_summary.md

@@ -0,0 +1 @@
+Shows a preview of the task class, providing a live visual preview of how tasks and milestones will appear in Gantt charts based on their configured styling properties. Use when configuring Task Classes to see real-time feedback on colors, shapes, patterns, and label positions.

package/dist/widget-specifications/cf.projektplanung.multiGantt/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.projektplanung.multiGantt",
+  "Description": "{\"en\":\"Displays any number of schedules at the same time, which are pre-selected in the widget configuration.\",\"de\":\"Zeigt beliebig viele Pläne gleichzeitig an, die per Vorauswahl in der Widget-Konfiguration festgelegt werden.\"}",
+  "Localized Name": "{\"en\":\"Multi Gantt Chart\",\"de\":\"Multi-Gantt-Diagramm\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.projektplanung",
+  "App": "cf.cplace.projektplanung.projektplanungBasic",
+  "Localized App Name": "{\"en\":\"Project Planning (Basic)\",\"de\":\"Projektplanung (Basis)\"}",
+  "Repository": "cplace-project-planning",
+  "* Details DE": null,
+  "* Details EN": null
+}