@ea-lab/reactive-json-docs 0.7.0 → 1.0.0-alpha.0

package/public/rjbuild/docs/install.md

@@ -12,22 +12,22 @@ Adapt commands according to the execution environment (Windows, Ubuntu, Mac...).
 
 ## Table of Contents
 
-1. [Project Directory Confirmation](#1-project-directory-confirmation)
-2. [Collecting User Information](#2-collecting-user-information)
-3. [Documentation Repositories Setup](#3-documentation-repositories-setup)
-4. [Cursor Workspace Configuration](#4-cursor-workspace-configuration)
-5. [Vite Project Initialization](#5-vite-project-initialization)
-6. [Project Structure Verification](#6-project-structure-verification)
-7. [Dependencies Installation](#7-dependencies-installation)
-8. [Cursor Project Rules Creation](#8-cursor-project-rules-creation)
-9. [Generated Project Cleanup](#9-generated-project-cleanup)
-10. [Basic Configuration with ReactiveJsonRoot](#10-basic-configuration-with-reactivejsonroot)
-11. [Routing Configuration (Optional)](#11-routing-configuration-optional)
-12. [Final Verification](#12-final-verification)
+1. [Project Directory Confirmation](#project-directory-confirmation)
+2. [Collecting User Information](#collecting-user-information)
+3. [Documentation Repositories Setup](#documentation-repositories-setup)
+4. [Cursor Workspace Configuration](#cursor-workspace-configuration)
+5. [Vite Project Initialization](#vite-project-initialization)
+6. [Project Structure Verification](#project-structure-verification)
+7. [Dependencies Installation](#dependencies-installation)
+8. [Cursor Project Rules Creation](#cursor-project-rules-creation)
+9. [Generated Project Cleanup](#generated-project-cleanup)
+10. [Basic Configuration with ReactiveJsonRoot](#basic-configuration-with-reactivejsonroot)
+11. [Routing Configuration (Optional)](#routing-configuration-optional)
+12. [Final Verification](#final-verification)
 
 ## Chronological Steps
 
-### 1. Project Directory Confirmation
+### Project Directory Confirmation
 
 **Action:** Show the user if the IDE is opened in the directory where the project will
 be initialized, then ask for confirmation:
@@ -51,7 +51,7 @@ be initialized, then ask for confirmation:
 
 ---
 
-### 2. Collecting User Information
+### Collecting User Information
 
 **Action:** Ask the user for the following information:
 
@@ -70,7 +70,7 @@ When invalid, ask again the location with valid suggestions.
 
 ---
 
-### 3. Documentation Repositories Setup
+### Documentation Repositories Setup
 
 **Action:** Clone the required documentation repositories
 
@@ -89,7 +89,7 @@ git clone https://github.com/Ealab-collab/reactive-json-docs.git
 
 ---
 
-### 4. Cursor Workspace Configuration
+### Cursor Workspace Configuration
 
 **Action:** Ask the user to add repositories to the workspace
 
@@ -107,7 +107,7 @@ git clone https://github.com/Ealab-collab/reactive-json-docs.git
 
 ---
 
-### 5. Vite Project Initialization
+### Vite Project Initialization
 
 **Action:** Create the project with Vite in the current directory
 
@@ -126,7 +126,7 @@ npm create vite@latest . -- --template react
 
 ---
 
-### 6. Project Structure Verification
+### Project Structure Verification
 
 **Action:** Verify the project structure is correct
 
@@ -157,7 +157,7 @@ ls -la
 
 ---
 
-### 7. Dependencies Installation
+### Dependencies Installation
 
 **Action:** Install required packages
 
@@ -165,12 +165,12 @@ ls -la
 
 ```bash
 npm install
-npm install @ea-lab/reactive-json bootstrap react-bootstrap axios clsx dnd-kit-sortable-tree html-react-parser js-yaml jsonpath lodash
+npm install @ea-lab/reactive-json axios clsx dnd-kit-sortable-tree html-react-parser js-yaml jsonpath lodash
 ```
 
 ---
 
-### 8. Cursor Project Rules Creation
+### Cursor Project Rules Creation
 
 **Action:** Copy Cursor rules from documentation repositories
 
@@ -200,7 +200,7 @@ These rules contain all the necessary directives to work effectively with reacti
 
 ---
 
-### 9. Generated Project Cleanup
+### Generated Project Cleanup
 
 **Action:** Remove/clean files generated by Vite
 
@@ -218,8 +218,7 @@ These rules contain all the necessary directives to work effectively with reacti
 import React from 'react'
 import ReactDOM from 'react-dom/client'
 import App from './App.tsx'
-// Import Bootstrap styles for reactive-json
-import 'bootstrap/dist/css/bootstrap.min.css'
+// Import global CSS here if needed
 
 ReactDOM.createRoot(document.getElementById('root')!).render(
   <App />
@@ -230,7 +229,7 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
 
 ---
 
-### 10. Basic Configuration with ReactiveJsonRoot
+### Basic Configuration with ReactiveJsonRoot
 
 **Action:** Configure the base component with an external YAML file
 
@@ -240,7 +239,6 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
 
 ```javascript
 import { ReactiveJsonRoot } from '@ea-lab/reactive-json'
-import 'bootstrap/dist/css/bootstrap.min.css'
 
 function App() {
   return <ReactiveJsonRoot rjBuildUrl="/config.yaml" rjBuildFetchMethod="GET" />
@@ -259,7 +257,7 @@ renderView:
 
 ---
 
-### 11. Routing Configuration (Optional)
+### Routing Configuration (Optional)
 
 **Action:** Ask the user if they want to add routing for application organization
 
@@ -335,7 +333,6 @@ import { BrowserRouter as Router, Routes, Route } from 'react-router-dom'
 import { ReactiveJsonRoot } from '@ea-lab/reactive-json'
 import { routeMapping } from './config/routes'
 import Navigation from './components/Navigation'
-import 'bootstrap/dist/css/bootstrap.min.css'
 
 function App() {
   return (
@@ -385,7 +382,7 @@ renderView:
 
 ---
 
-### 12. Final Verification
+### Final Verification
 
 **Action:** Launch development server
 

package/public/rjbuild/docs/install.yaml

@@ -188,7 +188,7 @@ renderView:
       npm install
 
       # Install Reactive-JSON and required packages
-      npm install @ea-lab/reactive-json bootstrap react-bootstrap axios clsx dnd-kit-sortable-tree html-react-parser js-yaml jsonpath lodash
+      npm install @ea-lab/reactive-json axios clsx dnd-kit-sortable-tree html-react-parser js-yaml jsonpath lodash
 
   - type: Markdown
     content: |
@@ -244,7 +244,6 @@ renderView:
       import React from 'react'
       import ReactDOM from 'react-dom/client'
       import App from './App.tsx'
-      import 'bootstrap/dist/css/bootstrap.min.css'
 
       ReactDOM.createRoot(document.getElementById('root')!).render(
         <App />
@@ -262,7 +261,6 @@ renderView:
     language: typescript
     content: |
       import { ReactiveJsonRoot } from '@ea-lab/reactive-json'
-      import 'bootstrap/dist/css/bootstrap.min.css'
 
       function App() {
         return <ReactiveJsonRoot rjBuildUrl="/config.yaml" rjBuildFetchMethod="GET" />
@@ -371,7 +369,6 @@ renderView:
       import { ReactiveJsonRoot } from '@ea-lab/reactive-json'
       import { routeMapping } from './config/routes'
       import Navigation from './components/Navigation'
-      import 'bootstrap/dist/css/bootstrap.min.css'
 
       function App() {
         return (
@@ -456,7 +453,7 @@ renderView:
 
       - If you see errors, check that all dependencies are installed correctly
       - Ensure the `public/config.yaml` file exists
-      - Verify that Bootstrap CSS is imported
+      - Verify that required CSS is imported (if any)
       - Check browser console for any JavaScript errors
 
       ---
@@ -644,7 +641,7 @@ templates:
 
           ```bash
           npm install
-          npm install @ea-lab/reactive-json bootstrap react-bootstrap axios clsx dnd-kit-sortable-tree html-react-parser js-yaml jsonpath lodash
+          npm install @ea-lab/reactive-json axios clsx dnd-kit-sortable-tree html-react-parser js-yaml jsonpath lodash
           ```
 
           ---
@@ -697,8 +694,7 @@ templates:
           import React from 'react'
           import ReactDOM from 'react-dom/client'
           import App from './App.tsx'
-          // Import Bootstrap styles for reactive-json
-          import 'bootstrap/dist/css/bootstrap.min.css'
+          // Import global CSS here if needed.
 
           ReactDOM.createRoot(document.getElementById('root')!).render(
             <App />
@@ -719,7 +715,6 @@ templates:
 
           ```javascript
           import { ReactiveJsonRoot } from '@ea-lab/reactive-json'
-          import 'bootstrap/dist/css/bootstrap.min.css'
 
           function App() {
             return <ReactiveJsonRoot rjBuildUrl="/config.yaml" rjBuildFetchMethod="GET" />
@@ -814,7 +809,6 @@ templates:
           import { ReactiveJsonRoot } from '@ea-lab/reactive-json'
           import { routeMapping } from './config/routes'
           import Navigation from './components/Navigation'
-          import 'bootstrap/dist/css/bootstrap.min.css'
 
           function App() {
             return (

package/public/rjbuild/docs/integration/bootstrap/action/Popover.md

@@ -0,0 +1,26 @@
+# Popover
+
+Displays a Bootstrap popover on click or hover of the element.
+
+## Properties
+- `header` (optional): Content of the popover header.
+- `body`: Content of the popover body.
+- `placement` (optional): Position (`top`, `bottom`, `left`, `right`).
+- `trigger` (optional): Trigger event (`click`, `hover`, etc.).
+
+## Example
+```yaml
+renderView:
+  - type: button
+    content: "Click me"
+    actions:
+      - what: popover
+        header: "Popover Title"
+        body: "This is the popover content."
+        placement: right
+        trigger: click
+```
+
+## Limitation
+- Requires the Bootstrap integration plugin (`@ea-lab/reactive-json-bootstrap`).
+- The child component must be able to accept a React reference. 

package/public/rjbuild/docs/{core → integration/bootstrap}/action/Popover.yaml

@@ -3,13 +3,36 @@ renderView:
     content: |
       # Popover
 
-      **Description**: Displays a Bootstrap popover on click or hover of the element.
+      Displays a Bootstrap popover on click or hover of the element.
 
       ## Properties
-      - `header` (optional): content of the popover header
-      - `body`: content of the popover body
-      - `placement` (optional): position (`top`, `bottom`, `left`, `right`)
-      - `trigger` (optional): trigger event (`click`, `hover`, etc.)
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: header
+          after: "(optional)"
+        details:
+          type: Markdown
+          content: "Content of the popover header."
+      - term:
+          code: body
+          after: "(required)"
+        details:
+          type: Markdown
+          content: "Content of the popover body."
+      - term:
+          code: placement
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "Position (`top`, `bottom`, `left`, `right`)."
+      - term:
+          code: trigger
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "Trigger event (`click`, `hover`, etc.)."
 
   - type: RjBuildDescriber
     title: "Popover Action Example"

package/public/rjbuild/docs/{core → integration/bootstrap}/action/Tooltip.md

@@ -1,10 +1,10 @@
 # Tooltip
 
-**Description**: Displays a Bootstrap tooltip when hovering over the element.
+Displays a Bootstrap tooltip when hovering over the element.
 
 ## Properties
-- `content`: tooltip content (text or component)
-- `placement` (optional): tooltip position (`top`, `bottom`, `left`, `right`)
+- `content`: Tooltip content (text or component).
+- `placement` (optional): Tooltip position (`top`, `bottom`, `left`, `right`).
 
 ## Example
 ```yaml
@@ -18,5 +18,5 @@ renderView:
 ```
 
 ## Limitation
-- Requires Bootstrap CSS.
+- Requires the Bootstrap integration plugin (`@ea-lab/reactive-json-bootstrap`).
 - The child component must be able to accept a React reference. 

package/public/rjbuild/docs/{core → integration/bootstrap}/action/Tooltip.yaml

@@ -3,11 +3,24 @@ renderView:
     content: |
       # Tooltip
 
-      **Description**: Displays a Bootstrap tooltip when hovering over the element.
+      Displays a Bootstrap tooltip when hovering over the element.
 
       ## Properties
-      - `content`: tooltip content (text or component)
-      - `placement` (optional): tooltip position (`top`, `bottom`, `left`, `right`)
+
+  - type: DefinitionList
+    content:
+      - term:
+          code: content
+          after: "(required)"
+        details:
+          type: Markdown
+          content: "Tooltip content (text or component)."
+      - term:
+          code: placement
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "Tooltip position (`top`, `bottom`, `left`, `right`)."
 
   - type: RjBuildDescriber
     title: "Tooltip Action Example"

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/CheckBoxField.md

@@ -4,14 +4,14 @@ The `CheckBoxField` component renders checkbox or radio button groups using Reac
 
 ## Properties
 
-- `dataLocation` (string, optional): Path to bind the field value in the data context
-- `defaultFieldValue` (any, optional): Default value when no data is present
-- `options` (array, optional): Static array of option objects with `label` and `value` properties
-- `dynamicOptions` (string, optional): Template path to dynamic options array
-- `controlType` (string, optional): Type of control - "checkbox" (default) or "radio"
-- `multiple` (boolean, optional): Force array storage for checkboxes (default: auto-detected)
-- `attributes` (object, optional): Attributes applied to the Form.Group container
-- `actions` (array, optional): Actions to execute based on field state
+- `dataLocation` (string, optional): Path to bind the field value in the data context.
+- `defaultFieldValue` (any, optional): Default value when no data is present.
+- `options` (array, optional): Static array of option objects with `label` and `value` properties.
+- `dynamicOptions` (string, optional): Template path to dynamic options array.
+- `controlType` (string, optional): Type of control - "checkbox" (default) or "radio".
+- `multiple` (boolean, optional): Force array storage for checkboxes (default: auto-detected).
+- `attributes` (object, optional): Attributes applied to the Form.Group container.
+- `actions` (array, optional): Actions to execute based on field state.
 
 ## Option Format
 

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/CheckBoxField.yaml

@@ -7,15 +7,47 @@ renderView:
 
       ## Properties
 
-      - `dataLocation` (string, optional): Path to bind the field value in the data context
-      - `defaultFieldValue` (any, optional): Default value when no data is present
-      - `options` (array, optional): Static array of option objects with `label` and `value` properties
-      - `dynamicOptions` (string, optional): Template path to dynamic options array
-      - `controlType` (string, optional): Type of control - "checkbox" (default) or "radio"
-      - `multiple` (boolean, optional): Force array storage for checkboxes (default: auto-detected)
-      - `attributes` (object, optional): Attributes applied to the Form.Group container
-      - `actions` (array, optional): Actions to execute based on field state
+  - type: DefinitionList
+    content:
+      - term:
+          code: dataLocation
+          after: "(string, optional)"
+        details: "Path to bind the field value in the data context."
+      - term:
+          code: defaultFieldValue
+          after: "(any, optional)"
+        details: "Default value when no data is present."
+      - term:
+          code: options
+          after: "(array, optional)"
+        details:
+          type: Markdown
+          content: "Static array of option objects with `label` and `value` properties."
+      - term:
+          code: dynamicOptions
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "Template path to dynamic options array."
+      - term:
+          code: controlType
+          after: "(string, optional)"
+        details: "Type of control - `checkbox` (default) or `radio`."
+      - term:
+          code: multiple
+          after: "(boolean, optional)"
+        details: "Force array storage for checkboxes (default: auto-detected)."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Attributes applied to the Form.Group container."
+      - term:
+          code: actions
+          after: "(array, optional)"
+        details: "Actions to execute based on field state."
 
+  - type: Markdown
+    content: |
       ## Option Format
 
       Each option object must have:

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/DateField.md

@@ -7,11 +7,11 @@ The `DateField` component renders a date and time input field using React Bootst
 
 ## Properties
 
-- `dataLocation` (string, optional): Path to bind the field value in the data context
-- `defaultFieldValue` (string, optional): Default value when no data is present
-- `label` (string, optional): Field label text
-- `attributes` (object, optional): Attributes applied to the Form.Group container
-- `actions` (array, optional): Actions to execute based on field state. Supports both actions (hide, tooltip, etc.) and conditional reactions (setData, fetchData, etc.) with full conditional logic support
+- `dataLocation` (string, optional): Path to bind the field value in the data context.
+- `defaultFieldValue` (string, optional): Default value when no data is present.
+- `label` (string, optional): Field label text.
+- `attributes` (object, optional): Attributes applied to the Form.Group container.
+- `actions` (array, optional): Actions to execute based on field state. Supports both actions (hide, tooltip, etc.) and conditional reactions (setData, fetchData, etc.) with full conditional logic support.
 
 ## Data Management
 

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/DateField.yaml

@@ -10,12 +10,34 @@ renderView:
 
       ## Properties
 
-      - `dataLocation` (string, optional): Path to bind the field value in the data context
-      - `defaultFieldValue` (string, optional): Default value when no data is present
-      - `label` (string, optional): Field label text
-      - `attributes` (object, optional): Attributes applied to the Form.Group container
-      - `actions` (array, optional): Actions to execute based on field state. Supports both actions (hide, tooltip, etc.) and conditional reactions (setData, fetchData, etc.) with full conditional logic support
+  - type: DefinitionList
+    content:
+      - term:
+          code: dataLocation
+          after: "(string, optional)"
+        details: Path to bind the field value in the data context.
+      - term:
+          code: defaultFieldValue
+          after: "(string, optional)"
+        details: Default value when no data is present.
+      - term:
+          code: label
+          after: "(string, optional)"
+        details: Field label text.
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: Attributes applied to the Form.Group container.
+      - term:
+          code: actions
+          after: "(array, optional)"
+        details:
+          type: Markdown
+          content: |
+            Actions to execute based on field state. Supports both actions (hide, tooltip, etc.) and conditional reactions (setData, fetchData, etc.) with full conditional logic support.
 
+  - type: Markdown
+    content: |
       ## Data Management
 
       The component automatically synchronizes its value with the global data context as an ISO 8601 datetime string format (YYYY-MM-DDTHH:mm). When using `dataLocation`, the value is stored at the specified path. Without `dataLocation`, the value is stored in the template context using the component's `datafield`.

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/NumberField.md

@@ -4,13 +4,13 @@ The `NumberField` component renders a numeric input field using React Bootstrap.
 
 ## Properties
 
-- `dataLocation` (string, optional): Path to bind the field value in the data context
-- `defaultFieldValue` (number, optional): Default value when no data is present
-- `label` (string, optional): Field label text (supports template evaluation)
-- `placeholder` (string, optional): Placeholder text (supports template evaluation)
-- `attributes` (object, optional): Attributes applied to the Form.Group container
-- `inputAttributes` (object, optional): Attributes applied directly to the input element
-- `actions` (array, optional): Actions to execute based on field state
+- `dataLocation` (string, optional): Path to bind the field value in the data context.
+- `defaultFieldValue` (number, optional): Default value when no data is present.
+- `label` (string, optional): Field label text (supports template evaluation).
+- `placeholder` (string, optional): Placeholder text (supports template evaluation).
+- `attributes` (object, optional): Attributes applied to the Form.Group container.
+- `inputAttributes` (object, optional): Attributes applied directly to the input element.
+- `actions` (array, optional): Actions to execute based on field state.
 
 ## Data Management
 

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/NumberField.yaml

@@ -7,14 +7,39 @@ renderView:
 
       ## Properties
 
-      - `dataLocation` (string, optional): Path to bind the field value in the data context
-      - `defaultFieldValue` (number, optional): Default value when no data is present
-      - `label` (string, optional): Field label text (supports template evaluation)
-      - `placeholder` (string, optional): Placeholder text (supports template evaluation)
-      - `attributes` (object, optional): Attributes applied to the Form.Group container
-      - `inputAttributes` (object, optional): Attributes applied directly to the input element
-      - `actions` (array, optional): Actions to execute based on field state
+  - type: DefinitionList
+    content:
+      - term:
+          code: dataLocation
+          after: "(string, optional)"
+        details: "Path to bind the field value in the data context."
+      - term:
+          code: defaultFieldValue
+          after: "(number, optional)"
+        details: "Default value when no data is present."
+      - term:
+          code: label
+          after: "(string, optional)"
+        details: "Field label text (supports template evaluation)."
+      - term:
+          code: placeholder
+          after: "(string, optional)"
+        details: "Placeholder text (supports template evaluation)."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Attributes applied to the Form.Group container."
+      - term:
+          code: inputAttributes
+          after: "(object, optional)"
+        details: "Attributes applied directly to the input element."
+      - term:
+          code: actions
+          after: "(array, optional)"
+        details: "Actions to execute based on field state."
 
+  - type: Markdown
+    content: |
       ## Data Management
 
       The component stores the input value as a string in the data context. The browser's number input provides built-in validation, but the value should be converted to a number when needed for calculations.

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/SelectField.md

@@ -4,15 +4,15 @@ The `SelectField` component renders a dropdown selection field using React Boots
 
 ## Properties
 
-- `dataLocation` (string, optional): Path to bind the field value in the data context
-- `defaultFieldValue` (any, optional): Default value when no data is present
-- `label` (string, optional): Field label text (supports template evaluation)
-- `options` (array, optional): Static array of option objects with `label` and `value` properties
-- `dynamicOptions` (string, optional): Template path to dynamic options array
-- `allowEmptyStringAsValue` (boolean, optional): Preserve empty strings as `""` instead of converting to `undefined` (default: false)
-- `attributes` (object, optional): Attributes applied to the Form.Group container
-- `inputAttributes` (object, optional): Attributes applied directly to the select element
-- `actions` (array, optional): Actions to execute based on field state
+- `dataLocation` (string, optional): Path to bind the field value in the data context.
+- `defaultFieldValue` (any, optional): Default value when no data is present.
+- `label` (string, optional): Field label text (supports template evaluation).
+- `options` (array, optional): Static array of option objects with `label` and `value` properties.
+- `dynamicOptions` (string, optional): Template path to dynamic options array.
+- `allowEmptyStringAsValue` (boolean, optional): Preserve empty strings as `""` instead of converting to `undefined` (default: false).
+- `attributes` (object, optional): Attributes applied to the Form.Group container.
+- `inputAttributes` (object, optional): Attributes applied directly to the select element.
+- `actions` (array, optional): Actions to execute based on field state.
 
 ## Option Format
 

package/public/rjbuild/docs/{core → integration/bootstrap}/element/form/SelectField.yaml

@@ -7,16 +7,53 @@ renderView:
 
       ## Properties
 
-      - `dataLocation` (string, optional): Path to bind the field value in the data context
-      - `defaultFieldValue` (any, optional): Default value when no data is present
-      - `label` (string, optional): Field label text (supports template evaluation)
-      - `options` (array, optional): Static array of option objects with `label` and `value` properties
-      - `dynamicOptions` (string, optional): Template path to dynamic options array
-      - `allowEmptyStringAsValue` (boolean, optional): Preserve empty strings as `""` instead of converting to `undefined` (default: false)
-      - `attributes` (object, optional): Attributes applied to the Form.Group container
-      - `inputAttributes` (object, optional): Attributes applied directly to the select element
-      - `actions` (array, optional): Actions to execute based on field state
+  - type: DefinitionList
+    content:
+      - term:
+          code: dataLocation
+          after: "(string, optional)"
+        details: "Path to bind the field value in the data context."
+      - term:
+          code: defaultFieldValue
+          after: "(any, optional)"
+        details: "Default value when no data is present."
+      - term:
+          code: label
+          after: "(string, optional)"
+        details: "Field label text (supports template evaluation)."
+      - term:
+          code: options
+          after: "(array, optional)"
+        details:
+          type: Markdown
+          content: "Static array of option objects with `label` and `value` properties."
+      - term:
+          code: dynamicOptions
+          after: "(string, optional)"
+        details:
+          type: Markdown
+          content: "Template path to dynamic options array."
+      - term:
+          code: allowEmptyStringAsValue
+          after: "(boolean, optional)"
+        details:
+          type: Markdown
+          content: "Preserve empty strings as `\"\"` instead of converting to `undefined` (default: false)."
+      - term:
+          code: attributes
+          after: "(object, optional)"
+        details: "Attributes applied to the Form.Group container."
+      - term:
+          code: inputAttributes
+          after: "(object, optional)"
+        details: "Attributes applied directly to the select element."
+      - term:
+          code: actions
+          after: "(array, optional)"
+        details: "Actions to execute based on field state."
 
+  - type: Markdown
+    content: |
       ## Option Format
 
       Each option object must have: