@coveo/thermidor-schema 1.0.0-beta.4 → 1.0.0-beta.6

package/dist/generated/schemas.js

@@ -1,6 +1,7 @@
 // This file is generated from the canonical JSON Schema documents.
 // Do not edit it directly; run `mise run generate` from the repository root.
 import * as z from 'zod/v4';
+export const CartUpdateOperationSchema = z.enum(['add', 'remove', 'setQuantity']);
 // The kind of action: "followup" triggers a conversational follow-up, "search" triggers a
 // standalone search.
 //
@@ -37,11 +38,43 @@ export const ProductSchema = z.strictObject({
     ec_thumbnails: z.array(z.url()).optional(),
     permanentid: z.string(),
 });
+export const DataBindingSchema = z.strictObject({
+    path: z.string(),
+});
+export const ChildListClassSchema = z.strictObject({
+    componentId: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    path: z.string(),
+});
 export const ProductCarouselActionsSchema = z.strictObject({});
 export const ProductCarouselStateSchema = z.strictObject({
     heading: z.string(),
     products: z.array(ProductSchema),
 });
+export const PurchaseProductSchema = z.strictObject({
+    name: z.string().optional(),
+    price: z.union([z.number(), z.null()]).optional(),
+    productId: z.string().min(1),
+    quantity: z.number().int().min(1),
+});
+export const TransactionSchema = z.strictObject({
+    id: z.string().min(1),
+    revenue: z.number(),
+});
+export const UpdateCartPayloadSchema = z.strictObject({
+    name: z.string().optional(),
+    operation: z.enum(['add', 'remove', 'setQuantity']),
+    price: z.union([z.number(), z.null()]).optional(),
+    productId: z.string().min(1),
+    quantity: z.number().int().min(1),
+});
+export const CartStateSchema = z.strictObject({});
+export const FetchSuggestionsPayloadSchema = z.strictObject({
+    query: z.string(),
+});
+export const QueryCompletionSchema = z.strictObject({
+    expression: z.string(),
+    score: z.number().optional(),
+});
 export const SelectActionPayloadSchema = z.strictObject({
     text: z.string(),
     type: z.enum(['followup', 'search']),
@@ -68,7 +101,15 @@ export const ComparisonProductSchema = z.strictObject({
     rating: z.number().min(0).max(5).optional(),
     values: z.record(z.string(), z.string()).optional(),
 });
-export const ProductListActionsSchema = z.strictObject({});
+export const ProductClickPayloadSchema = z.strictObject({
+    name: z.string().optional(),
+    position: z.number().int().min(0),
+    price: z.union([z.number(), z.null()]).optional(),
+    productId: z.string().min(1),
+});
+export const SelectProductsPayloadSchema = z.strictObject({
+    productIds: z.array(z.string().min(1)),
+});
 export const ProductListStateSchema = z.strictObject({
     products: z.array(ProductSchema),
 });
@@ -83,6 +124,7 @@ export const SelectPagePayloadSchema = z.strictObject({
 export const PayloadSchema = z.strictObject({
     pageSize: z.number().int().min(1),
 });
+export const ShowMorePayloadSchema = z.strictObject({});
 export const PaginationStateSchema = z.strictObject({
     page: z.number().int().min(0),
     pageSize: z.number().int().min(1),
@@ -192,6 +234,14 @@ export const CategoryFacetValuesSchema = z.strictObject({
 });
 export const FacetManagerActionsSchema = z.strictObject({});
 export const FacetManagerStateSchema = z.strictObject({});
+export const OverrideCorrectionPayloadSchema = z.strictObject({
+    originalQuery: z.string().min(1),
+});
+export const NumericRangeRestoreSchema = z.strictObject({
+    end: z.number(),
+    endInclusive: z.boolean().optional(),
+    start: z.number(),
+});
 export const SubmitQueryPayloadSchema = z.strictObject({
     query: z.string(),
 });
@@ -211,26 +261,38 @@ export const SetPageSizePayloadSchema = z.strictObject({
 export const PageSizeStateSchema = z.strictObject({
     pageSize: z.number().int().min(1),
 });
-export const ProductCarouselSchema = z.strictObject({
-    actions: ProductCarouselActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('product-carousel'),
-    state: ProductCarouselStateSchema,
+export const ProductCarouselSchema = z.looseObject({
+    actions: ProductCarouselActionsSchema.optional(),
+    component: z.literal('ProductCarousel'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: ProductCarouselStateSchema.optional(),
+});
+export const PurchasePayloadSchema = z.strictObject({
+    products: z.array(PurchaseProductSchema),
+    transaction: TransactionSchema,
+});
+export const UpdateCartSchema = z.strictObject({
+    payload: UpdateCartPayloadSchema,
+});
+export const FetchSuggestionsSchema = z.strictObject({
+    payload: FetchSuggestionsPayloadSchema,
+});
+export const QuerySuggestionsStateSchema = z.strictObject({
+    completions: z.array(QueryCompletionSchema),
+    products: z.array(ProductSchema),
+    query: z.string(),
 });
 export const SelectActionSchema = z.strictObject({
     payload: SelectActionPayloadSchema,
 });
 export const NextActionsStateSchema = z.strictObject({
-    actions: z.array(ActionItemSchema),
+    suggestedActions: z.array(ActionItemSchema),
 });
 export const BundleTierSchema = z.strictObject({
     description: z.string(),
     label: z.string(),
     slots: z.array(BundleSlotSchema),
+    total: z.number().min(0),
 });
 export const ComparisonTableStateSchema = z.strictObject({
     attributes: z.array(ComparisonAttributeSchema),
@@ -238,25 +300,17 @@ export const ComparisonTableStateSchema = z.strictObject({
     products: z.array(ComparisonProductSchema),
     summary: z.string(),
 });
-export const ProductListSchema = z.strictObject({
-    actions: ProductListActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('product-list'),
-    state: ProductListStateSchema,
-});
-export const ProductSummarySchema = z.strictObject({
-    actions: ProductSummaryActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('product-summary'),
-    state: ProductSummaryStateSchema,
+export const ProductClickSchema = z.strictObject({
+    payload: ProductClickPayloadSchema,
+});
+export const SelectProductsSchema = z.strictObject({
+    payload: SelectProductsPayloadSchema,
+});
+export const ProductSummarySchema = z.looseObject({
+    actions: ProductSummaryActionsSchema.optional(),
+    component: z.literal('ProductSummary'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: ProductSummaryStateSchema.optional(),
 });
 export const SelectPageSchema = z.strictObject({
     payload: SelectPagePayloadSchema,
@@ -264,6 +318,9 @@ export const SelectPageSchema = z.strictObject({
 export const PurpleSetPageSizeSchema = z.strictObject({
     payload: PayloadSchema,
 });
+export const ShowMoreSchema = z.strictObject({
+    payload: ShowMorePayloadSchema,
+});
 export const SelectSortSchema = z.strictObject({
     payload: SelectSortPayloadSchema,
 });
@@ -339,61 +396,64 @@ export const FacetSearchClassSchema = z.strictObject({
     query: z.string().max(256),
     results: z.array(CategoryFacetValueSchema),
 });
-export const FacetManagerSchema = z.strictObject({
-    actions: FacetManagerActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('facet-manager'),
-    state: FacetManagerStateSchema,
+export const FacetManagerSchema = z.looseObject({
+    actions: FacetManagerActionsSchema.optional(),
+    component: z.literal('FacetManager'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: FacetManagerStateSchema.optional(),
+});
+export const OverrideCorrectionSchema = z.strictObject({
+    payload: OverrideCorrectionPayloadSchema,
+});
+export const FacetRestoreSchema = z.strictObject({
+    facetId: z.string().min(1),
+    numericRanges: z.array(NumericRangeRestoreSchema).optional(),
+    values: z.array(z.string()).optional(),
 });
 export const SubmitQuerySchema = z.strictObject({
     payload: SubmitQueryPayloadSchema,
 });
-export const LayoutStackSchema = z.strictObject({
-    actions: LayoutStackActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('layout-stack'),
-    state: LayoutStackStateSchema,
-});
-export const QuerySummarySchema = z.strictObject({
-    actions: QuerySummaryActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('query-summary'),
-    state: QuerySummaryStateSchema,
+export const LayoutStackSchema = z.looseObject({
+    actions: LayoutStackActionsSchema.optional(),
+    component: z.literal('LayoutStack'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: LayoutStackStateSchema.optional(),
+});
+export const QuerySummarySchema = z.looseObject({
+    actions: QuerySummaryActionsSchema.optional(),
+    component: z.literal('QuerySummary'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: QuerySummaryStateSchema.optional(),
 });
 export const FluffySetPageSizeSchema = z.strictObject({
     payload: SetPageSizePayloadSchema,
 });
+export const PurchaseSchema = z.strictObject({
+    payload: PurchasePayloadSchema,
+});
+export const QuerySuggestionsActionsSchema = z.strictObject({
+    fetchSuggestions: FetchSuggestionsSchema,
+});
 export const NextActionsBarActionsSchema = z.strictObject({
     selectAction: SelectActionSchema,
 });
 export const BundleDisplayStateSchema = z.strictObject({
     tiers: z.array(BundleTierSchema),
 });
-export const ComparisonTableSchema = z.strictObject({
-    actions: ComparisonTableActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('comparison-table'),
-    state: ComparisonTableStateSchema,
+export const ComparisonTableSchema = z.looseObject({
+    actions: ComparisonTableActionsSchema.optional(),
+    component: z.literal('ComparisonTable'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: ComparisonTableStateSchema.optional(),
+});
+export const ProductListActionsSchema = z.strictObject({
+    productClick: ProductClickSchema,
+    selectProducts: SelectProductsSchema,
 });
 export const PaginationActionsSchema = z.strictObject({
     selectPage: SelectPageSchema,
     setPageSize: PurpleSetPageSizeSchema,
+    showMore: ShowMoreSchema,
 });
 export const SortActionsSchema = z.strictObject({
     selectSort: SelectSortSchema,
@@ -452,114 +512,111 @@ export const CategoryFacetStateSchema = z.strictObject({
     field: z.string(),
     values: CategoryFacetValuesSchema,
 });
-export const CommerceSearchActionsSchema = z.strictObject({
-    submitQuery: SubmitQuerySchema,
+export const RestoreStatePayloadSchema = z.strictObject({
+    facets: z.array(FacetRestoreSchema).optional(),
+    page: z.number().int().min(0),
+    pageSize: z.number().int().min(1),
+    pinnedProducts: z.array(z.string()).optional(),
+    query: z.string(),
+    sortCriteria: z.string().optional(),
 });
 export const PageSizeActionsSchema = z.strictObject({
     setPageSize: FluffySetPageSizeSchema,
 });
-export const NextActionsBarSchema = z.strictObject({
-    actions: NextActionsBarActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('next-actions-bar'),
-    state: NextActionsStateSchema,
-});
-export const BundleDisplaySchema = z.strictObject({
-    actions: BundleDisplayActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('bundle-display'),
-    state: BundleDisplayStateSchema,
-});
-export const PaginationSchema = z.strictObject({
-    actions: PaginationActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('pagination'),
-    state: PaginationStateSchema,
-});
-export const SortSchema = z.strictObject({
-    actions: SortActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('sort'),
-    state: SortStateSchema,
-});
-export const RegularFacetSchema = z.strictObject({
-    actions: RegularFacetActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('regular-facet'),
-    state: RegularFacetStateSchema,
-});
-export const NumericFacetSchema = z.strictObject({
-    actions: NumericFacetActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('numeric-facet'),
-    state: NumericFacetStateSchema,
-});
-export const DateFacetSchema = z.strictObject({
-    actions: DateFacetActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('date-facet'),
-    state: DateFacetStateSchema,
-});
-export const CategoryFacetSchema = z.strictObject({
-    actions: CategoryFacetActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('category-facet'),
-    state: CategoryFacetStateSchema,
-});
-export const CommerceSearchSchema = z.strictObject({
-    actions: CommerceSearchActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('commerce-search'),
-    state: CommerceSearchStateSchema,
-});
-export const PageSizeSchema = z.strictObject({
-    actions: PageSizeActionsSchema,
-    child: z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')).optional(),
-    children: z
-        .array(z.string().regex(new RegExp('^[a-z][a-z0-9-]*$')))
-        .max(1000)
-        .optional(),
-    componentType: z.literal('page-size'),
-    state: PageSizeStateSchema,
-});
-export const ComponentContractsSchema = z.discriminatedUnion('componentType', [
+export const CartActionsSchema = z.strictObject({
+    purchase: PurchaseSchema,
+    updateCart: UpdateCartSchema,
+});
+export const QuerySuggestionsSchema = z.looseObject({
+    actions: QuerySuggestionsActionsSchema.optional(),
+    component: z.literal('QuerySuggestions'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: QuerySuggestionsStateSchema.optional(),
+});
+export const NextActionsBarSchema = z.looseObject({
+    actions: NextActionsBarActionsSchema.optional(),
+    component: z.literal('NextActionsBar'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: NextActionsStateSchema.optional(),
+});
+export const BundleDisplaySchema = z.looseObject({
+    actions: BundleDisplayActionsSchema.optional(),
+    component: z.literal('BundleDisplay'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: BundleDisplayStateSchema.optional(),
+});
+export const ProductListSchema = z.looseObject({
+    actions: ProductListActionsSchema.optional(),
+    component: z.literal('ProductList'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: ProductListStateSchema.optional(),
+});
+export const PaginationSchema = z.looseObject({
+    actions: PaginationActionsSchema.optional(),
+    component: z.literal('Pagination'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: PaginationStateSchema.optional(),
+});
+export const SortSchema = z.looseObject({
+    actions: SortActionsSchema.optional(),
+    component: z.literal('Sort'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: SortStateSchema.optional(),
+});
+export const RegularFacetSchema = z.looseObject({
+    actions: RegularFacetActionsSchema.optional(),
+    component: z.literal('RegularFacet'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: RegularFacetStateSchema.optional(),
+});
+export const NumericFacetSchema = z.looseObject({
+    actions: NumericFacetActionsSchema.optional(),
+    component: z.literal('NumericFacet'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: NumericFacetStateSchema.optional(),
+});
+export const DateFacetSchema = z.looseObject({
+    actions: DateFacetActionsSchema.optional(),
+    component: z.literal('DateFacet'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: DateFacetStateSchema.optional(),
+});
+export const CategoryFacetSchema = z.looseObject({
+    actions: CategoryFacetActionsSchema.optional(),
+    component: z.literal('CategoryFacet'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: CategoryFacetStateSchema.optional(),
+});
+export const RestoreStateSchema = z.strictObject({
+    payload: RestoreStatePayloadSchema,
+});
+export const PageSizeSchema = z.looseObject({
+    actions: PageSizeActionsSchema.optional(),
+    component: z.literal('PageSize'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: PageSizeStateSchema.optional(),
+});
+export const CartSchema = z.looseObject({
+    actions: CartActionsSchema.optional(),
+    component: z.literal('Cart'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: CartStateSchema.optional(),
+});
+export const CommerceSearchActionsSchema = z.strictObject({
+    overrideCorrection: OverrideCorrectionSchema,
+    restoreState: RestoreStateSchema,
+    submitQuery: SubmitQuerySchema,
+});
+export const CommerceSearchSchema = z.looseObject({
+    actions: CommerceSearchActionsSchema.optional(),
+    component: z.literal('CommerceSearch'),
+    id: z.string().min(1).max(256).regex(new RegExp('^[a-z][a-z0-9-]*$')),
+    state: CommerceSearchStateSchema.optional(),
+});
+export const ComponentContractsSchema = z.discriminatedUnion('component', [
     ProductCarouselSchema,
+    CartSchema,
+    QuerySuggestionsSchema,
     NextActionsBarSchema,
     BundleDisplaySchema,
     ComparisonTableSchema,
@@ -578,76 +635,368 @@ export const ComponentContractsSchema = z.discriminatedUnion('componentType', [
     PageSizeSchema,
 ]);
 /**
- * Component props schemas.
- * These props are injected by the A2-UI surface layer (backend) and passed to catalog
- * renderers automatically. Consumers should NOT hardcode these values; they arrive via
- * the createSurface message's components[].props.
+ * A2-UI dynamic-value building blocks (self-contained; no renderer / @a2ui/web_core dependency).
+ * A bindable prop is an A2-UI Dynamic_Value: a union admitting a literal resolved value, an
+ * A2-UI Data_Binding object { path }, or a function-call form. The frozen renderer's binder
+ * classifies a field as resolvable only when its schema is such a union including DataBinding,
+ * so it dereferences the { path } against the data model before the renderer sees it.
+ *
+ * `DataBindingSchema` is projected from the shared definitions/data-binding.schema.json (like
+ * ComponentId / ChildList), so it is not re-declared here; the unions below reference it.
+ */
+export const FunctionCallSchema = z.object({
+    functionName: z.string(),
+    args: z.array(z.unknown()).optional(),
+});
+export const DynamicNumberSchema = z.union([z.number(), DataBindingSchema, FunctionCallSchema]);
+export const DynamicStringSchema = z.union([z.string(), DataBindingSchema, FunctionCallSchema]);
+export const DynamicBooleanSchema = z.union([z.boolean(), DataBindingSchema, FunctionCallSchema]);
+export const DynamicStringListSchema = z.union([
+    z.array(z.string()),
+    DataBindingSchema,
+    FunctionCallSchema,
+]);
+export const DynamicValueSchema = z.union([z.unknown(), DataBindingSchema, FunctionCallSchema]);
+/**
+ * The A2-UI Action schema for an action-typed prop: the standard A2-UI event shape
+ * { event: { name; context } }. Named DynamicAction to stay distinct from the generated base
+ * action-contract ActionSchema and from a component's dispatchable *Actions contract.
+ */
+export const DynamicActionSchema = z.object({
+    event: z.object({
+        name: z.string(),
+        context: z.unknown().optional(),
+    }),
+});
+/**
+ * Per-component props schemas for the renderer catalog (one per component), passed to
+ * `createCatalog` as each component's `{ props }` schema. Each bindable prop is an A2-UI
+ * Dynamic_Value, so the renderer's binder resolves its `{ path }` binding against the A2-UI
+ * data model; composition child-ref props stay static so child ids reach the renderer
+ * untouched. The resolved shape a renderer actually reads is the `XxxProps` type.
  */
 export const BundleDisplayPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('bundle-display'),
+    tiers: DynamicValueSchema,
 });
+export const CartPropsSchema = z.object({});
 export const CategoryFacetPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('category-facet'),
+    field: DynamicStringSchema,
+    displayName: DynamicStringSchema,
+    values: DynamicValueSchema,
+    canShowMoreValues: DynamicBooleanSchema,
+    canShowLessValues: DynamicBooleanSchema,
+    facetSearch: DynamicValueSchema,
 });
 export const CommerceSearchPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('commerce-search'),
+    sidebarChild: z.string().optional(),
+    mainChild: z.string().optional(),
 });
 export const ComparisonTablePropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('comparison-table'),
+    heading: DynamicStringSchema,
+    summary: DynamicStringSchema,
+    products: DynamicValueSchema,
+    attributes: DynamicValueSchema,
 });
 export const DateFacetPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('date-facet'),
+    field: DynamicStringSchema,
+    displayName: DynamicStringSchema,
+    values: DynamicValueSchema,
+    customRange: DynamicValueSchema,
+    hasActiveValues: DynamicBooleanSchema,
+    canShowMoreValues: DynamicBooleanSchema,
+    canShowLessValues: DynamicBooleanSchema,
 });
 export const FacetManagerPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('facet-manager'),
+    children: z.array(z.string()).optional(),
 });
 export const LayoutStackPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('layout-stack'),
+    direction: z.string().optional(),
+    children: z.array(z.string()).optional(),
 });
 export const NextActionsBarPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('next-actions-bar'),
+    suggestedActions: DynamicValueSchema,
 });
 export const NumericFacetPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('numeric-facet'),
+    field: DynamicStringSchema,
+    displayName: DynamicStringSchema,
+    values: DynamicValueSchema,
+    customRange: DynamicValueSchema,
+    hasActiveValues: DynamicBooleanSchema,
+    canShowMoreValues: DynamicBooleanSchema,
+    canShowLessValues: DynamicBooleanSchema,
+    domain: DynamicValueSchema,
 });
 export const PageSizePropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('page-size'),
+    pageSize: DynamicNumberSchema,
 });
 export const PaginationPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('pagination'),
+    page: DynamicNumberSchema,
+    pageSize: DynamicNumberSchema,
+    totalEntries: DynamicNumberSchema,
+    totalPages: DynamicNumberSchema,
 });
 export const ProductCarouselPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('product-carousel'),
+    heading: DynamicStringSchema,
+    products: DynamicValueSchema,
 });
 export const ProductListPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('product-list'),
+    products: DynamicValueSchema,
 });
 export const ProductSummaryPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('product-summary'),
+    categoryLabel: DynamicStringSchema,
+    product: DynamicValueSchema,
+});
+export const QuerySuggestionsPropsSchema = z.object({
+    query: DynamicStringSchema,
+    completions: DynamicValueSchema,
+    products: DynamicValueSchema,
 });
 export const QuerySummaryPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('query-summary'),
+    query: DynamicStringSchema,
+    firstIndex: DynamicNumberSchema,
+    lastIndex: DynamicNumberSchema,
+    totalEntries: DynamicNumberSchema,
 });
 export const RegularFacetPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('regular-facet'),
+    field: DynamicStringSchema,
+    displayName: DynamicStringSchema,
+    values: DynamicValueSchema,
+    hasActiveValues: DynamicBooleanSchema,
+    canShowMoreValues: DynamicBooleanSchema,
+    canShowLessValues: DynamicBooleanSchema,
+    facetSearch: DynamicValueSchema,
 });
 export const SortPropsSchema = z.object({
-    componentId: z.string(),
-    componentType: z.literal('sort'),
+    appliedSort: DynamicValueSchema,
+    availableSorts: DynamicValueSchema,
 });
+/**
+ * Per-component action unions in the standard A2-UI event shape
+ * { event: { name: <literal>; context: <typed payload> } }, one member per declared action.
+ * Derived from each component's *Actions contract (action-map key -> payload), NOT from
+ * quicktype's auto-named payload wrappers. A component with no actions has `type XxxAction =
+ * never`. The wire field is `context`; the internal validation layer calls the same data
+ * `payload` (see design: Action typing).
+ */
+export const BundleDisplayActionSchema = z.never();
+export const CartActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('updateCart'),
+            context: z.strictObject({
+                productId: z.string(),
+                name: z.string().optional(),
+                price: z.unknown().optional(),
+                quantity: z.number().int().min(1),
+                operation: z.enum(['add', 'remove', 'setQuantity']),
+            }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('purchase'),
+            context: z.strictObject({ products: z.array(z.unknown()), transaction: z.unknown() }),
+        }),
+    }),
+]);
+export const CategoryFacetActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('selectPath'),
+            context: z.strictObject({ path: z.array(z.string()) }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('clearSelectedPath'), context: z.unknown() }) }),
+    z.object({
+        event: z.object({
+            name: z.literal('search'),
+            context: z.strictObject({ query: z.string().max(256) }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('showMoreSearchResults'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('clearSearch'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('showMoreValues'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('showLessValues'), context: z.unknown() }) }),
+]);
+export const CommerceSearchActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('submitQuery'),
+            context: z.strictObject({ query: z.string() }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('restoreState'),
+            context: z.strictObject({
+                query: z.string(),
+                page: z.number().int().min(0),
+                pageSize: z.number().int().min(1),
+                sortCriteria: z.string().optional(),
+                facets: z.array(z.unknown()).optional(),
+                pinnedProducts: z.array(z.string()).optional(),
+            }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('overrideCorrection'),
+            context: z.strictObject({ originalQuery: z.string() }),
+        }),
+    }),
+]);
+export const ComparisonTableActionSchema = z.never();
+export const DateFacetActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSelect'),
+            context: z.strictObject({ start: z.string(), end: z.string() }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSingleSelect'),
+            context: z.strictObject({ start: z.string(), end: z.string() }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('clearAllActiveValues'), context: z.unknown() }) }),
+    z.object({
+        event: z.object({
+            name: z.literal('applyCustomRange'),
+            context: z.strictObject({ start: z.string(), end: z.string() }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('showMoreValues'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('showLessValues'), context: z.unknown() }) }),
+]);
+export const FacetManagerActionSchema = z.never();
+export const LayoutStackActionSchema = z.never();
+export const NextActionsBarActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('selectAction'),
+            context: z.strictObject({ text: z.string(), type: z.enum(['followup', 'search']) }),
+        }),
+    }),
+]);
+export const NumericFacetActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSelect'),
+            context: z.strictObject({ start: z.number(), end: z.number() }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSingleSelect'),
+            context: z.strictObject({ start: z.number(), end: z.number() }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('clearAllActiveValues'), context: z.unknown() }) }),
+    z.object({
+        event: z.object({
+            name: z.literal('applyCustomRange'),
+            context: z.strictObject({ start: z.number(), end: z.number() }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('showMoreValues'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('showLessValues'), context: z.unknown() }) }),
+]);
+export const PageSizeActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('setPageSize'),
+            context: z.strictObject({ pageSize: z.number().int().min(1) }),
+        }),
+    }),
+]);
+export const PaginationActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('selectPage'),
+            context: z.strictObject({ page: z.number().int().min(0) }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('setPageSize'),
+            context: z.strictObject({ pageSize: z.number().int().min(1) }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('showMore'), context: z.strictObject({}) }) }),
+]);
+export const ProductCarouselActionSchema = z.never();
+export const ProductListActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('selectProducts'),
+            context: z.strictObject({ productIds: z.array(z.string()) }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('productClick'),
+            context: z.strictObject({
+                productId: z.string(),
+                name: z.string().optional(),
+                price: z.unknown().optional(),
+                position: z.number().int().min(0),
+            }),
+        }),
+    }),
+]);
+export const ProductSummaryActionSchema = z.never();
+export const QuerySuggestionsActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('fetchSuggestions'),
+            context: z.strictObject({ query: z.string() }),
+        }),
+    }),
+]);
+export const QuerySummaryActionSchema = z.never();
+export const RegularFacetActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSelect'),
+            context: z.strictObject({ value: z.string().max(1024) }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('toggleExclude'),
+            context: z.strictObject({ value: z.string().max(1024) }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSingleSelect'),
+            context: z.strictObject({ value: z.string().max(1024) }),
+        }),
+    }),
+    z.object({
+        event: z.object({
+            name: z.literal('toggleSingleExclude'),
+            context: z.strictObject({ value: z.string().max(1024) }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('clearAllActiveValues'), context: z.unknown() }) }),
+    z.object({
+        event: z.object({
+            name: z.literal('search'),
+            context: z.strictObject({ query: z.string().max(1024) }),
+        }),
+    }),
+    z.object({ event: z.object({ name: z.literal('showMoreSearchResults'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('clearSearch'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('showMoreValues'), context: z.unknown() }) }),
+    z.object({ event: z.object({ name: z.literal('showLessValues'), context: z.unknown() }) }),
+]);
+export const SortActionSchema = z.union([
+    z.object({
+        event: z.object({
+            name: z.literal('selectSort'),
+            context: z.strictObject({ sortCriteria: z.string(), fields: z.array(z.unknown()) }),
+        }),
+    }),
+]);