@cplace/test-mcp-server 0.1.15 → 1.1.0

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

@@ -0,0 +1,23 @@
+## Overview
+
+The Step Editor widget is an editor widget for the configuration of a step. It serves as a standalone step configuration tool embedded on Step pages. It automatically binds to the embedding Step page, dynamically loads the appropriate editor component based on the step type (Form, Table, Decision, Info, Script), and provides editing controls for configuring step-specific settings. The widget enforces editing constraints based on wizard activation state and user permissions.
+
+## Use Cases
+
+- **Direct Step Configuration**: When working on a specific Step page and needing to configure its detailed settings
+- **Designing form step fields**: Configure which attributes to display, layout (one/two column), field order, and validation rules
+- **Setting up table step columns**: Define which columns to show in a table step and their configuration
+- **Configuring decision step options**: Set up branching logic and decision options
+- **Customizing info step content**: Design informational content display
+- **Developing script step logic**: Write and test server-side scripts for custom behavior
+
+## Design Considerations
+
+- The widget can ONLY be embedded on pages of type `cf.cplace.formsWizard.step`
+- Editing is disabled when the parent wizard is active/deployed or when the user lacks write permissions
+- The widget dynamically loads step-type-specific editors, making it extensible for custom step types
+- Typically paired with an Attributes Widget (for step metadata) and Step Preview Widget (for visual preview)
+
+## Alternatives
+
+- **Step Editor for Wizard Widget** (`cf.cplace.formsWizard.stepEditorForWizardWidget`): Use when you want quick editing while maintaining wizard overview on Wizard pages. It requires manual step selection from a table and shows basic attributes inline, whereas the Step Editor Widget automatically binds to the Step page and provides focused, deep editing of a single step.

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

@@ -0,0 +1 @@
+An editor widget for the configuration of a step that provides a dedicated editing interface for configuring individual wizard steps directly on Step pages, enabling detailed customization of step content, behavior, and type-specific settings.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.stepManager",
+  "Description": "{\"en\":\"Overview widget of all existing Forms Wizard steps\",\"de\":\"Übersichts-Widget über alle vorhandenen Forms-Wizard-Schritte\"}",
+  "Localized Name": "{\"en\":\"Step Manager\",\"de\":\"Schritt-Manager\"}",
+  "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.stepManager/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "table",
+    "metadata",
+    "sortable",
+    "selectable",
+    "detail-view"
+  ],
+  "requiredApp": "cf.cplace.formsWizard"
+}

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

@@ -0,0 +1,32 @@
+## Overview
+
+The Step Manager widget is an overview widget of all existing Forms Wizard steps. It serves as the central management interface for Forms Wizard administrators to view, organize, and manage the complete list of steps that make up a wizard. It provides a sortable, actionable table view that shows key information about each step, helping administrators understand the wizard's structure at a glance and perform step lifecycle operations.
+
+The widget displays a table with six columns: Name (clickable link to step configuration), Identifier, Type (Form, Script, Info, Summary, Table), Configuration Complete (visual indicator), Created At (timestamp), and Order in Wizard (position in execution flow). It also provides buttons for creating new steps and deleting selected steps.
+
+This widget can only be embedded on pages of type `cf.cplace.formsWizard.wizard` (Forms Wizard configuration pages).
+
+## Use Cases
+
+- **Step Inventory and Organization**: View all steps in a wizard with their names, types, and execution order to understand the wizard's structure
+- **Configuration Monitoring**: Identify steps with incomplete configurations using the visual indicator before activating a wizard
+- **Creating New Steps**: Add new steps to a wizard using the "Create Step" button, which pre-fills wizard context automatically
+- **Removing Obsolete Steps**: Delete steps that are no longer needed using the "Delete step" action with confirmation
+- **Understanding Flow Sequence**: Review the "Order in Wizard" column to visualize the navigation flow and identify unreachable steps
+- **Quick Navigation**: Click step names to navigate directly to step configuration pages
+- **Step Type Overview**: Assess the mix of step types (Form, Script, Info, Summary) in the wizard
+- **Tracking Step Creation**: Use creation timestamps for auditing or troubleshooting
+
+## Design Considerations
+
+The Step Manager widget is designed to work in conjunction with other Forms Wizard widgets on a wizard configuration page:
+
+- **Wizard Analysis Widget**: The "Configuration Complete" indicator references the Analysis widget for detailed validation messages. Use both widgets together to ensure proper step configuration.
+- **Real-Time Updates**: The widget automatically refreshes when step relationships change or wizard activation state changes, ensuring the table always shows current data.
+- **Permission-Aware**: Buttons and actions only appear for users with edit permissions on the wizard.
+
+## Alternatives
+
+- **Wizard Analysis Widget** (`cf.cplace.formsWizard.wizardAnalysis`): For detailed validation feedback on step configurations rather than table overview
+- **Step Editor for Wizard Widget** (`cf.cplace.formsWizard.stepEditorForWizardWidget`): For inline step editing embedded on wizard pages
+- **Step Editor Widget** (`cf.cplace.formsWizard.stepEditorWidget`): For configuring individual step properties on dedicated step pages

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

@@ -0,0 +1 @@
+An overview widget of all existing Forms Wizard steps that provides a comprehensive table overview, displaying step metadata, configuration status, and execution order while enabling administrators to create new steps and delete existing ones.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.stepPreview",
+  "Description": "{\"en\":\"Preview widget that shows the step that is currently being configured\",\"de\":\"Vorschau-Widget, das den Schritt anzeigt, der gerade konfiguriert wird\"}",
+  "Localized Name": "{\"en\":\"Step Preview\",\"de\":\"Schritt-Vorschau\"}",
+  "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.stepPreview/_meta.json

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

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

@@ -0,0 +1,29 @@
+## Overview
+
+The Step Preview Widget is a preview widget that shows the step that is currently being configured. It provides a live, dynamic preview of individual wizard steps during the configuration phase. It fetches step data from the backend, renders the appropriate step view based on the step type (Form, Info, Decision, Table, Script), and auto-updates when step configuration changes. This widget can only be embedded on Step pages of type `cf.cplace.formsWizard.step`.
+
+Use this widget when configuring Forms Wizard steps to see exactly how the step will appear to end users before activating the wizard. The widget requires minimal configuration as it automatically determines which step to preview based on the embedding page.
+
+## Use Cases
+
+**Step Configuration Preview**: Administrators see a live preview while configuring individual steps of a Forms Wizard. As they edit step configuration using the Step Editor Widget, the preview automatically updates to reflect changes, allowing verification of layout, attribute placement, and appearance before saving.
+
+**Multi-Step Type Support**: The widget supports previewing different step types including Form steps (shows form fields and layout), Info steps (shows informational text), Decision steps (shows decision options and buttons), and Table steps (shows table configuration). Script steps display a "This step does not have a view" message since they require no user interaction.
+
+**Configuration Validation**: Administrators can catch configuration issues early by visually inspecting the preview. Missing attributes, duplicate configurations, or invalid selections are immediately visible in the preview state.
+
+## Design Considerations
+
+The Step Preview Widget is part of a cohesive step configuration experience and works together with several related widgets:
+
+- **Step Editor Widget** (`cf.cplace.formsWizard.stepEditor`): Placed above the preview in the Step page layout, provides the configuration UI. When configuration changes, it triggers an event that the preview listens to for automatic updates.
+
+- **Step Editor for Wizard Widget** (`cf.cplace.formsWizard.stepEditorForWizard`): A quick editor embedded on Wizard pages that also works with the preview widget.
+
+- **Step Manager Widget** (`cf.cplace.formsWizard.stepManager`): Lists all steps in a wizard. Users navigate from here to individual Step pages where the preview is shown.
+
+The widget is pre-configured in the default layout for Step pages, positioned in the bottom-left section (6-column width) below the Step Editor Widget.
+
+## Alternatives
+
+There are no direct alternatives for this widget within the Forms Wizard context. The Step Preview Widget is the designated tool for previewing step configurations during the wizard design phase.

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

@@ -0,0 +1 @@
+A preview widget that shows the step that is currently being configured, displaying how a Forms Wizard step will appear to end users during wizard execution while it is being configured by an administrator.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.wizardActivation",
+  "Description": "{\"en\":\"Enables the deactivation/activation of a Forms Wizard\",\"de\":\"Ermöglicht die Deaktivierung/Aktivierung eines Forms Wizards\"}",
+  "Localized Name": "{\"en\":\"Wizard Activation\",\"de\":\"Wizard-Aktivierung\"}",
+  "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.wizardActivation/_meta.json

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

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

@@ -0,0 +1,69 @@
+## Overview
+
+The Wizard Activation widget enables the deactivation/activation of a Forms Wizard. It provides a simple interface for administrators to control the availability of Forms Wizards. It displays either an "Activate" or "Deactivate" button depending on the wizard's current state, allowing administrators to toggle whether end users can start new wizards or continue existing wizard instances.
+
+The widget implements important safety checks before allowing activation, including configuration validation and permission verification. Deactivation requires explicit confirmation to prevent accidental disruption of user workflows.
+
+## Use Cases
+
+### Wizard Lifecycle Management
+
+Administrators use this widget to control Forms Wizard availability throughout its lifecycle:
+
+- **During Configuration**: Keep the wizard inactive while configuring steps, transitions, and localization to prevent users from accessing incomplete wizards
+- **Pre-Activation Validation**: Verify all configuration is valid using the Wizard Analysis widget before enabling the wizard
+- **Activation**: Once fully configured and validated, activate the wizard to make it available to end users
+- **Maintenance**: Deactivate the wizard when changes are needed or to temporarily disable it without deleting configuration
+- **Retirement**: Deactivate wizards that are no longer needed while preserving historical data
+
+### Typical Workflow
+
+1. Administrator creates a new Forms Wizard page (inactive by default)
+2. Administrator configures wizard steps, transitions, and settings using other widgets
+3. Administrator reviews the Wizard Analysis widget to check for configuration issues
+4. Once all validation checks pass, the Activate button becomes enabled
+5. Administrator clicks Activate to make the wizard available to end users
+6. If changes are needed later, administrator clicks Deactivate (with confirmation) to modify the wizard safely
+
+## Design Considerations
+
+### Activation States
+
+The widget manages two mutually exclusive states:
+- **ACTIVE**: The wizard is available for use by end users who can start new instances and continue existing ones
+- **INACTIVE**: The wizard is disabled; users cannot start new instances or continue existing ones
+
+### Configuration Validation
+
+Before allowing activation, the widget enforces strict validation:
+- Consults the Wizard Analysis Service to verify complete and valid configuration
+- Disables the Activate button if configuration is incomplete or invalid
+- Displays an explanatory message directing administrators to the Wizard Analysis widget for details
+
+### Safety Mechanisms
+
+The widget implements several safety features:
+- **Confirmation Dialog**: Deactivation requires explicit confirmation with a warning that users can neither start new wizards nor continue existing ones
+- **Permission Check**: Only allows state changes if the user has edit permissions on the wizard page
+- **Automatic Refresh**: Listens for configuration change events and updates the activation state automatically when step relationships or configurations are modified
+
+### Embedding Constraints
+
+This widget can only be embedded on pages of type `cf.cplace.formsWizard.wizard`. Attempting to embed it on other page types will fail validation.
+
+## Related Widgets
+
+This widget is typically used alongside other Forms Wizard widgets on a wizard configuration page:
+
+- **Wizard Analysis Widget** (`cf.cplace.formsWizard.wizardAnalysis`): Validates wizard configuration and determines whether activation is allowed; provides detailed information about configuration issues
+- **Step Manager Widget** (`cf.cplace.formsWizard.stepManager`): Manages the list of wizard steps
+- **Wizard Localizations Widget** (`cf.cplace.formsWizard.wizardLocalizations`): Configures multi-language support for wizard interface elements
+- **Step Editor Widgets**: Configure individual step properties, transitions, and behaviors
+
+The widget automatically refreshes when these related widgets make changes that affect wizard configuration validity.
+
+## Common Pitfalls
+
+- **Activating without validation**: Attempting to activate a wizard without first resolving all configuration issues will fail; always check the Wizard Analysis widget first
+- **Missing deactivation confirmation**: Users may be surprised by the confirmation dialog when deactivating; this is intentional to prevent accidental disruption of active wizard instances
+- **Permission confusion**: If the Activate/Deactivate button is not visible, check that the current user has edit permissions on the wizard page

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

@@ -0,0 +1 @@
+Enables the deactivation/activation of a Forms Wizard, allowing administrators to activate or deactivate wizards based on configuration validation and controlling whether end users can start new wizards or continue existing instances.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.wizardAnalysis",
+  "Description": "{\"en\":\"This widget checks whether the Forms Wizard has all the necessary configurations to be able to run.\",\"de\":\"Dieses Widget prüft, ob der Forms Wizard über alle erforderlichen Konfigurationen verfügt, um ausgeführt werden zu können.\"}",
+  "Localized Name": "{\"en\":\"Forms Wizard Analysis\",\"de\":\"Forms-Wizard-Analyse\"}",
+  "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.wizardAnalysis/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "read-only",
+    "list",
+    "metadata",
+    "detail-view",
+    "dashboard"
+  ],
+  "requiredApp": "cf.cplace.formsWizard"
+}

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

@@ -0,0 +1,91 @@
+## Overview
+
+The Forms Wizard Analysis widget checks whether the Forms Wizard has all the necessary configurations to be able to run. It serves as a validation and quality assurance tool for Forms Wizard administrators. It automatically analyzes wizard configuration and displays validation results, highlighting both successful checks and potential problems that could prevent the wizard from functioning correctly. The widget helps administrators catch configuration errors early in the wizard design process and provides real-time feedback as configuration changes are made.
+
+The widget can only be embedded on pages of type `cf.cplace.formsWizard.wizard` (the Forms Wizard configuration page).
+
+## Validation Checks
+
+The widget performs seven core validation checks:
+
+1. **Start Step Validation** - Verifies a start step is configured
+2. **Step Reachability** - Ensures all configured steps can be reached during wizard execution
+3. **Final Step Validation** - Confirms at least one final step is configured
+4. **Leaf Node Validation** - Checks that all steps without next steps are marked as final steps
+5. **Final Step Integrity** - Verifies that final steps do not have next steps configured
+6. **External Access Configuration** - Validates external access settings when the wizard is configured for external use
+7. **Skip Configuration Validation** - Validates "skip to" step configurations
+
+Results display in a list format with visual indicators showing valid checks (styled with `valid` CSS class) and invalid checks (styled with `invalid` CSS class).
+
+## Use Cases
+
+### Wizard Configuration Validation
+
+An administrator configuring a new Forms Wizard to guide users through a multi-step process (e.g., employee onboarding, project approval, or data collection) places the widget on the wizard's configuration page. As they configure steps and navigation, the widget continuously validates the setup and immediately highlights any structural issues such as missing start steps, disconnected steps, final steps with incorrect next steps, or missing final step definitions.
+
+### Pre-Activation Quality Check
+
+Before activating a wizard and making it available to end users, an administrator reviews the widget to verify all validation checks pass. This prevents activating a broken wizard that could fail to start due to missing start steps, trap users in unreachable steps, have incomplete navigation flows, or lack proper completion endpoints.
+
+### Troubleshooting Wizard Issues
+
+When a wizard is not working as expected, administrators add or review the widget to diagnose structural issues. The detailed error messages pinpoint exactly which steps or configurations are problematic, such as "Some steps are not reachable (not reachable steps: EmployeeReview, FinalApproval)" or "Some final steps have next steps (final steps with next steps: SubmissionComplete)".
+
+### External Wizard Configuration
+
+When setting up a wizard for external users (non-authenticated users or users from external systems), the widget validates that external access is properly configured, ensuring an external access user is set when required. This prevents runtime errors when external users attempt to execute the wizard.
+
+### Complex Navigation Validation
+
+For wizards with conditional branching, skip logic, or complex navigation paths between steps, the widget validates that all navigation configurations are valid, ensuring skip configurations point to valid steps, all paths eventually lead to a final step, and no circular references or infinite loops exist in the navigation.
+
+### Wizard Maintenance and Updates
+
+When updating an existing wizard by adding new steps or modifying the navigation flow, the widget provides continuous validation feedback during modifications, helping administrators maintain a valid configuration throughout the update process. This is especially valuable when reorganizing steps or changing the navigation structure.
+
+## Design Considerations
+
+### When to Use This Widget
+
+Always include the Forms Wizard Analysis widget on wizard configuration pages to provide continuous validation feedback. It should be a standard component of the wizard configuration interface, typically used alongside the Wizard Activation widget to create a complete configuration and activation workflow.
+
+### Real-Time Updates
+
+The widget automatically refreshes its analysis when step relationships are modified, step configurations are updated, or the wizard configuration changes. This provides immediate feedback during the configuration process without requiring manual refresh actions.
+
+### Error Prevention
+
+The widget helps prevent common wizard configuration errors including:
+- **Structural errors**: Missing start/end points, disconnected steps
+- **Navigation errors**: Invalid skip configurations, unreachable steps
+- **Logic errors**: Final steps with next steps, non-final leaf nodes
+- **Access errors**: Missing external access configuration
+
+## Common Pitfalls
+
+- **Ignoring partial validation success**: Even if some checks pass, address all validation errors before making the wizard available to users
+- **Activating before validation**: Never activate a wizard for end users without reviewing the widget's output and ensuring all validations pass
+- **Not monitoring after changes**: After modifying an existing wizard, always review the analysis results to ensure changes didn't introduce new issues
+
+## Related Widgets
+
+### Wizard Configuration Widget Set
+
+The Forms Wizard Analysis widget is part of a comprehensive widget ecosystem for configuring and managing Forms Wizards:
+
+- **Wizard Activation Widget** (`cf.cplace.formsWizard.wizardActivation`) - Controls wizard activation state, typically used alongside the Analysis widget to prevent activation when analysis shows invalid configuration
+- **Step Manager Widget** (`cf.cplace.formsWizard.stepManager`) - Manages the list of wizard steps, creates, edits, and orders steps in the wizard flow
+- **Wizard Localizations Widget** (`cf.cplace.formsWizard.wizardLocalizations`) - Manages localized text for wizard UI elements, provides multi-language support for wizards
+
+### Typical Page Layout
+
+On a Forms Wizard configuration page, you would typically find:
+- Step Manager Widget - To manage the list of steps
+- Wizard Analysis Widget - To validate the configuration
+- Wizard Activation Widget - To activate/deactivate the wizard
+- Wizard Localizations Widget - To configure multi-language support
+
+## Alternative Approaches
+
+For basic wizard configuration without complex validation needs, you might rely solely on the Step Manager Widget. However, for production wizards or complex multi-step processes, the Analysis widget is essential for ensuring configuration quality and preventing runtime errors.

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

@@ -0,0 +1 @@
+This widget checks whether the Forms Wizard has all the necessary configurations to be able to run, performing comprehensive checks on wizard structure, step configuration, and navigation logic to identify potential issues before activation.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.formsWizard.wizardLocalizations",
+  "Description": "{\"en\":\"This widget provides an user interface for adding localized text for use in the wizard. This widget is available on the wizard configuration page.\",\"de\":\"Dieses Widget bietet eine Benutzeroberfläche zum Hinzufügen von lokalisiertem Text zur Verwendung im Wizard. Dieses Widget ist auf der Konfigurationsseite des Wizards verfügbar.\"}",
+  "Localized Name": "{\"en\":\"Forms Wizard Localizations\",\"de\":\"Forms-Wizard-Übersetzungen\"}",
+  "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.wizardLocalizations/_meta.json

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

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

@@ -0,0 +1,48 @@
+## Overview
+
+This widget provides a user interface for adding localized text for use in the wizard. This widget is available on the wizard configuration page.
+
+The Wizard Localizations widget allows administrators to define, edit, and maintain translations for all wizard UI elements (labels, buttons, messages, etc.) across multiple languages, ensuring wizards can be presented based on user language preferences.
+
+## Use Cases
+
+### Multi-Language Wizard Support
+
+When building a wizard that needs to support users in different languages, this widget allows you to:
+- Define translations for all wizard UI elements in a single location
+- Manage language variants for labels, buttons, messages, and other text
+- Ensure consistency across the wizard's interface
+
+**Example Scenario**: A company operates in Germany, France, and the UK. They create an onboarding wizard that needs to display in German, French, and English. Using this widget, they define all text elements with translations for each language code (de, fr, en).
+
+### Localization Quality Assurance
+
+The widget helps identify configuration issues:
+- Detects when localizations reference languages not enabled in the system
+- Provides warnings for "unsupported languages" that won't be accessible to users
+- Helps administrators audit and maintain localization completeness
+
+## Design Considerations
+
+### When to Use This Widget
+
+Use this widget when:
+- Your wizard needs to support multiple languages
+- You need a centralized interface for managing all wizard translations
+- You want to ensure translation consistency across the wizard interface
+- You need to validate that all configured languages are properly supported
+
+### Integration with Forms Wizard
+
+This widget is part of the Forms Wizard feature set, which enables low-code creation of multi-step forms and workflows. Localizations are essential for making these wizards accessible to international user bases. The widget reads from and writes to a dedicated localization attribute on wizard entities, ensuring all modifications are properly controlled and validated.
+
+## Common Pitfalls
+
+- **Unsupported Languages**: Adding translations for languages not configured in cplace's system settings will generate warnings, as these translations won't be accessible to users
+- **Missing Translations**: Ensure all keys have translations for all supported languages to avoid fallback behavior or missing text
+- **Read-Only Attribute**: The underlying localization attribute is read-only; all modifications must go through this widget's interface
+
+## Related Patterns
+
+- **Forms Wizard Framework**: This widget is a specialized component within the broader Forms Wizard feature set
+- **Multi-Language Data Management**: Uses cplace's standard localization infrastructure (LocalizedString, language codes)

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

@@ -0,0 +1 @@
+Provides a user interface for adding localized text for use in the wizard. Available on the wizard configuration page for managing multi-language translations of wizard UI elements.

package/dist/widget-specifications/cf.cplace.genericInterface.api.widgets.triggerInterfaceButton/_catalog-data.json

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.genericInterface.api.widgets.triggerInterfaceButton",
+  "Description": "{\"en\":\"Triggers a configured interface. Here, if an export is being carried out, a file can be downloaded; if an import is being carried out, the user has the option of uploading a file.\",\"de\":\"Löst eine konfigurierte Schnittstelle aus. Hierbei kann bei einem Export eine Datei heruntergeladen werden, bei einem Import hat der Benutzer die Möglichkeit, eine Datei hochzuladen.\"}",
+  "Localized Name": "{\"en\":\"Trigger Interface\",\"de\":\"Schnittstelle anstoßen\"}",
+  "Icon": "cf-widget",
+  "Plugin": "cf.cplace.genericInterface.api",
+  "App": "cf.cplace.genericInterface.api.genericInterface",
+  "Localized App Name": "{\"de\":\"Generic Interface Main App\",\"en\":\"Generic Interface Main App\"}",
+  "Repository": "cplace-generic-interface",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.genericInterface.api.widgets.triggerInterfaceButton/_meta.json

@@ -0,0 +1,9 @@
+{
+  "tags": [
+    "files",
+    "form",
+    "reporting",
+    "detail-view"
+  ],
+  "requiredApp": "cf.cplace.genericInterface.api.genericInterface"
+}

package/dist/widget-specifications/cf.cplace.genericInterface.api.widgets.triggerInterfaceButton/_overview.md

@@ -0,0 +1,58 @@
+## Overview
+
+Triggers a configured interface. Here, if an export is being carried out, a file can be downloaded; if an import is being carried out, the user has the option of uploading a file.
+
+The Trigger Interface Button widget provides a user-initiated mechanism for executing Generic Interface operations. Unlike scheduled or automatic interfaces, this widget gives users control over when data integration processes run, making it ideal for scenarios where timing depends on human judgment or external factors.
+
+When clicked, the button executes a configured Generic Interface Definition as a background job, with optional file upload capability for import operations. Users receive progress feedback and can see execution results including any errors or warnings.
+
+## Use Cases
+
+### Manual Data Import
+Users can import data from external systems on an ad-hoc basis. When file upload is enabled, a dialog prompts the user to select a file before the interface executes. This is useful for importing product catalogs, customer lists, or other data that arrives irregularly.
+
+### On-Demand Data Export
+Trigger exports when needed rather than on a fixed schedule. Useful for generating reports before meetings, creating data snapshots before major changes, or exporting data for external stakeholders.
+
+### Manual Synchronization
+Allow users to force synchronization with external systems without waiting for scheduled runs. Valuable when critical updates have been made and immediate synchronization is required.
+
+### Single Page Export
+Export only the page where the widget is embedded rather than a full dataset. This enables per-page export functionality for archival, sharing, or compliance purposes.
+
+## Design Considerations
+
+### Interface Definition Requirement
+The widget must be linked to a valid Generic Interface Definition page, or the widget must be embedded on an Interface Definition page itself. This ensures the button always has a clear operation to execute.
+
+### File Upload Mode
+When enabled, the widget presents a file upload dialog before execution. The uploaded file is temporarily stored and passed to the interface processor. This mode is appropriate for import interfaces that process external files.
+
+### Export Embedding Page Mode
+When enabled, the interface exports only the page containing the widget rather than processing a broader dataset. This creates focused, single-page exports without requiring separate interface definitions for each page.
+
+### Background Execution
+Interface operations run as persistent background jobs. This allows processing of large datasets without blocking the user interface, though it means results are not immediately available after clicking.
+
+## Embedding Options
+
+The widget can be:
+- Embedded as a standalone widget in page layouts
+- Embedded within rich text content for inline placement
+- Placed on Interface Definition pages for direct execution
+
+The widget cannot be embedded in table cells or other restricted contexts.
+
+## Alternatives
+
+| Alternative | When to Use |
+|-------------|-------------|
+| Scheduled interfaces | When data integration should run automatically at regular intervals |
+| Low Code Button | When you need custom scripted behavior rather than standard interface execution |
+| Direct API integration | When external systems should push/pull data programmatically |
+
+## Related Patterns
+
+- **Interface Definition pages**: Configure the actual import/export logic that this button triggers
+- **Generic Interface system**: The broader framework including runners, processors, and mappers
+- **Simple Button Widget**: Parent widget family providing common button styling and behavior

package/dist/widget-specifications/cf.cplace.genericInterface.api.widgets.triggerInterfaceButton/_summary.md

@@ -0,0 +1 @@
+Triggers a configured interface to execute import or export operations. Supports file download for exports and file upload for imports.

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.landingPageFromPage.quickOverview",
+  "Description": "{\"en\":\"Shows at a glance results for a defined search\",\"de\":\"Zeigt auf einen Blick Ergebnisse für eine definierte Suche\"}",
+  "Localized Name": "{\"en\":\"Quick Overview\",\"de\":\"Schnellübersicht\"}",
+  "Icon": "fa-binoculars",
+  "Plugin": "cf.cplace.landingPageFromPage",
+  "App": "cf.cplace.landingPageFromPage",
+  "Localized App Name": "{\"en\":\"Landing Page from a cplace Page\",\"de\":\"Landing Page aus einer cplace-Seite\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.landingPageFromPage.quickOverview/_meta.json

@@ -0,0 +1,10 @@
+{
+  "tags": [
+    "list",
+    "searchable",
+    "read-only",
+    "dashboard",
+    "navigation"
+  ],
+  "requiredApp": "cf.cplace.landingPageFromPage"
+}

package/dist/widget-specifications/cf.cplace.landingPageFromPage.quickOverview/_overview.md

@@ -0,0 +1,66 @@
+## Overview
+
+Shows at a glance results for a defined search.
+
+The Quick Overview widget creates dashboard-style summary tiles that combine statistical counts with quick access links. Each tile displays a configurable header (title, subtitle, icon), the total number of matching items, and a limited list of specific results. An optional create button enables users to add new items without navigating away from the landing page.
+
+This widget is part of the Landing Page from Page plugin, which enables creating landing pages within any workspace that display without the standard workspace navigation chrome.
+
+## Use Cases
+
+### Landing Page Dashboard Tiles
+Create at-a-glance summaries for different content categories on landing pages. Examples include:
+- "5 Active Projects" showing the first 3 project names with links
+- "12 Open Tasks" displaying the first 5 task titles
+- "8 Team Members" with quick access to member profiles
+
+### Content Category Overview
+Provide users with immediate visibility into filtered content distributions without requiring navigation to full search results or list pages. The prominent count display helps users understand content volume at a glance.
+
+### Quick Navigation Hubs
+Build clickable entry points to frequently accessed content, combining summary statistics with direct item access. Users can quickly jump to specific items or use the create button to add new ones.
+
+## Design Considerations
+
+### When to Use This Widget
+Choose Quick Overview when:
+- You need a compact summary tile format with prominent count display
+- The hit count is as important as the items themselves
+- You want to show a limited preview (typically 3-7 items) of a larger collection
+- Users need quick access to both item details and creation functionality
+
+### Alternatives to Consider
+
+**Simple List Overview** (`cf.cplace.landingPageFromPage.simpleListWithAttachment`)
+- Choose when you need subtitles for each item (via pattern formatting)
+- Better for scrollable lists with custom per-item icons based on enum attributes
+- Supports linking to an overview page
+- Does not display prominent hit counts
+
+**Connected Table** (`cf.platform.connectedTable` or similar table widgets)
+- Choose when users need comprehensive data with sorting, filtering, and selection
+- Better for detailed data exploration rather than quick summaries
+- Supports more complex interactions and master-detail patterns
+
+### Key Differentiators
+- **Hit count prominence**: The total count is a primary visual element, not supplementary information
+- **Limited item display**: Intentionally shows only a subset of results for compact dashboard presentation
+- **Create button integration**: Supports in-context item creation without leaving the landing page
+- **Tile format**: Designed as a self-contained summary card rather than a full-width list or table
+
+## Common Pitfalls
+
+### Search Configuration Issues
+The widget requires a properly configured search that targets content appropriately. When multiple workspaces are selected in the search, the space filter is automatically removed, which may produce unexpected results.
+
+### Create Button Limitations
+The create button functionality works best when the search targets a single workspace and single type. Multi-type or multi-workspace searches may not provide the expected create behavior.
+
+### Sort Behavior
+The widget applies alphabetical sorting (ascending or descending) regardless of the configured sort column. This ensures consistent item ordering but may differ from the original search result ordering.
+
+## Related Patterns
+
+**Landing Page Design Pattern**: Combine multiple Quick Overview widgets on a single landing page to create a comprehensive dashboard showing different content categories, each with its own count and preview items.
+
+**Progressive Disclosure**: Use Quick Overview tiles as entry points, where clicking items leads to detail pages, or use the overview page link pattern (available in Simple List Overview) to navigate to comprehensive filtered views.