@ea-lab/reactive-json-docs 0.7.0 → 0.8.0

package/public/rjbuild/docs/core/element/html/AccordionItem.yaml

@@ -8,9 +8,21 @@ renderView:
       **Important:** `AccordionItem` must be a direct child of `BsAccordion`.
 
       ## Properties
-      - `header` (object, optional): Content for the accordion header
-      - `body` (object, optional): Content for the accordion body
-      - `attributes` (object, optional): Additional attributes for the Accordion.Item
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: header
+          after: "(object, optional)"
+        details: "Content for the accordion header."
+      - term:
+          code: body
+          after: "(object, optional)"
+        details: "Content for the accordion body."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Additional attributes for the Accordion.Item."
 
   - type: RjBuildDescriber
     title: "Interactive Example: Accordion with multiple sections"
@@ -41,7 +53,7 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Only works inside a parent BsAccordion component
-      - No built-in support for nested accordions
-      - The eventKey is set automatically; custom keys are not supported directly
-      - No animation customization beyond what react-bootstrap provides
+      - Only works inside a parent BsAccordion component.
+      - No built-in support for nested accordions.
+      - The eventKey is set automatically; custom keys are not supported directly.
+      - No animation customization beyond what react-bootstrap provides.

package/public/rjbuild/docs/core/element/html/FolderSortableTree.yaml

@@ -10,13 +10,41 @@ renderView:
       **Note:** For each node, all properties to display in the template (like `name`, `age`, etc.) must be placed inside a `value` object. The itemTemplate only has access to the fields inside `value` for each node. Children are listed in the `children` array.
 
       ## Properties
-      - `dataLocation` (string, required): Path to the tree data
-      - `itemTemplate` (object, required): Template for each tree item
-      - `maxDepth` (number, optional): Maximum allowed depth
-      - `maxDepthIsAbsolute` (boolean, optional): If true, maxDepth is absolute from the root (default: true)
-      - `treeRootPath` (string, optional): Path to a subtree to display as the root
-      - `keepBaseItem` (boolean, optional): If true, keeps the base item when using treeRootPath
-      - `sortableTreeOptions` (object, optional): Additional options for SortableTree
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: dataLocation
+          after: "(string, required)"
+        details: "Path to the tree data."
+      - term:
+          code: itemTemplate
+          after: "(object, required)"
+        details: "Template for each tree item."
+      - term:
+          code: maxDepth
+          after: "(number, optional)"
+        details: "Maximum allowed depth."
+      - term:
+          code: maxDepthIsAbsolute
+          after: "(boolean, optional)"
+        details:
+          type: Markdown
+          content: "If true, `maxDepth` is absolute from the root (default: true)."
+      - term:
+          code: treeRootPath
+          after: "(string, optional)"
+        details: "Path to a subtree to display as the root."
+      - term:
+          code: keepBaseItem
+          after: "(boolean, optional)"
+        details:
+          type: Markdown
+          content: "If true, keeps the base item when using `treeRootPath`."
+      - term:
+          code: sortableTreeOptions
+          after: "(object, optional)"
+        details: "Additional options for SortableTree."
 
   - type: RjBuildDescriber
     title: "Interactive Example: Editable family tree"
@@ -74,8 +102,8 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Tree data must be an array of objects with `id`, `children`, and `value` keys
-      - No built-in async loading of children
-      - No built-in search/filter UI
-      - Only one tree can be edited at a time per component instance
-      - No animation customization beyond what dnd-kit-sortable-tree provides
+      - Tree data must be an array of objects with `id`, `children`, and `value` keys.
+      - No built-in async loading of children.
+      - No built-in search/filter UI.
+      - Only one tree can be edited at a time per component instance.
+      - No animation customization beyond what dnd-kit-sortable-tree provides.

package/public/rjbuild/docs/core/element/html/FormatNumeral.yaml

@@ -6,9 +6,23 @@ renderView:
       The `FormatNumeral` component displays a number as a Roman numeral or Latin letter. Useful for sections, lists, or any context where a non-Arabic numeral is needed.
 
       ## Properties
-      - `content` (number, required): The number to format
-      - `format` (string, required): One of `roman-upper`, `roman-lower`, `latin-upper`, `latin-lower`
-      - `attributes` (object, optional): Additional attributes for the root element
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: content
+          after: "(number, required)"
+        details: "The number to format."
+      - term:
+          code: format
+          after: "(string, required)"
+        details:
+          type: Markdown
+          content: "One of: `roman-upper`, `roman-lower`, `latin-upper`, `latin-lower`."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Additional attributes for the root element."
 
   - type: RjBuildDescriber
     title: "Interactive Example: Format a number"
@@ -52,7 +66,7 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Only positive integers are supported (no zero, negative, or fractional numbers)
-      - No support for custom numeral systems
-      - No localization or language-specific formatting
-      - No error message for invalid input; nothing is rendered if the input is invalid
+      - Only positive integers are supported (no zero, negative, or fractional numbers).
+      - No support for custom numeral systems.
+      - No localization or language-specific formatting.
+      - No error message for invalid input; nothing is rendered if the input is invalid.

package/public/rjbuild/docs/core/element/html/Html.yaml

@@ -8,10 +8,27 @@ renderView:
       **Note:** The `tag` property must be a static string. It cannot be set dynamically via template or data.
 
       ## Properties
-      - `tag` (string, required): The HTML tag to render (e.g., div, span, section)
-      - `attributes` (object, optional): Attributes for the tag (class, id, etc.)
-      - `content` (object/array, optional): Content to render inside the tag (any Reactive-JSON view or array)
-      - `extra` (object, optional): Additional content rendered after the main tag
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: tag
+          after: "(string, required)"
+        details:
+          type: Markdown
+          content: "The HTML tag to render (e.g., div, span, section)."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Attributes for the tag (class, id, etc.)."
+      - term:
+          code: content
+          after: "(object|array, optional)"
+        details: "Content to render inside the tag (any Reactive-JSON view or array)."
+      - term:
+          code: extra
+          after: "(object, optional)"
+        details: "Additional content rendered after the main tag."
 
   - type: BsAlert
     attributes:
@@ -60,8 +77,8 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - The `tag` property does not support template evaluation and must be a static string
-      - No validation of tag names; invalid tags may cause rendering errors
-      - No support for dangerouslySetInnerHTML (use PreformattedMarkup for raw HTML)
-      - No built-in support for event handlers (use actions system for interactivity)
-      - No automatic support for custom attributes beyond React's attribute normalization
+      - The `tag` property does not support template evaluation and must be a static string.
+      - No validation of tag names; invalid tags may cause rendering errors.
+      - No support for dangerouslySetInnerHTML (use PreformattedMarkup for raw HTML).
+      - No built-in support for event handlers (use actions system for interactivity).
+      - No automatic support for custom attributes beyond React's attribute normalization.

package/public/rjbuild/docs/core/element/html/LabelFromValue.yaml

@@ -6,10 +6,27 @@ renderView:
       The `LabelFromValue` component displays the label associated with a value, using an option-like structure. It is useful for showing the display label of a value selected in a SelectField or any value/label mapping.
 
       ## Properties
-      - `dataLocation` (string, required): Path to the value
-      - `options` (array, optional): Array of `{label, value}` objects
-      - `dynamicOptions` (any, optional): Template value for dynamic options
-      - `defaultFieldValue` (any, optional): Default value if none is set
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: dataLocation
+          after: "(string, required)"
+        details: "Path to the value."
+      - term:
+          code: options
+          after: "(array, optional)"
+        details:
+          type: Markdown
+          content: "Array of `{label, value}` objects."
+      - term:
+          code: dynamicOptions
+          after: "(any, optional)"
+        details: "Template value for dynamic options."
+      - term:
+          code: defaultFieldValue
+          after: "(any, optional)"
+        details: "Default value if none is set."
 
   - type: RjBuildDescriber
     title: "Interactive Example: Display label from value"
@@ -48,7 +65,7 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Only the first matching label is displayed; duplicate values in options are not supported
-      - No support for grouped options or nested structures
-      - No built-in formatting for the label (use a wrapper if needed)
-      - If no options are provided, the raw value is shown
+      - Only the first matching label is displayed; duplicate values in options are not supported.
+      - No support for grouped options or nested structures.
+      - No built-in formatting for the label (use a wrapper if needed).
+      - If no options are provided, the raw value is shown.

package/public/rjbuild/docs/core/element/html/Modal.yaml

@@ -7,12 +7,35 @@ renderView:
       The `Modal` component displays a dialog that can be controlled by local state or by a boolean in the global data context. It is useful for confirmations, information, or any overlay content.
 
       ## Properties
-      - `headerTitle` (object, optional): Content for the modal header (any Reactive-JSON view)
-      - `body` (object, optional): Content for the modal body (any Reactive-JSON view)
-      - `closeButton` (boolean, optional): Show a close button in the header (default: false)
-      - `showBoolPath` (string or boolean, optional): If a string, path to a boolean in data controlling visibility; otherwise, local state is used
-      - `attributes` (object, optional): Additional attributes for the modal (size, centered, etc.)
-      - `className` (string, optional): Additional CSS classes (always includes `reactive-json`)
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: headerTitle
+          after: "(object, optional)"
+        details: "Content for the modal header (any Reactive-JSON view)."
+      - term:
+          code: body
+          after: "(object, optional)"
+        details: "Content for the modal body (any Reactive-JSON view)."
+      - term:
+          code: closeButton
+          after: "(boolean, optional)"
+        details: "Show a close button in the header (default: false)."
+      - term:
+          code: showBoolPath
+          after: "(string|boolean, optional)"
+        details:
+          type: Markdown
+          content: "If a string, path to a boolean in data controlling visibility; otherwise, local state is used."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Additional attributes for the modal (size, centered, etc.)."
+      - term:
+          code: className
+          after: "(string, optional)"
+        details: "Additional CSS classes (always includes `reactive-json`)."
 
   - type: RjBuildDescriber
     title: "Interactive Example: Modal controlled by data path"
@@ -83,11 +106,11 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - No built-in async or loading state
-      - No advanced accessibility beyond react-bootstrap
-      - If `showBoolPath` is a data path, it must resolve to a boolean
-      - No animation customization beyond react-bootstrap
+      - No built-in async or loading state.
+      - No advanced accessibility beyond react-bootstrap.
+      - If `showBoolPath` is a data path, it must resolve to a boolean.
+      - No animation customization beyond react-bootstrap.
 
       ## Notes
-      - Multiple modals can be displayed simultaneously by using different `showBoolPath` values or state-controlled modals
-      - Each modal is independently controlled and managed
+      - Multiple modals can be displayed simultaneously by using different `showBoolPath` values or state-controlled modals.
+      - Each modal is independently controlled and managed.

package/public/rjbuild/docs/core/element/html/PreformattedMarkup.yaml

@@ -6,10 +6,26 @@ renderView:
       The `PreformattedMarkup` component renders HTML content with a strict allowlist of tags for safety. Use it to display rich text or HTML snippets, with filtering to prevent unwanted markup.
 
       ## Properties
-      - `content` (string, required): The HTML string to render (can use template values)
-      - `htmlTagAllowList` (array, optional): List of allowed tags (overrides default)
-      - `additionalAllowedTags` (array, optional): Tags to add to the allowlist
 
+  - type: DefinitionList
+    content:
+      - term:
+          code: content
+          after: "(string, required)"
+        details:
+          type: Markdown
+          content: "The HTML string to render (can use template values)."
+      - term:
+          code: htmlTagAllowList
+          after: "(array, optional)"
+        details: List of allowed tags (overrides default).
+      - term:
+          code: additionalAllowedTags
+          after: "(array, optional)"
+        details: Tags to add to the allowlist.
+
+  - type: Markdown
+    content: |
       **Default allowed tags:** abbr, acronym, b, blockquote, br, caption, code, div, em, h1-h6, i, li, ol, p, span, sup, strong, table, tbody, td, tfoot, th, thead, tr, ul
 
   - type: RjBuildDescriber
@@ -31,7 +47,7 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Only allowed tags are rendered; all others are stripped
-      - No support for custom attributes or inline styles
-      - No script, style, or event attributes are executed
-      - Not suitable for rendering untrusted HTML with complex requirements
+      - Only allowed tags are rendered; all others are stripped.
+      - No support for custom attributes or inline styles.
+      - No script, style, or event attributes are executed.
+      - Not suitable for rendering untrusted HTML with complex requirements.

package/public/rjbuild/docs/core/element/html/SortableTreeItemCollapseButton.yaml

@@ -11,11 +11,12 @@ renderView:
       disappearance of the default collapse button.
 
       ## Properties
-      No properties.
+
+      None.
 
       ## Technical Details
-      - Renders a button with CSS classes for styling
-      - Only appears when the tree item has children and supports collapsing
+      - Renders a button with CSS classes for styling.
+      - Only appears when the tree item has children and supports collapsing.
 
   - type: RjBuildDescriber
     title: "Interactive Example: Tree with a right aligned collapse button"
@@ -85,8 +86,8 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Only works within the template context of a `FolderSortableTree` item
-      - The button only appears when the tree item has children (`childCount > 0`)
-      - No customization of the collapse/expand behavior beyond what the underlying SortableTree provides
+      - Only works within the template context of a `FolderSortableTree` item.
+      - The button only appears when the tree item has children (`childCount > 0`).
+      - No customization of the collapse/expand behavior beyond what the underlying SortableTree provides.
       - The styling is controlled by the dnd-kit-sortable-tree CSS classes. You will need to provide CSS to override
         the default styling.

package/public/rjbuild/docs/core/element/html/SyntaxHighlighter.yaml

@@ -6,16 +6,52 @@ renderView:
       The `SyntaxHighlighter` component provides syntax highlighting for code snippets using the react-syntax-highlighter library. It supports multiple programming languages and themes, making it perfect for displaying formatted code in documentation or tutorials.
 
       ## Properties
-      - `content` (string, required): The code content to highlight (supports template evaluation)
-      - `language` (string, optional): Programming language for syntax highlighting (default: "text")
-      - `style` (object, optional): Custom style theme for highlighting (overrides automatic dark mode detection)
-      - `lightStyle` (object, optional): Style theme for light mode (supports template evaluation)
-      - `darkStyle` (object, optional): Style theme for dark mode (supports template evaluation)
-      - `showLineNumbers` (boolean, optional): Whether to display line numbers (default: false)
-      - `wrapLines` (boolean, optional): Whether to wrap lines (default: false)
-      - `wrapLongLines` (boolean, optional): Whether to wrap long lines (default: false)
-      - `attributes` (object, optional): HTML attributes for the wrapper div
 
+  - type: DefinitionList
+    content:
+      - term:
+          code: content
+          after: "(string, required)"
+        details:
+          type: Markdown
+          content: "The code content to highlight (supports template evaluation)."
+      - term:
+          code: language
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "Programming language for syntax highlighting (default: `text`)."
+      - term:
+          code: style
+          after: "(object, optional)"
+        details: Custom style theme for highlighting (overrides automatic dark mode detection).
+      - term:
+          code: lightStyle
+          after: "(object, optional)"
+        details: Style theme for light mode (supports template evaluation).
+      - term:
+          code: darkStyle
+          after: "(object, optional)"
+        details: Style theme for dark mode (supports template evaluation).
+      - term:
+          code: showLineNumbers
+          after: "(boolean, optional)"
+        details: Whether to display line numbers (default: false).
+      - term:
+          code: wrapLines
+          after: "(boolean, optional)"
+        details: Whether to wrap lines (default: false).
+      - term:
+          code: wrapLongLines
+          after: "(boolean, optional)"
+        details: Whether to wrap long lines (default: false).
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: HTML attributes for the wrapper div.
+
+  - type: Markdown
+    content: |
       **Automatic Dark Mode**: The component automatically detects the user's color scheme preference and uses appropriate themes:
       - Light mode: `docco` theme by default
       - Dark mode: `atomOneDark` theme by default
@@ -230,9 +266,9 @@ renderView:
       The component automatically adapts to the user's system color scheme preference:
       
       ### Automatic Theme Detection
-      - **Light mode**: Uses the `docco` theme by default (clean, minimal highlighting)
-      - **Dark mode**: Uses the `atomOneDark` theme by default (modern dark theme with good contrast)
-      - **Real-time switching**: Themes change instantly when the user switches their system preference
+      - **Light mode**: Uses the `docco` theme by default (clean, minimal highlighting).
+      - **Dark mode**: Uses the `atomOneDark` theme by default (modern dark theme with good contrast).
+      - **Real-time switching**: Themes change instantly when the user switches their system preference.
       
       ### Custom Theme Configuration
       
@@ -261,10 +297,10 @@ renderView:
       ## Styling and Themes
       
       The component supports all react-syntax-highlighter themes. The style can be:
-      - A static style object imported from react-syntax-highlighter themes
-      - A template-evaluated value from your data context
-      - Any valid react-syntax-highlighter style configuration
-      - Different themes for light and dark modes using `lightStyle` and `darkStyle` properties
+      - A static style object imported from react-syntax-highlighter themes.
+      - A template-evaluated value from your data context.
+      - Any valid react-syntax-highlighter style configuration.
+      - Different themes for light and dark modes using `lightStyle` and `darkStyle` properties.
 
   - type: Markdown
     content: |
@@ -287,7 +323,7 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - Style themes must be compatible with react-syntax-highlighter
-      - Large code blocks may impact performance
-      - Line numbers display depends on the chosen theme
-      - Custom syntax definitions are not supported through the template system 
+      - Style themes must be compatible with react-syntax-highlighter.
+      - Large code blocks may impact performance.
+      - Line numbers display depends on the chosen theme.
+      - Custom syntax definitions are not supported through the template system.

package/public/rjbuild/docs/core/element/html/Tabs.yaml

@@ -6,13 +6,22 @@ renderView:
       The `Tabs` component provides a tabbed interface using React-Bootstrap. Each tab must have a unique `eventKey` and a `title` in its attributes, and can contain any valid Reactive-JSON view content.
 
       ## Properties
-      - `tabs` (array, required): Static array of tab objects. This array is not evaluated by the template system and must be defined statically in the schema.
-        - Each tab object must have:
-          - `attributes` (object, required):
-            - `title` (string, required): The label of the tab
-            - `eventKey` (string, required): A unique identifier for the tab
-            - Other attributes are passed to the React-Bootstrap Tab component
-          - `content` (array/object, required): The content to display in the tab. Can be any valid Reactive-JSON view (components, arrays, templates, etc.)
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: tabs
+          after: "(array, required)"
+        details:
+          type: Markdown
+          content: |
+            Static array of tab objects. This array is not evaluated by the template system and must be defined statically in the schema.
+            Each tab object must have:
+            - `attributes` (object, required):
+              - `title` (string, required): The label of the tab.
+              - `eventKey` (string, required): A unique identifier for the tab.
+              - Other attributes are passed to the React-Bootstrap Tab component.
+            - `content` (array|object, required): The content to display in the tab. Can be any valid Reactive-JSON view (components, arrays, templates, etc.)
 
   - type: RjBuildDescriber
     title: "Interactive Example: Editable tabs"
@@ -47,11 +56,11 @@ renderView:
   - type: Markdown
     content: |
       ## Limitations
-      - The `tabs` array must be static in the schema (no dynamic generation or template evaluation)
-      - Each tab must have a unique `eventKey` in its attributes
-      - The `title` attribute is required for each tab
-      - No support for dynamic addition/removal of tabs at runtime
-      - No built-in support for icons in tab headers
-      - No animation customization beyond what react-bootstrap provides
-      - All tab content is rendered at once (not lazy-loaded)
-      - Tab selection state is not persisted between renders
+      - The `tabs` array must be static in the schema (no dynamic generation or template evaluation).
+      - Each tab must have a unique `eventKey` in its attributes.
+      - The `title` attribute is required for each tab.
+      - No support for dynamic addition/removal of tabs at runtime.
+      - No built-in support for icons in tab headers.
+      - No animation customization beyond what react-bootstrap provides.
+      - All tab content is rendered at once (not lazy-loaded).
+      - Tab selection state is not persisted between renders.

package/public/rjbuild/docs/core/element/special/BootstrapElement.md

@@ -1,7 +1,5 @@
 # BootstrapElement
 
-## Introduction
-
 The `BootstrapElement` component is an internal wrapper used by Reactive-JSON to integrate React-Bootstrap components into the template system.
 
 **You should not use this component directly in your rjbuild.**
@@ -9,9 +7,9 @@ The `BootstrapElement` component is an internal wrapper used by Reactive-JSON to
 It is automatically used by higher-level components (such as BsAccordion, BsAlert, etc.) to provide Bootstrap features in a declarative way.
 
 ## Properties
-- `attributes` (object, optional): Attributes passed to the underlying Bootstrap component
-- `content` (object/array, optional): Content to render inside the Bootstrap component
+- `attributes` (object, optional): Attributes passed to the underlying Bootstrap component.
+- `content` (object/array, optional): Content to render inside the Bootstrap component.
 
 ## Limitations
-- Not intended for direct use in rjbuild templates
-- Used internally by the system for Bootstrap integration 
+- Not intended for direct use in rjbuild templates.
+- Used internally by the system for Bootstrap integration.

package/public/rjbuild/docs/core/element/special/BootstrapElement.yaml

@@ -10,9 +10,20 @@ renderView:
       It is automatically used by higher-level components (such as BsAccordion, BsAlert, etc.) to provide Bootstrap features in a declarative way.
 
       ## Properties
-      - `attributes` (object, optional): Attributes passed to the underlying Bootstrap component
-      - `content` (object/array, optional): Content to render inside the Bootstrap component
 
+  - type: DefinitionList
+    content:
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Attributes passed to the underlying Bootstrap component."
+      - term:
+          code: content
+          after: "(object|array, optional)"
+        details: "Content to render inside the Bootstrap component."
+
+  - type: Markdown
+    content: |
       ## Limitations
-      - Not intended for direct use in rjbuild templates
-      - Used internally by the system for Bootstrap integration 
+      - Not intended for direct use in rjbuild templates.
+      - Used internally by the system for Bootstrap integration.

package/public/rjbuild/docs/core/element/special/Count.md

@@ -1,18 +1,16 @@
 # Count
 
-## Introduction
-
 The `Count` component returns the number of items matching a JSONPath pattern in the data context. It is useful for displaying counts of elements, such as the number of items in a list, matching a filter, or present in a subtree.
 
 ## Properties
-- `jsonPathPattern` (string, required): The JSONPath pattern to evaluate for counting
+- `jsonPathPattern` (string, required): The JSONPath pattern to evaluate for counting.
 - `context` (string, optional): The context to use for evaluation (`global`, `template`, or `root`). Default is `global`.
 
 ## Behavior
-- Evaluates the given JSONPath pattern on the selected data context
-- Returns the number of matches found
-- If `context` is `global`, uses the global data context; if `template`, uses the template context; if `root`, uses the root context
-- If `jsonPathPattern` is not provided, renders nothing
+- Evaluates the given JSONPath pattern on the selected data context.
+- Returns the number of matches found.
+- If `context` is `global`, uses the global data context; if `template`, uses the template context; if `root`, uses the root context.
+- If `jsonPathPattern` is not provided, renders nothing.
 
 ## Example
 ```yaml
@@ -32,6 +30,6 @@ data:
 ```
 
 ## Limitations
-- Only supports JSONPath patterns
-- Returns 0 if no match or if the pattern is invalid
-- Does not support advanced filtering or custom functions in JSONPath 
+- Only supports JSONPath patterns.
+- Returns 0 if no match or if the pattern is invalid.
+- Does not support advanced filtering or custom functions in JSONPath.

package/public/rjbuild/docs/core/element/special/Count.yaml

@@ -6,14 +6,27 @@ renderView:
       The `Count` component returns the number of items matching a JSONPath pattern in the data context. It is useful for displaying counts of elements, such as the number of items in a list, matching a filter, or present in a subtree.
 
       ## Properties
-      - `jsonPathPattern` (string, required): The JSONPath pattern to evaluate for counting
-      - `context` (string, optional): The context to use for evaluation (`global`, `template`, or `root`). Default is `global`.
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: jsonPathPattern
+          after: "(string, required)"
+        details:
+          type: Markdown
+          content: "The JSONPath pattern to evaluate for counting."
+      - term:
+          code: context
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "The context to use for evaluation (`global`, `template`, or `root`). Default is `global`."
 
       ## Behavior
-      - Evaluates the given JSONPath pattern on the selected data context
-      - Returns the number of matches found
-      - If `context` is `global`, uses the global data context; if `template`, uses the template context; if `root`, uses the root context
-      - If `jsonPathPattern` is not provided, renders nothing
+      - Evaluates the given JSONPath pattern on the selected data context.
+      - Returns the number of matches found.
+      - If `context` is `global`, uses the global data context; if `template`, uses the template context; if `root`, uses the root context.
+      - If `jsonPathPattern` is not provided, renders nothing.
 
   - type: RjBuildDescriber
     title: "Example"
@@ -320,6 +333,6 @@ renderView:
       - `$..products` - Count all products at any level (recursive)
 
       ## Limitations
-      - Only supports JSONPath patterns
-      - Returns 0 if no match or if the pattern is invalid
-      - Does not support advanced filtering or custom functions in JSONPath 
+      - Only supports JSONPath patterns.
+      - Returns 0 if no match or if the pattern is invalid.
+      - Does not support advanced filtering or custom functions in JSONPath.