@fluentcommerce/ai-skills 0.2.0 → 0.3.0

package/content/dev/skills/fluent-mystique-builder/components/INDEX.md

@@ -0,0 +1,92 @@
+# Mystique Components Index
+
+AI lookup table for Mystique components, derived from component frontmatter (`alias`, `category`, `module`) and sorted alphabetically by alias.
+
+| Alias | Category | Module |
+| --- | --- | --- |
+| `fc.accordion` | layout | Core |
+| `fc.action.field.fulfilmentpack` | field | Store |
+| `fc.action.field.multiparcel` | field | Store |
+| `fc.action.field.returnitems` | field | Returns |
+| `fc.action.field.wavepick` | field | Store |
+| `fc.action.inline` | action | Core |
+| `fc.activity.entity` | content | OMS |
+| `fc.analytics.viz` | content | Analytics |
+| `fc.attribute.column` | content | Core |
+| `fc.attribute.json` | content | OMS |
+| `fc.attribute.jsoneditor` | content | Core |
+| `fc.attribute.locationId` | field | Core |
+| `fc.attribute.retailerId` | field | Core |
+| `fc.button.bar` | action | Core |
+| `fc.button.print` | action | Core |
+| `fc.button.print.download` | action | Core |
+| `fc.button.print.inline` | action | Core |
+| `fc.button.print.inline.compatibility` | action | OMS |
+| `fc.button.print.pick` | action | Store |
+| `fc.buttons.add.reject` | action | Store |
+| `fc.card.attribute` | content | Core |
+| `fc.card.attributes.grid` | content | Core |
+| `fc.card.image` | content | Core |
+| `fc.card.map.point` | content | OMS |
+| `fc.card.multi` | content | Core |
+| `fc.card.product` | content | Core |
+| `fc.chart.area` | content | Core |
+| `fc.chart.area.wrapper.feed` | wrapper | Core |
+| `fc.chart.bar` | content | Core |
+| `fc.chart.bar.wrapper.source` | wrapper | Core |
+| `fc.chart.gauge` | content | Core |
+| `fc.chart.gauge.wrapper.threshold` | wrapper | Core |
+| `fc.chart.line` | content | Core |
+| `fc.conditional` | layout | Core |
+| `fc.dashboard.threshold` | content | Core |
+| `fc.daterange.wrapper.forwarder` | filter | Core |
+| `fc.drawer.button` | action | Core |
+| `fc.event.detail` | content | OMS |
+| `fc.events.search` | content | OMS |
+| `fc.field.daterange` | field | Core |
+| `fc.field.filterComplex` | field | Core |
+| `fc.field.intrange` | field | Core |
+| `fc.field.multistring` | field | Core |
+| `fc.filterPanel` | filter | Core |
+| `fc.json.editor` | content | Core |
+| `fc.json.viewer` | content | Core |
+| `fc.list` | content | Core |
+| `fc.list.customAction` | content | Core |
+| `fc.list.wrapper.bppmetrics` | wrapper | Core |
+| `fc.list.wrapper.feed` | wrapper | Core |
+| `fc.list.wrapper.source` | wrapper | Core |
+| `fc.modal.button` | action | Core |
+| `fc.modal.button.addItem` | action | OMS |
+| `fc.mutation.inline` | action | Core |
+| `fc.mystique.collapsible.attributes` | content | Core |
+| `fc.mystique.collapsible.text` | content | Core |
+| `fc.mystique.link` | content | Core |
+| `fc.order.itemDetails` | content | OMS |
+| `fc.order.shipmentDetails` | content | OMS |
+| `fc.page` | page | Core |
+| `fc.page.filter.select` | layout | Core |
+| `fc.page.refresh` | page | Core |
+| `fc.page.section` | layout | Core |
+| `fc.page.section.column` | layout | Core |
+| `fc.page.section.header` | layout | Core |
+| `fc.page.wizard` | page | Core |
+| `fc.page.wizard.summary` | page | Core |
+| `fc.progress.circular` | content | Core |
+| `fc.provider.graphql` | content | Core |
+| `fc.quantity.list` | content | Core |
+| `fc.repeater` | layout | Core |
+| `fc.reports.ipuipc` | content | Analytics |
+| `fc.return.rowExpansion` | content | Returns |
+| `fc.scanner.barcode` | content | Core |
+| `fc.scanner.barcodeFilter` | content | Core |
+| `fc.scanner.camera` | content | Core |
+| `fc.settingForm` | content | Core |
+| `fc.sourcing.profile.drawer.button` | action | Core |
+| `fc.sourcing.profile.modal.button` | action | Core |
+| `fc.sourcing.strategy.modal.button` | action | Core |
+| `fc.stepper` | content | Core |
+| `fc.tab.content` | layout | Core |
+| `fc.tabs` | layout | Core |
+| `fc.tabs.card` | layout | Core |
+| `fc.tile.metric` | content | Core |
+| `fc.workflow.provider` | layout | Core |

package/content/dev/skills/fluent-mystique-builder/components/fc.accordion.md

@@ -0,0 +1,48 @@
+---
+alias: "fc.accordion"
+aliases:
+  - fc.accordion
+category: layout
+module: Core
+---
+# fc.accordion
+
+Expandable/collapsible Material-UI Accordion section.
+
+## When to Use
+- Secondary information that doesn't need to be visible by default
+- Long forms where sections can be collapsed
+- FAQ or documentation-style expandable sections
+
+## Key Props
+| Prop | Type | Required | What it controls |
+|------|------|----------|------------------|
+| `summary` | string / component[] | No | Always-visible header content |
+| `details` | string / component[] | No | Expandable body content |
+| `defaultExpanded` | boolean | No | Start expanded (default: false) |
+| `expanded` | boolean | No | Force open/closed |
+| `disabled` | boolean | No | Prevent interaction |
+| `expandIcon` | boolean | No | Show expand arrow (default: true) |
+
+## Data Binding
+Inherits parent data context.
+
+## Descendants
+Yes — rendered inside the expandable area.
+
+## Manifest Example
+```json
+{
+  "component": "fc.accordion",
+  "props": { "summary": "Advanced Details", "defaultExpanded": false },
+  "descendants": [
+    { "component": "fc.card.attribute", "props": { "attributes": [] } }
+  ]
+}
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.action.field.fulfilmentpack.md

@@ -0,0 +1,20 @@
+---
+alias: "fc.action.field.fulfilmentpack"
+aliases:
+  - fc.action.field.fulfilmentpack
+  - FULFILMENT_PACK
+category: field
+module: Store
+---
+# fc.action.field.fulfilmentpack
+
+Packing workflow field — confirm items packed and ready for dispatch.
+
+## When to Use
+- Pack confirmation step in fulfilment workflow
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.action.field.multiparcel.md

@@ -0,0 +1,21 @@
+---
+alias: "fc.action.field.multiparcel"
+aliases:
+  - fc.action.field.multiparcel
+  - MULTI_PARCEL_FIELD
+category: field
+module: Store
+---
+# fc.action.field.multiparcel
+
+Multi-parcel shipment management — split items across parcels with tracking numbers.
+
+## When to Use
+- Pack screen for multi-box shipments
+- Parcel splitting and tracking assignment
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.action.field.returnitems.md

@@ -0,0 +1,21 @@
+---
+alias: "fc.action.field.returnitems"
+aliases:
+  - fc.action.field.returnitems
+  - RETURN_ITEMS
+category: field
+module: Returns
+---
+# fc.action.field.returnitems
+
+Return items grid editor — select items and quantities to return.
+
+## When to Use
+- Return creation workflow
+- Item selection for return processing
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.action.field.wavepick.md

@@ -0,0 +1,21 @@
+---
+alias: "fc.action.field.wavepick"
+aliases:
+  - fc.action.field.wavepick
+  - PICKED_ITEMS
+category: field
+module: Store
+---
+# fc.action.field.wavepick
+
+Warehouse pick list interface showing items to pick with quantity fields and barcode scanning support.
+
+## When to Use
+- Warehouse wave picking workflow
+- Pick list display with scan input
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.action.inline.md

@@ -0,0 +1,24 @@
+---
+alias: "fc.action.inline"
+aliases:
+  - fc.action.inline
+category: action
+module: Core
+---
+# fc.action.inline
+
+Inline user action button that triggers workflow events on the current entity.
+
+## When to Use
+- Actions within content rather than the page header
+- Per-item actions in detail views
+- Confirm/Cancel buttons inline
+
+## Data Binding
+Operates on current entity in data context.
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.activity.entity.md

@@ -0,0 +1,25 @@
+---
+alias: "fc.activity.entity"
+aliases:
+  - fc.activity.entity
+category: content
+module: OMS
+---
+# fc.activity.entity
+
+Chronological timeline of all state changes and events for an entity.
+
+## When to Use
+- Entity detail page "Activity" tab
+- Audit trail for orders, fulfilments, etc.
+
+## Manifest Example
+```json
+{ "component": "fc.activity.entity" }
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.analytics.viz.md

@@ -0,0 +1,20 @@
+---
+alias: "fc.analytics.viz"
+aliases:
+  - fc.analytics.viz
+category: content
+module: Analytics
+---
+# fc.analytics.viz
+
+Embedded Looker analytics dashboard visualization.
+
+## When to Use
+- Analytics dashboard pages
+- Embedded BI reporting
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.attribute.column.md

@@ -0,0 +1,111 @@
+---
+alias: "fc.attribute.column"
+aliases:
+  - fc.attribute.column
+category: content
+module: Core
+---
+
+# fc.attribute.column
+
+Vertical content column that displays data values stacked in a list with optional colored status dots, expand/collapse for long lists, and sorting.
+
+## When to Use
+- Display multiple field values stacked vertically in a list column cell
+- Show a status indicator with a colored dot based on a setting
+- Render nested array data (e.g. `items[].ref`) as a vertical list within a table cell
+- Combine multiple named fields into a single column (e.g. name + ref + type)
+
+## Key Props
+| Prop | Type | Required | What it controls |
+|------|------|----------|------------------|
+| `value` | string \| Record<string, any>[] | Yes | Template string for array data mode (`"{{ref}}"`) or array of field descriptors for multi-field mode (see below) |
+| `minListSize` | number | No | Number of rows to show before "More" toggle. Default: `5`. Set to `0` or negative to disable truncation. |
+| `contentColumnSetting` | string | No | Setting key for colored dot configuration. When set, renders a colored status dot before the text based on matching value. |
+| `type` | DynamicAttributeType | No | Dynamic attribute type for value resolution |
+| `sortOrder` | `"asc"` / `"desc"` | No | Sort order for array data items |
+
+### Multi-field value format (when `value` is an array)
+| Field | Type | Description |
+|-------|------|-------------|
+| `name` | string | Field path: `"fieldName"` for top-level or `"array.fieldName"` for nested array access |
+| `label` | string | Optional label prefix rendered before the values (e.g. `"Items:"`) |
+| `style` | CSSProperties | Optional inline styles for this row (e.g. `{ color: "grey" }`) |
+
+## Data Binding
+- **Array data mode** (`data` is array, `value` is template string): Iterates over the data array and renders each item using the template string.
+- **Multi-field mode** (`data` is object, `value` is descriptor array): Reads named fields from the data object. Single-segment names (e.g. `"name"`) read directly; two-segment names (e.g. `"items.ref"`) iterate over the nested array.
+
+## Descendants
+No -- self-contained display component.
+
+## Composition Patterns
+- `fc.list` column `type: "component"` > `fc.attribute.column` for stacked multi-line cells
+- Commonly used to combine product name + SKU ref in one list column
+- Use `contentColumnSetting` with a setting defining `{ name, color, label }` entries for status dots
+
+## Gotchas
+- The `minListSize` default is 5 -- lists longer than 5 items show a "More" / "Less" toggle. Set to `0` to disable.
+- The colored dot feature (`contentColumnSetting`) only activates when `value` is a string and the setting is provided. The setting must return a record of `{ name, color?, label? }` objects.
+- For multi-field `value` arrays, only 1-segment and 2-segment paths are supported. 3+ segment paths render nothing.
+- Sort order applies to array data mode -- it re-orders the data array by the template value.
+- The "More" / "Less" text is translated via `fc.attribute.column.more` and `fc.attribute.column.less` i18n keys.
+- Registered with category `content` in the component registry.
+
+## Manifest Example
+### Multi-field mode (stacked name + ref)
+```json
+{
+  "label": "Product",
+  "type": "component",
+  "options": {
+    "component": "fc.attribute.column",
+    "props": {
+      "value": [
+        { "name": "name" },
+        { "name": "ref", "style": { "color": "grey" } }
+      ]
+    },
+    "dataSource": "node"
+  }
+}
+```
+
+### Array data mode (list of refs)
+```json
+{
+  "label": "Items",
+  "type": "component",
+  "options": {
+    "component": "fc.attribute.column",
+    "props": {
+      "value": "{{ref}}",
+      "minListSize": 3,
+      "sortOrder": "asc"
+    },
+    "dataSource": "node.items.edges.node"
+  }
+}
+```
+
+### Status dot mode
+```json
+{
+  "label": "Status",
+  "type": "component",
+  "options": {
+    "component": "fc.attribute.column",
+    "props": {
+      "value": "{{status}}",
+      "contentColumnSetting": "fc.mystique.status.colours"
+    },
+    "dataSource": "node"
+  }
+}
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.attribute.json.md

@@ -0,0 +1,20 @@
+---
+alias: "fc.attribute.json"
+aliases:
+  - fc.attribute.json
+category: content
+module: OMS
+---
+# fc.attribute.json
+
+Pretty-printed JSON display with syntax highlighting. OMS variant of JSON viewer.
+
+## When to Use
+- Display entity attributes as formatted JSON
+- Debugging views
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.attribute.jsoneditor.md

@@ -0,0 +1,54 @@
+---
+alias: "fc.attribute.jsoneditor"
+aliases:
+  - fc.attribute.jsoneditor
+  - fc.json.editor
+category: content
+module: Core
+---
+# fc.attribute.jsoneditor
+
+Compatibility alias for `fc.json.editor` used in older manifests for editable JSON attribute input.
+
+## When to Use
+- Legacy manifests that reference `fc.attribute.jsoneditor`
+- JSON attribute editing in forms and settings pages
+- Gradual migration to canonical component names
+
+## Key Props
+| Prop | Type | Required | What it controls |
+|------|------|----------|------------------|
+| _Same as_ `fc.json.editor` | — | — | Uses the same props and runtime behavior as `fc.json.editor` |
+
+## Data Binding
+Binds to JSON value paths using the same input/output contract as `fc.json.editor`.
+
+## Descendants
+No.
+
+## Composition Patterns
+- Prefer `fc.json.editor` for new manifests.
+- Keep this alias only when backward compatibility is required.
+
+## Gotchas
+- Alias and canonical component are functionally equivalent.
+- Validate JSON shape before persisting changes.
+
+## Validation Rules
+- Must resolve to the same prop contract as `fc.json.editor`.
+
+## Manifest Example
+```json
+{
+  "component": "fc.attribute.jsoneditor",
+  "props": {
+    "dataSource": "entity.attributes.config"
+  }
+}
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, `category`, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.attribute.locationId.md

@@ -0,0 +1,51 @@
+---
+alias: "fc.attribute.locationId"
+aliases:
+  - fc.attribute.locationId
+category: field
+module: Core
+---
+# fc.attribute.locationId
+
+Location ID dropdown selector for assigning a primary location to a user. Conditionally shows/hides based on user type (required for AGENT, optional otherwise).
+
+## When to Use
+- Create/edit user drawers where a location must be assigned
+- Agent user forms requiring a mandatory location
+- Any form where location selection is conditional on context
+
+## Key Props
+| Prop | Type | Required | What it controls |
+|------|------|----------|------------------|
+| `name` | string | Yes | Field name in the form |
+| `label` | string | No | Field label (supports i18n keys) |
+| `value` | string | No | Pre-selected location ID |
+| `mandatory` | boolean | No | Whether the field is required |
+
+## Data Binding
+The component queries available locations and presents them in a dropdown. When the "+ ADD LOCATION" button is not pressed, no validation is applied. Once expanded, the field validates that a non-empty value is submitted.
+
+## Descendants
+No.
+
+## Gotchas
+- The component has two states: collapsed (no validation) and expanded (required validation). This allows location to be optional for non-AGENT user types.
+- Location ID is mandatory from the backend perspective, but this component conditionally avoids system validation.
+- Designed specifically for the Create User drawer workflow.
+
+## Manifest Example
+```json
+{
+  "component": "fc.attribute.locationId",
+  "props": {
+    "name": "primaryLocationId",
+    "label": "i18n:fc.user.primaryLocation"
+  }
+}
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.attribute.retailerId.md

@@ -0,0 +1,52 @@
+---
+alias: "fc.attribute.retailerId"
+aliases:
+  - fc.attribute.retailerId
+category: field
+module: Core
+---
+# fc.attribute.retailerId
+
+Retailer ID dropdown selector for assigning a primary retailer to a user. Conditionally shows/hides based on user type (required for RETAILER, optional otherwise). Adapts display between radio buttons (1-3 options) and a scrollable list (4+ options).
+
+## When to Use
+- Create/edit user drawers where a retailer must be assigned
+- RETAILER user type forms requiring a mandatory retailer selection
+- Any form where retailer selection is conditional on context
+
+## Key Props
+| Prop | Type | Required | What it controls |
+|------|------|----------|------------------|
+| `name` | string | Yes | Field name in the form |
+| `label` | string | No | Field label (supports i18n keys) |
+| `value` | string | No | Pre-selected retailer ID |
+| `mandatory` | boolean | No | Whether the field is required |
+
+## Data Binding
+The component queries available retailers and renders them as radio buttons (1-3 retailers) or a scrollable list (4+ retailers). When the "+ ADD RETAILER" button is not pressed, no validation is applied. Once expanded, the field validates that a non-empty value is submitted.
+
+## Descendants
+No.
+
+## Gotchas
+- Two display modes: radio group for 1-3 retailers, scrollable list for 4+ retailers.
+- The component has two states: collapsed (no validation) and expanded (required validation). This allows retailer to be optional for non-RETAILER user types.
+- Retailer ID is mandatory from the backend perspective, but this component conditionally avoids system validation.
+- Designed specifically for the Create User drawer workflow.
+
+## Manifest Example
+```json
+{
+  "component": "fc.attribute.retailerId",
+  "props": {
+    "name": "primaryRetailerId",
+    "label": "i18n:fc.user.primaryRetailer"
+  }
+}
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.

package/content/dev/skills/fluent-mystique-builder/components/fc.button.bar.md

@@ -0,0 +1,57 @@
+---
+alias: "fc.button.bar"
+aliases:
+  - fc.button.bar
+category: action
+module: Core
+---
+
+# fc.button.bar
+
+Horizontal button bar that renders its descendants in a right-aligned row spanning the full width.
+
+## When to Use
+- Group multiple action buttons in a right-aligned horizontal bar
+- Create a toolbar row at the top or bottom of a section
+- Align action buttons consistently across different page layouts
+
+## Key Props
+
+This component has no props. It is a layout wrapper rendered as a full-width `Grid` item with `justify-content: flex-end`.
+
+## Descendants
+Yes -- accepts button components or any other action components as children. All descendants are rendered in a right-aligned horizontal row.
+
+## Composition Patterns
+- `fc.page.section.header` > `fc.button.bar` > multiple buttons
+- `fc.column` > `fc.button.bar` > `fc.drawer.button` + `fc.modal.button`
+- `fc.page` > `fc.button.bar` > action buttons at the top of a page
+
+## Gotchas
+- Renders as a full-width (`xs={12}`) Grid item -- takes the full row width with content pushed to the right.
+- The bar itself has no padding or visual chrome -- it only provides the flex layout.
+- Uses `flexDirection: row` and `justifyContent: flex-end` for right-alignment.
+- Registered with category `content` in the component registry.
+
+## Manifest Example
+```json
+{
+  "component": "fc.button.bar",
+  "descendants": [
+    {
+      "component": "fc.drawer.button",
+      "props": { "label": "Edit Details" }
+    },
+    {
+      "component": "fc.modal.button",
+      "props": { "label": "Send Event" }
+    }
+  ]
+}
+```
+
+## AI Parse Notes
+- **Primary intent:** Declarative Mystique component definition for manifests.
+- **Selection signals:** Match by `alias`, category, and required `Key Props`.
+- **Assembly hints:** Combine with compatible parent/child components listed in `Composition Patterns`.
+- **Safety checks:** Validate required props and data bindings before manifest generation.