@cplace/test-mcp-server 1.3.11 → 1.3.13

package/dist/widget-specifications/DOCUMENTATION-STATUS.md

@@ -24,16 +24,16 @@ Each widget should have these files following the three-level architecture:
 
 | Metric | Count | Percentage |
 |--------|-------|------------|
-| **Total widgets in cplace** | 108 | 100% |
-| **Widgets with specifications** | 108 | 100% |
+| **Total widgets in cplace** | 109 | 100% |
+| **Widgets with specifications** | 109 | 100% |
 | **Widgets without any specs** | 0 | 0% |
 
-### Documentation Completeness (of 108 documented widgets)
+### Documentation Completeness (of 109 documented widgets)
 
 | Status | Count | Percentage |
 |--------|-------|------------|
 | **Complete** | 10 | 9% |
-| **Partial** | 98 | 91% |
+| **Partial** | 99 | 91% |
 | **Minimal (meta only)** | 0 | 0% |
 
 ---
@@ -94,6 +94,7 @@ Each widget should have these files following the three-level architecture:
 | cf.projektplanung.scheduleTreeTable | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
 | cf.projektplanung.singleGanttLink | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
 | cf.cplace.lowCodeWidgets.lowCodeButton | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
+| cf.cplace.lowCodeWidgets.lowCodeText | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
 | cf.cplace.pageViewHeadline.widget | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
 | cf.cplace.pdfPreview.widget | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
 | cf.cplace.simpleForm.widget | ✓ | ✓ | ✓ | ✗ | 0 | implementation |
@@ -169,19 +170,19 @@ All widgets now have specification directories.
 
 ### Widgets Missing `_meta.json` (Level 1)
 
-All 108 documented widgets have `_meta.json` files.
+All 109 documented widgets have `_meta.json` files.
 
 ### Widgets Missing `_summary.md` (Level 1)
 
-All 108 documented widgets now have `_summary.md` files.
+All 109 documented widgets now have `_summary.md` files.
 
 ### Widgets Missing `_overview.md` (Level 2)
 
-All 108 documented widgets now have `_overview.md` files.
+All 109 documented widgets now have `_overview.md` files.
 
 ### Widgets Missing `_implementation.md` (Level 3)
 
-98 widgets need implementation guidance added:
+99 widgets need implementation guidance added:
 
 **Partial widgets:**
 - `cf.cplace.breadcrumbs.breadcrumbsWidget`
@@ -205,6 +206,7 @@ All 108 documented widgets now have `_overview.md` files.
 - `cf.cplace.landingPageFromPage.quickOverview`
 - `cf.cplace.landingPageFromPage.sessionUserNameWidget`
 - `cf.cplace.lowCodeWidgets.lowCodeButton`
+- `cf.cplace.lowCodeWidgets.lowCodeText`
 - `cf.cplace.pageViewHeadline.widget`
 - `cf.cplace.pdfPreview.widget`
 - `cf.cplace.platform.tableWidget`
@@ -353,6 +355,7 @@ All widgets now have specification directories. No undocumented widgets remain.
 - `de.2lforge.curves.widget` (from undocumented)
 - `de.2lforge.toolbar.dropDownWidget` (from undocumented)
 - `cf.cplace.lowCodeWidgets.lowCodeButton`
+- `cf.cplace.lowCodeWidgets.lowCodeText`
 - `cf.cplace.pageViewHeadline.widget`
 - `cf.cplace.pdfPreview.widget`
 - `cf.cplace.simpleForm.widget`
@@ -393,18 +396,18 @@ All widgets now have specification directories. No undocumented widgets remain.
 - `cf.projektplanung.ganttTaskDemo` (new - from undocumented)
 - `de.2lforge.toolbar.datePickerWidget` (new - from undocumented)
 
-All 108 documented widgets now have Level 1 (_meta.json, _summary.md) and Level 2 (_overview.md) documentation. 10 of these are fully Complete with Level 3 documentation.
+All 109 documented widgets now have Level 1 (_meta.json, _summary.md) and Level 2 (_overview.md) documentation. 10 of these are fully Complete with Level 3 documentation.
 
 ---
 
 ## Files Missing by Type
 
-| File Type | Count Missing | Percentage (of 108 documented) |
+| File Type | Count Missing | Percentage (of 109 documented) |
 |-----------|---------------|------------|
 | `_meta.json` | 0 | 0% |
 | `_summary.md` | 0 | 0% |
 | `_overview.md` | 0 | 0% |
-| `_implementation.md` | 98 | 91% |
+| `_implementation.md` | 99 | 91% |
 
 ---
 

package/dist/widget-specifications/WIDGET-TAGGING-SCHEME.md

@@ -154,6 +154,7 @@ This document defines a multi-dimensional tagging system for cplace widgets. Tag
 | Widget ID | Widget Name | Tags |
 |-----------|-------------|------|
 | `cf.cplace.lowCodeWidgets.lowCodeButton` | Low-Code Button | `low-code`, `inline-edit` |
+| `cf.cplace.lowCodeWidgets.lowCodeText` | Low-Code Text | `low-code`, `rich-text`, `connected`, `searchable`, `read-only`, `dashboard` |
 | `cf.cplace.simpleForm.widget` | Creation Form | `form`, `attributes`, `inline-edit` |
 | `cf.cplace.dynamicCodeBlockWidget.dynamicCodeBlockWidget` | Dynamic Code Block | `low-code`, `rich-text` |
 | `cf.cplace.tuplesWidget.widget` | Tuple | `attributes`, `table`, `time-series`, `inline-edit` |

package/dist/widget-specifications/_research_from_ga_products/cf-cplace-lowCodeWidgets-lowCodeText/research.md

@@ -0,0 +1,176 @@
+# Low-Code Text Widget Research
+
+## Widget Overview
+
+**Widget ID:** `cf.cplace.lowCodeWidgets.lowCodeText`
+**Widget Name:** Low-Code Text
+**Repository:** `cplace-paw`
+**Definition Class:** `cf.cplace.lowCodeWidgets.script.LowCodeTextWidgetDefinition`
+
+### Purpose (1-2 Sentence Description)
+
+The Low-Code Text widget executes a cplaceJS script and renders the returned string (which may contain HTML) as inline content within a rich string widget. It reactively re-evaluates its script when connected table data or selections change, enabling dynamic computed text that updates without page reload.
+
+---
+
+## Conceptual Documentation
+
+### Core Functionality
+
+The Low-Code Text widget allows administrators and low-code developers to embed dynamic, script-computed content directly within rich string widgets. When the page loads, the widget evaluates a JavaScript script that has access to contextual data (pages from search, connected tables, or explicit selections) and renders the returned value as HTML text. Unlike the Low-Code Button (which executes on click), the Low-Code Text widget evaluates automatically and updates reactively when its data sources change.
+
+### Use Cases
+
+#### 1. **Dynamic Computed Values in Rich Text**
+Display calculated or derived information inline within formatted page content:
+- Show aggregated metrics (sums, averages, counts) based on search results
+- Display conditional text based on page attributes or states
+- Render formatted summaries from multiple data sources
+
+#### 2. **Reactive Dashboards with Connected Tables**
+Create text content that updates when users interact with connected table widgets:
+- Show details about selected table rows
+- Display summary statistics that update as the table's data changes
+- Render context-specific information based on table selection
+
+#### 3. **Internationalized Dynamic Content**
+Generate localized content using the `messages` binding:
+- Display status messages in the user's language
+- Show dynamically computed text with proper localization
+- Combine static rich text layout with dynamic localized values
+
+#### 4. **Data-Driven HTML Rendering**
+Generate custom HTML markup based on page data:
+- Create visual indicators (colored badges, progress bars) based on attribute values
+- Render mini-tables or formatted lists from search results
+- Display formatted dates, numbers, or computed expressions
+
+---
+
+## Configuration Concepts
+
+### Script Structure
+
+The widget requires a cplaceJS script that returns a value to display. Unlike the Low-Code Button, the script does not need to return an object with methods -- it simply returns the text/HTML to render.
+
+Supported return types:
+- **String**: Rendered directly as HTML (sanitized via `RichStringUtilities.clean()`)
+- **Number**: Converted to string
+- **Boolean**: Converted to string
+- **Date**: Converted to string representation
+- **Localized object**: Object with language keys (e.g., `{en: "Hello", de: "Hallo"}`) -- resolved to user's language
+
+### Script Bindings
+
+The script has access to the following bindings:
+
+| Binding | Type | Description |
+|---------|------|-------------|
+| `pages` | `Iterable<WrappedPage>` | Pages from the configured data source (search, selection, or connected table) |
+| `searchResults` | `Iterable<WrappedCustomEntity<?>>` | All search results (if "Include All Search Results" is enabled) |
+| `embeddingPage` | `WrappedPage` | The page on which the widget is embedded |
+| `messages` | `CplaceJSTypeMessageProvider` | Access to internationalized messages defined in the embedding page's type definition |
+
+### Main Configuration Options
+
+#### 1. **Script Configuration**
+- **Script**: The cplaceJS script that produces the text to display. **Required.**
+
+#### 2. **Data Source Options**
+Multiple ways to provide data to the script (same as Low-Code Button):
+
+- **Search**: Define a search query whose results are available as the `pages` binding, with optional sort column and order
+- **Connected Table**: Connect to a table widget on the same page
+  - **Selection Only**: Only selected rows from the table are available
+  - Supports nested connected tables (connected table's own connected table)
+- **Selection**: Manually select specific pages to provide as the `pages` binding
+- **Include All Search Results**: Provides raw search results (not just pages) in the `searchResults` binding
+
+### Reactive Behavior
+
+The widget re-evaluates its script in response to connected table events:
+
+1. **Table data refresh**: When the connected table's data changes, the text widget re-evaluates (unless in "selection only" mode)
+2. **Row selection change**: When the user's row selection changes in the connected table (in "selection only" mode)
+3. **Nested table selection**: When a connected table's own connected table fires a selection event
+
+Re-evaluation is performed via an AJAX POST to `EvaluateTextHandler`, which re-runs the script server-side and returns the new HTML text.
+
+### Embedding Constraint
+
+This widget can **only** be embedded inside rich string widgets (`WidgetEmbedding.INSIDE_RICHSTRING`). It cannot be placed directly on a page layout. It renders without a frame and without padding, making it blend seamlessly into the surrounding rich text content.
+
+### Permissions and Access Control
+
+- **Embedding Permission**: Only users with "Low-Code permission" (`GlobalPermissions.mayEditLowCode()`) can embed this widget
+- **Script Editing**: The script attribute is only visible/editable to users with Low-Code permission
+
+### Integration with Other Widgets
+
+The Low-Code Text widget is:
+- **Embedded in**: Rich String widgets (`cf.platform.richString`) or Rich String Without Frame (`cf.cplace.demoWidgets.demoRichString`)
+- **Connected to**: Embedded Search as Table widgets (to react to data/selection changes)
+- **Nested**: Can work with connected tables that are themselves connected to other tables
+
+---
+
+## Related Concepts
+
+### Comparison with Low-Code Button Widget
+
+The Low-Code Text is part of a family of Low-Code widgets:
+
+| Aspect | Low-Code Text | Low-Code Button |
+|--------|---------------|-----------------|
+| **Purpose** | Display computed text/HTML | Execute actions on click |
+| **Script return** | String, number, date, or localized object | Object with `checkAccess()` and `call()` methods |
+| **Execution** | Automatic on page load + reactive | User-triggered on click |
+| **Execution mode** | Always synchronous | Async (default) or synchronous |
+| **Embedding** | Rich string only | Anywhere, including attribute groups |
+| **Frame** | Never (frameless, no padding) | Configurable |
+| **Data source** | Identical 3-mode grouping | Identical 3-mode grouping |
+
+### Low-Code Script Engine
+
+The widget uses the cplace Low-Code script engine with:
+- **Sandboxed execution**: Scripts run in a controlled environment
+- **Type safety**: Access to typed wrappers for cplace entities
+- **Search/Filter access**: Scripts can use `Search` and `Filters` classes
+- **HTML sanitization**: Output is cleaned via `RichStringUtilities.clean()`
+
+---
+
+## Technical Details
+
+### Key Classes
+
+- **Definition**: `cf.cplace.lowCodeWidgets.script.LowCodeTextWidgetDefinition` (cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/script/LowCodeTextWidgetDefinition.java:35)
+- **Evaluation**: `cf.cplace.lowCodeWidgets.utils.LowCodeTextWidgetUtils` (cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/utils/LowCodeTextWidgetUtils.java:52)
+- **Handler**: `EvaluateTextHandler` (cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/handler/EvaluateTextHandler.java:27)
+- **Configuration Type**: `LowCodeWidgetsWidgetTypes.LOW_CODE_TEXT_WIDGET` (cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/LowCodeWidgetsWidgetTypes.java:37)
+
+### Frontend Components
+
+- **Controller**: `LowCodeTextWidgetCtrl` (cf.cplace.lowCodeWidgets/assets/ts/controllers/LowCodeTextWidgetCtrl.ts:11)
+- **Directive**: `lowCodeTextWidgetDirective` (cf.cplace.lowCodeWidgets/assets/ts/directives/lowCodeTextWidgetDirective.ts:4)
+- **Template**: `lowCodeTextWidgetDefinition.htm` (cf.cplace.lowCodeWidgets/src/main/resources/cf/cplace/lowCodeWidgets/script/lowCodeTextWidgetDefinition.htm)
+
+### Configuration Attributes
+
+| Attribute | Type | Required | Purpose |
+|-----------|------|----------|---------|
+| `SCRIPT` | SingleString (script) | Yes | The cplaceJS script to execute |
+| `SEARCH` | SingleString (search) | No | Search definition for finding pages |
+| `SORT_COLUMN` | SingleString | No | Column to sort search results by |
+| `SORT_ORDER` | SingleString | No | Sort direction |
+| `CONNECTED_TABLE` | SingleString | No | Widget ID of connected table |
+| `CONNECTED_TABLE_SELECTION_ONLY` | SingleBoolean | No | Use only selected rows |
+| `SELECTION` | MultiPageReference | No | Explicit page references |
+| `DATA_SOURCE` | AttributeGrouping | Yes | Switches between search/connected-table/selection modes |
+| `INCLUDE_ALL_SEARCH_RESULTS` | SingleBoolean | No | Also provide searchResults binding |
+
+---
+
+## Summary
+
+The Low-Code Text widget is the declarative counterpart to the Low-Code Button widget. While the button executes user-triggered actions, the text widget automatically evaluates a script and renders the result as HTML content within a rich string widget. Its reactive behavior with connected tables makes it suitable for building dynamic, data-driven page content that updates in response to user interactions elsewhere on the page.

package/dist/widget-specifications/_research_from_ga_products/widget-definition-mapping.md

@@ -2,7 +2,7 @@
 
 **Generated:** 2026-01-16
 **Phase:** 0 - Discovery
-**Total Widgets in Target List:** 97
+**Total Widgets in Target List:** 98
 
 ---
 
@@ -10,14 +10,14 @@
 
 | Status | Count |
 |--------|-------|
-| Found | 97 |
+| Found | 98 |
 | Not Found | 0 |
 
-All 97 target widgets have been mapped to their definition classes.
+All 98 target widgets have been mapped to their definition classes.
 
 ---
 
-## Widgets with Existing Specs (49)
+## Widgets with Existing Specs (50)
 
 | Widget ID | Repository | Definition Class Path | Status |
 |-----------|------------|----------------------|--------|
@@ -31,6 +31,7 @@ All 97 target widgets have been mapped to their definition classes.
 | cf.cplace.formsWizard.startWizardWidget | cplace-forms-wizard | cf.cplace.formsWizard/src/main/java/cf/cplace/formsWizard/script/StartWizardWidgetDefinition.java | found |
 | cf.cplace.layoutTabsWidget.widget | cplace-paw | cf.cplace.layoutTabsWidget/src/main/java/cf/cplace/layoutTabsWidget/script/LayoutTabsWidgetWidgetDefinition.java | found |
 | cf.cplace.lowCodeWidgets.lowCodeButton | cplace-paw | cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/script/LowCodeButtonWidgetDefinition.java | found |
+| cf.cplace.lowCodeWidgets.lowCodeText | cplace-paw | cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/script/LowCodeTextWidgetDefinition.java | found |
 | cf.cplace.pageViewHeadline.widget | cplace-paw | cf.cplace.pageViewHeadline/src/main/java/cf/cplace/pageViewHeadline/widget/PageViewHeadlineWidgetDefinition.java | found |
 | cf.cplace.pdfPreview.widget | cplace-paw | cf.cplace.pdfPreview/src/main/java/cf/cplace/pdfPreview/script/PdfPreviewWidgetDefinition.java | found |
 | cf.cplace.platform.attributesGroup | main | cf.cplace.platform/src/main/java/cf/cplace/platform/frontend/widgets/AttributesGroupWidgetDefinition.java | found |
@@ -139,7 +140,7 @@ All 97 target widgets have been mapped to their definition classes.
 | Repository | Widget Count | Base Path |
 |------------|--------------|-----------|
 | main | 24 | /Users/thomasbuechner/dev/repos/main/cf.cplace.platform |
-| cplace-paw | 22 | /Users/thomasbuechner/dev/repos/cplace-paw |
+| cplace-paw | 23 | /Users/thomasbuechner/dev/repos/cplace-paw |
 | cplace-project-planning | 12 | /Users/thomasbuechner/dev/repos/cplace-project-planning |
 | cplace-forms-wizard | 9 | /Users/thomasbuechner/dev/repos/cplace-forms-wizard |
 | cplace-ecf | 6 | /Users/thomasbuechner/dev/repos/cplace-ecf |

package/dist/widget-specifications/_research_from_ga_products/widget-research-generation/widgets.txt

@@ -12,6 +12,7 @@ cf.cplace.dynamicCodeBlockWidget.dynamicCodeBlockWidget	cplace-utility-widgets	c
 cf.cplace.formsWizard.startWizardWidget	cplace-forms-wizard	cf.cplace.formsWizard/src/main/java/cf/cplace/formsWizard/script/StartWizardWidgetDefinition.java
 cf.cplace.layoutTabsWidget.widget	cplace-paw	cf.cplace.layoutTabsWidget/src/main/java/cf/cplace/layoutTabsWidget/script/LayoutTabsWidgetWidgetDefinition.java
 cf.cplace.lowCodeWidgets.lowCodeButton	cplace-paw	cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/script/LowCodeButtonWidgetDefinition.java
+cf.cplace.lowCodeWidgets.lowCodeText	cplace-paw	cf.cplace.lowCodeWidgets/src/main/java/cf/cplace/lowCodeWidgets/script/LowCodeTextWidgetDefinition.java
 cf.cplace.pageViewHeadline.widget	cplace-paw	cf.cplace.pageViewHeadline/src/main/java/cf/cplace/pageViewHeadline/widget/PageViewHeadlineWidgetDefinition.java
 cf.cplace.pdfPreview.widget	cplace-paw	cf.cplace.pdfPreview/src/main/java/cf/cplace/pdfPreview/script/PdfPreviewWidgetDefinition.java
 cf.cplace.platform.attributesGroup	main	cf.cplace.platform/src/main/java/cf/cplace/platform/frontend/widgets/AttributesGroupWidgetDefinition.java

package/dist/widget-specifications/cf.cplace.lowCodeWidgets.lowCodeButton/_overview.md

@@ -117,6 +117,18 @@ The Low-Code Button widget can be:
 - **Missing data source**: Scripts expecting the `pages` binding will fail if no data source is configured.
 - **Log output ignored**: In synchronous mode, `log.logText()` and `log.logHtml()` output is not displayed to users.
 
+## Testing Before Embedding
+
+Before embedding a Low-Code Button widget into a rich string attribute, test your cplaceJS script independently to verify it works correctly.
+
+**Recommended workflow:**
+1. Write your cplaceJS script (with `checkAccess()` and `call()` methods)
+2. Test the `call()` logic using `cplace_execute_script` with a representative page as the context page
+3. Verify the script executes without errors and produces the expected result
+4. Only then embed the widget via `cplace_richstring_insert_widget` with the tested script in the properties
+
+**Why this matters:** A script with errors will produce a broken button once embedded. Debugging scripts inside embedded widgets is significantly harder than debugging them standalone, because the embedded widget rendering does not surface script errors clearly.
+
 ## Permissions and Access Control
 
 - **Embedding Permission**: Only users with "Low-Code permission" (`GlobalPermissions.mayEditLowCode()`) can embed this widget

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

@@ -0,0 +1,12 @@
+{
+  "Widget": "cf.cplace.lowCodeWidgets.lowCodeText",
+  "Description": "{\"en\":\"This widget executes a Low-Code script and renders the result as text/HTML within a rich string widget.\",\"de\":\"Dieses Widget f\\u00fchrt ein Low-Code-Skript aus und gibt das Ergebnis als Text/HTML innerhalb eines Rich-String-Widgets aus.\"}",
+  "Localized Name": "{\"en\":\"Low-Code Text\",\"de\":\"Low-Code Text\"}",
+  "Icon": "fa-code",
+  "Plugin": "cf.cplace.lowCodeWidgets",
+  "App": "cf.cplace.platform",
+  "Localized App Name": "{\"en\":\"cplace Basis\",\"de\":\"cplace Basis\"}",
+  "Repository": "cplace-paw",
+  "* Details DE": null,
+  "* Details EN": null
+}

package/dist/widget-specifications/cf.cplace.lowCodeWidgets.lowCodeText/_meta.json

@@ -0,0 +1,11 @@
+{
+  "tags": [
+    "low-code",
+    "rich-text",
+    "connected",
+    "searchable",
+    "read-only",
+    "dashboard"
+  ],
+  "requiredApp": null
+}

package/dist/widget-specifications/cf.cplace.lowCodeWidgets.lowCodeText/_overview.md

@@ -0,0 +1,94 @@
+## Overview
+
+This widget executes a cplaceJS script and renders the result as inline HTML content within a rich string widget.
+
+The Low-Code Text widget enables dynamic, script-computed content to be embedded directly within rich text layouts. On page load, the widget evaluates a JavaScript script with access to contextual data (pages from search, connected tables, or explicit selections) and renders the returned value as HTML. When connected to a table widget, it reactively re-evaluates whenever the table's data or user selection changes, enabling live-updating computed content without page reload.
+
+## Use Cases
+
+### Dynamic Computed Values in Rich Text
+Display calculated or derived information inline within formatted page content:
+- Aggregated metrics (sums, averages, counts) from search results
+- Conditional text based on page attributes or states
+- Formatted summaries combining data from multiple sources
+
+### Reactive Content Linked to Tables
+Create text that updates when users interact with connected table widgets:
+- Details about selected table rows
+- Summary statistics that update as the table data changes
+- Context-specific information based on the current table selection
+
+### Data-Driven HTML Rendering
+Generate custom HTML markup based on page data:
+- Visual indicators (colored badges, progress bars) based on attribute values
+- Mini-tables or formatted lists from search results
+- Formatted dates, numbers, or computed expressions
+
+### Internationalized Dynamic Content
+Generate localized content using the `messages` binding to display status messages, computed text, or dynamic values in the user's language.
+
+## Script Return Values
+
+The script simply returns a value to display (no object structure required, unlike the Low-Code Button):
+- **String**: Rendered as HTML (sanitized)
+- **Number/Boolean/Date**: Converted to string
+- **Localized object**: `{en: "Hello", de: "Hallo"}` -- resolved to user's language
+
+## Data Source Options
+
+The widget supports three data source modes (identical to the Low-Code Button):
+
+**Search**: Define a search query whose results are passed as the `pages` binding. Most common mode.
+
+**Connected Table**: Connect to a table widget on the same page. The widget re-evaluates when the table's data changes or when the user's selection changes (if "selection only" is enabled). Supports chained connected tables.
+
+**Selection**: Manually select specific pages to provide as the `pages` binding.
+
+Additionally, **Include All Search Results** can be enabled to provide raw search results (including non-page entities) via the `searchResults` binding.
+
+## Embedding Constraint
+
+This widget can **only** be embedded inside rich string widgets. It cannot be placed directly on a page layout. It renders without a frame and without padding, blending seamlessly into surrounding rich text content.
+
+## Design Considerations
+
+### When to Use This Widget
+- You need dynamic, script-computed content within a rich text layout
+- The content should update reactively based on connected table interactions
+- You want inline computed values (metrics, status text, formatted data) mixed with static rich text
+
+### When NOT to Use This Widget
+- For user-triggered actions -- use the **Low-Code Button** instead
+- For standalone chart visualizations -- use **cplaceJS Highcharts** or **cplaceJS Line Chart**
+- For simple static text -- use the **Rich String** widget directly
+
+### Script Execution Considerations
+- Scripts execute synchronously during page rendering and on every re-evaluation
+- Keep scripts performant to avoid slow page loads
+- Output HTML is sanitized via `RichStringUtilities.clean()` for security
+
+## Testing Before Embedding
+
+Before embedding a Low-Code Text widget into a rich string attribute, test your cplaceJS script independently to verify it produces the expected output.
+
+**Recommended workflow:**
+1. Write your cplaceJS script
+2. Run it using `cplace_execute_script` with a representative page as the context page
+3. Verify the returned HTML/text is correct
+4. Only then embed the widget via `cplace_richstring_insert_widget` with the tested script in the properties
+
+**Why this matters:** A script with errors or unexpected output will produce a broken or empty widget once embedded. Debugging scripts inside embedded widgets is significantly harder than debugging them standalone, because the embedded widget rendering does not surface script errors clearly.
+
+## Related Widgets
+
+### Low-Code Button (`cf.cplace.lowCodeWidgets.lowCodeButton`)
+The imperative counterpart: executes user-triggered actions on click. Shares the same data source configuration and script bindings but uses a different script structure (`checkAccess()`/`call()` methods).
+
+### Rich String (`cf.platform.richString`)
+The typical host widget for Low-Code Text. The rich string provides the static layout structure; embedded Low-Code Text widgets provide dynamic content within it.
+
+### Text without Widget Frame (`cf.cplace.demoWidgets.demoRichString`)
+An alternative host widget -- a frameless rich string variant also capable of embedding Low-Code Text widgets.
+
+### Embedded Search as Table (`cf.platform.embeddedSearchAsTable`)
+Often used as the connected data source. The table widget provides data or selection events that trigger the Low-Code Text to re-evaluate.

package/dist/widget-specifications/cf.cplace.lowCodeWidgets.lowCodeText/_summary.md

@@ -0,0 +1 @@
+Executes a cplaceJS script and renders the returned text or HTML inline within a rich string widget. Reactively re-evaluates when connected table data or selections change.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cplace/test-mcp-server",
-  "version": "1.3.11",
+  "version": "1.3.13",
   "description": "MCP server that provides Claude Desktop with tools to interact with cplace APIs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",