@cplace/test-mcp-server 0.1.15 → 1.1.0

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.cleanupConfigTable/_overview.md

@@ -0,0 +1,61 @@
+## Overview
+
+The Cleanup Config Table widget displays cleanup job configurations for the Enterprise Connectivity Foundation (ECF). It shows all cleanup configurations associated with a specific connector, enabling administrators to manage automated cleanup schedules for synchronized data.
+
+The widget automatically filters cleanup configurations to show only those belonging to the connector page it's embedded in, providing a focused view of cleanup policies for that specific integration.
+
+## Use Cases
+
+### Managing Automated Cleanup Schedules
+
+Configure when and how often cleanup jobs run for synchronized data. The widget displays all cleanup configurations in one place, allowing users to create, view, and modify schedules using cron expressions. Default schedule runs every 10 minutes, but can be adjusted based on data volume and cleanup requirements.
+
+### Configuring Orphaned Entity Deletion
+
+When source entities are deleted in an external system, corresponding target entities in cplace become "orphaned". The widget enables configuration of automatic deletion for these orphaned entities with a configurable delay (in days) that prevents premature deletion and allows time for recovery or investigation.
+
+### Associating Cleanup with Synchronization Configurations
+
+Each cleanup job can target specific synchronization configurations, allowing granular control over which entity types or sync flows are cleaned up. The widget ensures validation so that sync configurations aren't duplicated across multiple cleanup jobs, preventing conflicting cleanup policies.
+
+## Design Considerations
+
+### When to Use This Widget
+
+- Setting up a new ECF connector and defining initial cleanup policies
+- Managing existing cleanup schedules for synchronized data
+- Troubleshooting orphaned entities in a synchronization setup
+- Adjusting cleanup timing or enabling/disabling cleanup jobs
+
+### Embedding Context
+
+This widget can only be embedded on Connector pages or Connector type definitions. It is typically part of a three-tab layout structure:
+
+- **Servers tab**: Server connection configurations
+- **Synchronization tab**: Synchronization configurations
+- **Cleanup tab**: Cleanup job configurations (this widget)
+
+The widget is usually displayed in a master-detail pattern with a connected attributes group showing detailed configuration of the selected cleanup job.
+
+### Configuration Elements
+
+Cleanup jobs are controlled by several key attributes:
+
+- **Enabled**: Boolean toggle to activate/deactivate cleanup execution
+- **Cron Expression**: Schedule definition (default: every 10 minutes)
+- **Synchronization Configurations**: Target sync configs for cleanup
+- **Delete Orphaned Target Entities**: Enable automatic orphan deletion
+- **Delete After Days**: Grace period before orphaned entities are removed
+
+## Common Pitfalls
+
+- Setting a cleanup schedule that's too frequent can impact system performance, especially for large datasets
+- Enabling orphaned entity deletion without an adequate grace period may result in unintended data loss
+- Forgetting to enable cleanup jobs after configuration leaves them inactive
+- Attempting to reference the same sync configuration in multiple cleanup jobs triggers validation errors
+
+## Related Patterns
+
+- **Server Connection Table Widget** - Manages server connections for the same connector
+- **Connector Sync Configs Table Widget** - Displays synchronization configurations that cleanup jobs reference
+- **Connected Attributes Group** - Typically used alongside this widget to show detailed configuration

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.cleanupConfigTable/_summary.md

@@ -0,0 +1 @@
+Displays a table of cleanup job configurations for managing automated data cleanup schedules tied to a specific ECF connector.

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.connectorSyncConfigsTable/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ecf.connector.extension.widget.connectorSyncConfigsTable",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Synchronization configurations\",\"de\":\"Konfigurationen für die Synchronisierung\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ecf",
+  "App": "cf.cplace.ecf.ecfCore",
+  "Localized App Name": "{\"en\":\"Enterprise Connectivity Foundation Core App\",\"de\":\"Enterprise Connectivity Foundation Core App\"}",
+  "Repository": "cplace-ecf",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.connectorSyncConfigsTable/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "table",
+    "searchable",
+    "selectable",
+    "connected",
+    "attributes",
+    "detail-view"
+  ],
+  "requiredApp": "cf.cplace.ecf.ecfCore"
+}

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.connectorSyncConfigsTable/_overview.md

@@ -0,0 +1,94 @@
+## Overview
+
+The Connector Sync Configs Table is a specialized widget within the Enterprise Connect Foundation (ECF) plugin that displays synchronization configurations belonging to a specific connector. This widget provides a dedicated table view for managing how data is synchronized between cplace and external systems.
+
+The widget is designed to be embedded exclusively on Connector pages and automatically displays all sync configurations where the `connector` attribute references the current connector page. Results are scoped to the embedding workspace and filtered by the ECF Sync Configuration type.
+
+## Use Cases
+
+### Managing Connector Synchronizations
+
+This widget is used when administrators and integration specialists need to:
+
+1. **View all sync configurations** for a specific external system connector at a glance
+2. **Monitor sync status** by seeing all synchronization rules in a centralized table
+3. **Select and edit** individual sync configurations using the master-detail UI pattern
+
+### Typical Workflow
+
+1. User navigates to a Connector page representing a connection to an external system
+2. User selects the "Synchronization" tab on the Connector page
+3. The widget displays all sync configurations in a sortable, filterable table format
+4. User selects a row to view or edit details in the adjacent Connected Attributes Group widget
+
+### When Would You Use This Widget?
+
+This widget is **not directly chosen by end users** during page layout design. It is a fixed component of the Connector page's "Synchronization" tab layout, automatically included in the default layout for Connector type pages.
+
+**Configuration and solution architects** would encounter this widget when:
+- Customizing the Connector type layout
+- Building ECF-based integration solutions
+- Setting up data synchronization between cplace and external systems
+
+## Design Considerations
+
+### Integration with Connector Tab Structure
+
+The Connector page type has three predefined tabs, each following a master-detail pattern:
+
+1. **Servers Tab**: Displays server connection configurations
+2. **Synchronization Tab**: Contains this widget showing sync configurations
+3. **Cleanup Tab**: Shows cleanup job configurations
+
+Each tab uses a 6/6 column layout with a table widget on the left and a Connected Attributes Group widget on the right for editing selected rows.
+
+### Master-Detail Pattern
+
+The widget works in conjunction with a Connected Attributes Group widget to enable:
+- **Row selection**: Users click a row in the table
+- **Detail viewing**: The selected sync configuration's attributes appear in the connected widget
+- **In-place editing**: Users can modify sync configuration properties without leaving the page
+
+### Automatic Search Construction
+
+Unlike general-purpose table widgets, this widget:
+- **Does not require explicit search filter configuration**: The search is dynamically constructed based on the embedding context
+- **Automatically filters by connector**: Only shows sync configurations linked to the current Connector page
+- **Enforces workspace scoping**: Results are limited to the embedding space
+
+### Fixed Configuration
+
+The widget has minimal configuration options:
+- No column configuration needed (uses platform defaults)
+- No search filter to define (automatically constructed)
+- Fixed embedding constraint (must be on a Connector page)
+
+## Related Patterns
+
+### Widget Family
+
+This widget is part of a family of connector-related table widgets that share the same base class:
+
+- **ServerConnectionTableWidgetDefinition**: Displays server connection configurations on the Servers tab
+- **ConnectorSyncConfigsTableWidgetDefinition**: Displays sync configurations (this widget) on the Synchronization tab
+- **CleanupConfigTableWidgetDefinition**: Displays cleanup job configurations on the Cleanup tab
+
+### Dependencies
+
+- **ECF Plugin** (`cf.cplace.ecf`): The Enterprise Connect Foundation plugin that provides ECF functionality
+- **GenericSearchAsTableWidgetDefinition**: Platform base class for search-driven table widgets
+- **ConnectedAttributesGroupWidgetDefinition**: Platform widget that displays selected row details for editing
+- **LayoutTabsWidget**: Provides the tabbed navigation structure on Connector pages
+
+### Type Dependencies
+
+- **Connector** (`cf.cplace.ecf.connector`): The page type this widget can be embedded on
+- **ECF Sync Configuration** (`cf.cplace.ecf.syncConfiguration`): The entity type displayed in the table
+
+## Alternatives
+
+For general-purpose table views of search results, consider:
+- **Embedded Search As Table** (`cf.platform.embeddedSearchAsTable`): General-purpose search-driven table widget with flexible configuration
+- **Table Widget** (`cf.cplace.platform.tableWidget`): Configurable table widget for displaying page collections
+
+This widget is specifically designed for ECF connector management and is not suitable as a general-purpose table widget for other use cases.

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.connectorSyncConfigsTable/_summary.md

@@ -0,0 +1 @@
+Displays a table of synchronization configurations associated with a specific connector, enabling users to view and manage data sync rules between cplace and external systems.

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.serverConnectionTable/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.ecf.connector.extension.widget.serverConnectionTable",
+  "Description": null,
+  "Localized Name": "{\"en\":\"Server connection configurations\",\"de\":\"Serververbindungskonfigurationen\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.ecf",
+  "App": "cf.cplace.ecf.ecfCore",
+  "Localized App Name": "{\"en\":\"Enterprise Connectivity Foundation Core App\",\"de\":\"Enterprise Connectivity Foundation Core App\"}",
+  "Repository": "cplace-ecf",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.serverConnectionTable/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "table",
+    "inline-edit",
+    "selectable",
+    "detail-view",
+    "connected"
+  ],
+  "requiredApp": "cf.cplace.ecf.ecfCore"
+}

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.serverConnectionTable/_overview.md

@@ -0,0 +1,28 @@
+## Overview
+
+The Server Connection Table Widget displays and manages external server connection configurations belonging to a Connector page. It enables administrators to configure connections to external systems (such as Jira, SAP, or other enterprise platforms) that cplace synchronizes data with through the Enterprise Connectivity Foundation (ECF).
+
+The widget shows server connections in a table format, where each row represents a connection with its URL, authentication method (basic authentication or bearer token), and enabled status. It works in a master-detail pattern with a Connected Attributes Group widget for editing selected connections.
+
+**Important:** This widget can only be embedded on Connector pages (`cf.cplace.ecf.connector`). Attempting to embed it elsewhere will result in an error.
+
+## Use Cases
+
+- **Configure External System Connections**: Set up connections to systems like Jira, SAP, or custom APIs that cplace needs to synchronize with
+- **Manage Multiple Server Instances**: A single connector can have connections to multiple servers (e.g., development, staging, production environments)
+- **Set Up Authentication**: Configure credentials using basic authentication (username/password) or bearer tokens
+- **Enable/Disable Connections**: Quickly toggle connections on/off without deleting the configuration
+
+## Design Considerations
+
+This widget is part of the Enterprise Connectivity Foundation (ECF) plugin and is designed to be used within a tabbed layout on Connector pages. The default layout places the Server Connection Table Widget alongside a Connected Attributes Group Widget in a master-detail arrangement, where selecting a row in the table displays editable details in the adjacent widget.
+
+Server connection configurations are validated to ensure:
+- URLs use the `https://` protocol
+- Username is provided when using basic authentication
+- Connections can be live-tested against target servers
+
+## Alternatives
+
+- **Connected Attributes Group Widget**: Used together with this widget to display editable details of selected server connections
+- **Generic Search as Table Widget**: The base table widget that this specializes; use the generic version for custom table displays not specific to server connections

package/dist/widget-specifications/cf.cplace.ecf.connector.extension.widget.serverConnectionTable/_summary.md

@@ -0,0 +1 @@
+A table widget that displays server connection configurations for a Connector, enabling administrators to manage credentials and settings for external system integrations.

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

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

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

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

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

@@ -0,0 +1,116 @@
+## Overview
+
+The Extended Tree Table Widget is a table with tree functionality that visualizes hierarchical relationships between pages in a table format with tree navigation. It excels at displaying complex hierarchies where different page types are organized in parent-child relationships, showing their attributes in configurable columns while handling cross-type scenarios gracefully.
+
+Unlike simple hierarchical views, this widget supports dynamic hierarchy construction based on search criteria, configurable reference attributes that define parent-child relationships, and visual distinction for attributes that don't apply to certain types in the hierarchy.
+
+## Use Cases
+
+### Multi-Type Hierarchical Structures
+
+The widget is ideal for displaying complex hierarchies where different page types are organized in parent-child relationships:
+
+- **Project Management**: Program -> Project -> Task -> Subtask
+- **Product Structures**: Product Line -> Product -> Component -> Part
+- **Organizational Structures**: Division -> Department -> Team -> Individual
+- **Document Hierarchies**: Category -> Document -> Section -> Paragraph
+
+Each level in the hierarchy can be a different type, with different attributes, and the widget displays all relevant attributes across all types in a unified view.
+
+### Cross-Type Relationship Visualization
+
+When pages of different types form a hierarchy, attributes may not apply to all types. The widget handles this elegantly by:
+- Displaying all attributes from all types in the hierarchy
+- Using a configurable color (default gray) for cells where an attribute doesn't apply to a page's type
+- Allowing users to see the complete picture across heterogeneous hierarchies without confusion
+
+### Dynamic Hierarchy Construction
+
+Unlike widgets with fixed hierarchies, this widget can:
+- Use search filters to determine which pages participate in the hierarchy
+- Select specific reference attributes that define parent-child relationships
+- Support multiple incoming reference types (e.g., a child can have different parent types)
+- Construct hierarchies on-the-fly based on user selection or search criteria
+
+### Connected Widget Scenarios
+
+The widget can interact with other widgets on the page for coordinated behavior:
+- **Single Selection Widget Integration**: Display hierarchy starting from a selected page
+- **Dynamic Root Node**: The hierarchy root can be determined by another widget's selection
+- **Coordinated Filtering**: Multiple widgets can share context and filter data together
+
+## Operating Modes
+
+### Standalone Mode
+The widget displays a hierarchy rooted at the embedding page or a configured root node. Users can explore the full tree structure with expand/collapse controls and filter by column values.
+
+### Connected Mode
+The widget's root node is determined by a selection in another widget (e.g., a single selection widget). As the user changes selection in the connected widget, the hierarchy updates dynamically.
+
+The widget uses a clear priority order when determining the hierarchy root:
+1. **Connected Table Selection** (highest priority) - Root from another widget's selection
+2. **Configured Root Node** (medium priority) - Explicit page reference in widget configuration
+3. **Embedding Page** (fallback) - The page where the widget is embedded
+
+### Search-Based Mode
+The widget uses search specifications to determine which pages participate in the hierarchy, allowing for dynamic filtering of the tree based on page properties beyond just the hierarchical relationships.
+
+## Design Considerations
+
+### When to Use This Pattern
+
+Use the Extended Tree Table Widget when:
+- You need to visualize hierarchical relationships with attribute details
+- Your hierarchy spans multiple types with different attribute sets
+- You want users to filter, sort, or search within the hierarchy
+- You need dynamic hierarchy construction based on search criteria
+- You want to integrate hierarchy visualization with other widgets
+
+### When to Consider Alternatives
+
+Consider other widgets when:
+- Simple list or table view is sufficient (use Search as Table Widget)
+- You don't need hierarchical navigation (use Table Widget)
+- You only need to display a single type (simpler table widgets may suffice)
+- You need specialized tree visualizations (consider custom tree widgets)
+
+### Configuration Complexity
+
+The widget requires careful configuration of:
+- Reference attributes that define parent-child relationships (ATTRIBUTES configuration)
+- Search specifications to filter participating pages
+- Column configuration for attribute display
+- Root node determination (embedded page, configured node, or connected widget)
+- Default expansion depth based on hierarchy breadth and depth
+
+Plan the hierarchy structure and reference attributes before configuring the widget.
+
+### Default Expansion Depth Strategy
+
+Consider the appropriate initial expansion depth based on your hierarchy characteristics:
+- **Low depth (0-1)**: Best for broad hierarchies with many children per parent; users explore on demand
+- **Medium depth (2-3)**: Balances immediate context with manageable visual complexity
+- **High depth (4+)**: Suitable for narrow or shallow hierarchies where showing the full structure is valuable
+
+## Common Pitfalls
+
+- **Missing Reference Attribute Configuration**: The ATTRIBUTES configuration must define all parent-child relationship paths. Missing entries result in broken hierarchy paths.
+- **Search Filter Too Restrictive**: If the search filter excludes pages that should be in the hierarchy, they won't appear even if correctly referenced.
+- **Color Confusion**: In multi-type hierarchies, gray cells indicate non-applicable attributes. Users unfamiliar with this pattern may think data is missing.
+- **Default Depth**: If not configured, only the first level expands by default. Consider setting DEFAULT_DEPTH based on typical hierarchy depth.
+- **Root Node Ambiguity**: Without clear documentation, users may not understand whether the widget uses the embedding page, configured root, or connected selection as the starting point.
+
+## Related Patterns
+
+- **TreeTableWidget** (platform base widget): Abstract base class this widget extends
+- **Search as Table Widget** (`cf.platform.embeddedSearchAsTable`): For non-hierarchical tabular data display
+- **Single Selection Widget**: Often used to provide dynamic root selection for this widget
+- **Table Widget** (platform): For simpler table displays without tree navigation
+
+## Technical Notes
+
+- Extends the platform's `TreeTableWidgetDefinition`
+- Pure backend implementation (Java) with no frontend assets
+- Hierarchy construction uses search-based child discovery
+- Supports column-level filtering that persists in widget state
+- Default non-relevant cell color: #BEBEBE (configurable)

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

@@ -0,0 +1 @@
+A table with tree functionality that displays hierarchical page structures in a table format with support for multi-type hierarchies, dynamic search-based filtering, and configurable parent-child relationships.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.horizontalDivider",
+  "Description": "{\"en\":\"Horizontal divider\",\"de\":\"Horizontaler Trenner\"}",
+  "Localized Name": "{\"en\":\"Horizontal Divider\",\"de\":\"Horizontaler Trenner\"}",
+  "Icon": "fa-horizontal-rule",
+  "Plugin": "cf.cplace.formsWizard",
+  "App": "cf.cplace.formsWizard",
+  "Localized App Name": "{\"en\":\"Forms Wizard\",\"de\":\"Forms Wizard\"}",
+  "Repository": "cplace-forms-wizard",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.formsWizard.horizontalDivider/_meta.json

@@ -0,0 +1,8 @@
+{
+  "tags": [
+    "form",
+    "read-only",
+    "detail-view"
+  ],
+  "requiredApp": "cf.cplace.formsWizard"
+}

package/dist/widget-specifications/cf.cplace.formsWizard.horizontalDivider/_overview.md

@@ -0,0 +1,44 @@
+## Overview
+
+The Horizontal Divider widget is a horizontal divider that renders a horizontal line (`<hr>` HTML element) to create visual separation between groups of attributes or form sections. It is designed exclusively for use within Attributes Group widgets as part of the Forms Wizard plugin.
+
+This widget has no configurable properties - it provides pure presentational functionality with zero configuration overhead. The divider uses standard HTML and inherits styling from the application theme.
+
+## Use Cases
+
+### Sectioning Forms Wizard Steps
+When configuring Forms Wizard steps, the horizontal divider helps organize attributes into logical sections. For example, separating general step information (name, title, description) from navigation settings (step type, next step, skip options).
+
+### Visual Grouping in Complex Forms
+In type definitions or page layouts with many attributes, the horizontal divider creates visual breaks to improve form readability and user comprehension without requiring separate widget sections.
+
+### Logical Separation in Configuration Pages
+For administrative or configuration interfaces where different categories of settings need to be distinguished visually (e.g., required settings vs. optional settings).
+
+### When NOT to Use
+- For functional separation requiring different widgets (use multiple Attributes Group widgets instead)
+- For interactive or collapsible sections (use appropriate container widgets)
+- When you need styled or customizable dividers (this renders a plain HTML `<hr>`)
+- Outside of Attributes Group widgets (the widget is restricted to this context)
+
+## Design Considerations
+
+The Horizontal Divider widget is intentionally minimal:
+- **No configurable attributes** - immediate usability with zero learning curve
+- **No styling options** - consistent appearance across all forms
+- **No interactive behavior** - pure presentation without complexity
+- **Embedding restriction** - must be placed inside an Attributes Group widget
+
+**Best Practices:**
+- Use sparingly to avoid interface clutter
+- Group 3-7 related attributes before adding a divider
+- Combine with descriptive attribute labels for section clarity
+- Consider using multiple Attributes Group widgets for major section breaks
+
+## Alternatives
+
+| Widget | When to Use Instead |
+|--------|---------------------|
+| Multiple Attributes Group widgets | For major section breaks requiring distinct visual containers |
+| Rich String widget | When section headers with text labels are needed |
+| Collapsible containers | For sections that users may want to expand/collapse |

package/dist/widget-specifications/cf.cplace.formsWizard.horizontalDivider/_summary.md

@@ -0,0 +1 @@
+A horizontal divider that renders a horizontal line to create visual separation between groups of attributes within an Attributes Group widget.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.startWizardWidget",
+  "Description": "{\"en\":\"A widget to start a wizard\",\"de\":\"Ein Widget zum Starten eines Forms Wizards\"}",
+  "Localized Name": "{\"en\":\"Start Wizard\",\"de\":\"Forms Wizard starten\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.formsWizard",
+  "App": "cf.cplace.formsWizard.formsWizardExecution",
+  "Localized App Name": "{\"en\":\"Forms Wizard Launcher\",\"de\":\"Forms Wizard Launcher\"}",
+  "Repository": "cplace-forms-wizard",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.formsWizard.startWizardWidget/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "form",
+    "references",
+    "searchable",
+    "connected",
+    "low-code"
+  ],
+  "requiredApp": "cf.cplace.formsWizard.formsWizardExecution"
+}

package/dist/widget-specifications/cf.cplace.formsWizard.startWizardWidget/_overview.md

@@ -0,0 +1,40 @@
+## Overview
+
+The Start Wizard Widget is a widget to start a wizard. It provides an entry point to launch Forms Wizards from within pages, type layouts, or rich strings. It renders as an interactive button that, when clicked, opens a configured multi-step wizard interface for guided data entry, page creation, or business process workflows.
+
+The widget bridges page context with wizard execution, passing information about the embedding entity, workspace, and optionally selected data from connected tables to the wizard.
+
+## Use Cases
+
+- **Guided Page Creation**: Replace standard page creation dialogs with multi-step wizards that include validation, conditional logic, and structured data entry
+- **Batch Operations from Tables**: Launch wizards to process selected rows from a connected table widget, enabling bulk updates or data enrichment
+- **Contextual Actions**: Embed within specific page types to create related entities with pre-filled context from the parent page
+- **External Data Collection**: Enable external users to submit structured data through wizard interfaces with optional CAPTCHA protection
+- **Multi-Step Business Processes**: Implement complex workflows spanning multiple forms with conditional branching based on user input
+- **Conditional Form Availability**: Use scripts to show/hide or enable/disable the button based on permissions, page state, or business rules
+
+## Design Considerations
+
+### Data Source Options
+
+The widget supports three mutually exclusive approaches for providing data to the wizard:
+
+1. **Search**: Execute a saved search to provide pages to the wizard
+2. **Connected Table**: Reference a table widget on the same page, optionally using selected rows
+3. **Explicit Selection**: Manually specify pages to pass to the wizard
+
+Choose the approach based on whether data should be dynamic (search), user-selected (connected table), or predetermined (explicit selection).
+
+### Post-Completion Behavior
+
+The widget can refresh either the embedding page or a specific connected table after wizard completion. This ensures users see updated data reflecting changes made during the wizard flow.
+
+### Conditional Button Behavior
+
+Low-Code scripts can dynamically control button visibility, enabled state, and tooltip text based on page attributes, user permissions, or business rules. This enables sophisticated conditional logic without creating multiple widget configurations.
+
+## Related Patterns
+
+- **Forms Wizard (Page Type)**: `cf.cplace.formsWizard.wizard` - Defines the wizard structure, steps, and logic that this widget launches
+- **Connected Table Widgets**: Can provide selected data to the wizard and be refreshed after completion
+- **Low-Code Button Widget**: For simpler action buttons that execute scripts directly rather than launching wizards

package/dist/widget-specifications/cf.cplace.formsWizard.startWizardWidget/_summary.md

@@ -0,0 +1 @@
+A widget to start a wizard that provides a button to launch multi-step Forms Wizards for guided page creation or data collection workflows. Supports integration with connected tables and conditional visibility via Low-Code scripts.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.stepEditorForWizardWidget",
+  "Description": "{\"en\":\"Editor widget for the quick configuration of a step\",\"de\":\"Editor-Widget für die Schnellkonfiguration eines Schrittes\"}",
+  "Localized Name": "{\"en\":\"Step Editor for Forms Wizards\",\"de\":\"Schritt-Editor für Wizards\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.formsWizard",
+  "App": "cf.cplace.formsWizard",
+  "Localized App Name": "{\"en\":\"Forms Wizard\",\"de\":\"Forms Wizard\"}",
+  "Repository": "cplace-forms-wizard",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.formsWizard.stepEditorForWizardWidget/_meta.json

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

package/dist/widget-specifications/cf.cplace.formsWizard.stepEditorForWizardWidget/_overview.md

@@ -0,0 +1,47 @@
+## Overview
+
+The Step Editor for Forms Wizards widget is an editor widget for the quick configuration of a step. It serves as a contextual step configuration tool embedded in Wizard pages. It responds to step selection events from the Wizard Step Manager table widget and displays editable fields for the selected step, including Title, Description, and Next Step references. The widget dynamically loads the appropriate editor component based on the step type (Form, Table, Decision, Info, Script) and enforces editing constraints when the wizard is active or when the user lacks write permissions.
+
+Use this widget when you need to configure individual wizard steps without navigating away from the main Wizard page context.
+
+## Use Cases
+
+### Primary Use Case: Wizard Design & Configuration
+
+When designing or modifying a Forms Wizard and needing to configure individual steps:
+
+1. User opens a Wizard page
+2. User selects a step in the Wizard Step Manager table
+3. This widget automatically displays the selected step's configuration
+4. User edits step properties (title, description, next steps, type-specific settings)
+5. User clicks Save to persist changes
+
+### Specific Scenarios
+
+- **Creating a new wizard flow**: Configure each step's content, navigation, and behavior as you build the wizard
+- **Modifying existing steps**: Update form fields, table columns, or decision options for existing steps
+- **Adjusting step flow**: Change the "Next" step references to modify the wizard navigation path
+- **Localizing wizard content**: Edit step titles and descriptions in different languages
+
+## Design Considerations
+
+This widget is part of a coordinated widget ecosystem on Wizard pages:
+
+| Widget | Purpose |
+|--------|---------|
+| **Wizard Analysis Widget** (`cf.cplace.formsWizard.wizardAnalysis`) | Provides overview/validation of the wizard |
+| **Wizard Step Manager Widget** (`cf.cplace.formsWizard.stepManager`) | Displays/manages the list of steps (table) |
+| **Step Editor for Wizard Widget** (this widget) | Edits the currently selected step |
+
+The widget relies on event communication from the Wizard Step Manager widget to know which step is selected. It can only be embedded on pages of type `cf.cplace.formsWizard.wizard`.
+
+### Editing Constraints
+
+- **Read-only when wizard is active**: Cannot edit steps while the wizard is deployed
+- **Read-only without write permission**: Respects cplace permission model
+- **Single-step editing**: Only one step can be edited at a time
+
+## Alternatives
+
+- **Step Editor Widget** (`cf.cplace.formsWizard.stepEditorWidget`): Similar functionality but embedded on Step pages directly, not Wizard pages. Use this when you want to edit a step from its own detail page rather than from the parent Wizard page.
+- **Step Preview Widget** (`cf.cplace.formsWizard.stepPreviewWidget`): Shows how the step will appear to end users. Use this when you need to preview the step rather than edit it.

package/dist/widget-specifications/cf.cplace.formsWizard.stepEditorForWizardWidget/_summary.md

@@ -0,0 +1 @@
+An editor widget for the quick configuration of a step that provides inline editing capabilities for wizard steps directly from the Wizard page, enabling quick configuration of step content without navigating away from the wizard context.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.stepEditorWidget",
+  "Description": "{\"en\":\"Editor widget for the configuration of a step\",\"de\":\"Editor-Widget für die Konfiguration eines Schrittes\"}",
+  "Localized Name": "{\"en\":\"Step Editor\",\"de\":\"Schritt-Editor\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.formsWizard",
+  "App": "cf.cplace.formsWizard",
+  "Localized App Name": "{\"en\":\"Forms Wizard\",\"de\":\"Forms Wizard\"}",
+  "Repository": "cplace-forms-wizard",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.formsWizard.stepEditorWidget/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "form",
+    "inline-edit",
+    "detail-view",
+    "low-code"
+  ],
+  "requiredApp": "cf.cplace.formsWizard"
+}