@coveo/quantic 3.33.3 → 3.33.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/docs/out/quantic-docs.json +13 -13
  2. package/force-app/main/default/lwc/quanticCategoryFacet/quanticCategoryFacet.js +1 -1
  3. package/force-app/main/default/lwc/quanticCitation/__tests__/quanticCitation.test.js +142 -3
  4. package/force-app/main/default/lwc/quanticCitation/quanticCitation.html +10 -4
  5. package/force-app/main/default/lwc/quanticCitation/quanticCitation.js +72 -31
  6. package/force-app/main/default/lwc/quanticFacet/quanticFacet.js +1 -1
  7. package/force-app/main/default/lwc/quanticHeading/quanticHeading.js +1 -1
  8. package/force-app/main/default/lwc/quanticHeadlessLoader/quanticHeadlessLoader.js +4 -1
  9. package/force-app/main/default/lwc/quanticResultsPerPage/quanticResultsPerPage.js +1 -1
  10. package/force-app/main/default/lwc/quanticSmartSnippet/e2e/quanticSmartSnippet.e2e.ts +4 -28
  11. package/force-app/main/default/lwc/quanticSummary/quanticSummary.js +1 -1
  12. package/force-app/main/default/lwc/quanticTimeframe/quanticTimeframe.js +2 -2
  13. package/force-app/main/default/lwc/quanticUtils/facetDependenciesUtils.js +2 -2
  14. package/force-app/main/default/lwc/quanticUtils/quanticUtils.js +4 -4
  15. package/force-app/main/default/staticresources/coveoheadless/case-assist/headless.js +8 -8
  16. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/common/product.d.ts +2 -2
  17. package/force-app/main/default/staticresources/coveoheadless/definitions/api/search/date/date-format.d.ts +1 -1
  18. package/force-app/main/default/staticresources/coveoheadless/definitions/api/search/plan/plan-response.d.ts +1 -1
  19. package/force-app/main/default/staticresources/coveoheadless/definitions/api/search/search/stemming.d.ts +2 -2
  20. package/force-app/main/default/staticresources/coveoheadless/definitions/app/case-assist-engine/case-assist-engine-configuration.d.ts +1 -1
  21. package/force-app/main/default/staticresources/coveoheadless/definitions/app/commerce-engine/commerce-engine-configuration.d.ts +1 -1
  22. package/force-app/main/default/staticresources/coveoheadless/definitions/app/engine-configuration.d.ts +7 -7
  23. package/force-app/main/default/staticresources/coveoheadless/definitions/app/insight-engine/insight-engine-configuration.d.ts +1 -1
  24. package/force-app/main/default/staticresources/coveoheadless/definitions/app/recommendation-engine/recommendation-engine-configuration.d.ts +1 -1
  25. package/force-app/main/default/staticresources/coveoheadless/definitions/app/search-engine/search-engine-configuration.d.ts +1 -1
  26. package/force-app/main/default/staticresources/coveoheadless/definitions/commerce.index.d.ts +2 -1
  27. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/breadcrumb-manager/headless-breadcrumb-manager.d.ts +1 -1
  28. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/core/breadcrumb-manager/headless-core-breadcrumb-manager.d.ts +1 -1
  29. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/core/facets/generator/headless-commerce-facet-generator.d.ts +0 -1
  30. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/core/parameter-manager/headless-core-parameter-manager.d.ts +2 -2
  31. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/filter-suggestions/headless-category-filter-suggestions.d.ts +1 -1
  32. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/filter-suggestions/headless-filter-suggestions.d.ts +1 -1
  33. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/instant-products/headless-instant-products.d.ts +1 -1
  34. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/product-listing/headless-product-listing.d.ts +2 -2
  35. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/recent-queries-list/headless-recent-queries-list.d.ts +1 -1
  36. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/recommendations/headless-recommendations.d.ts +3 -3
  37. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/commerce/search/headless-search.d.ts +2 -2
  38. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/breadcrumb-manager/headless-core-breadcrumb-manager.d.ts +1 -1
  39. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/context/headless-core-context.d.ts +1 -1
  40. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/did-you-mean/headless-core-did-you-mean.d.ts +1 -1
  41. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facet-manager/headless-core-facet-manager.d.ts +2 -2
  42. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facets/category-facet/headless-core-category-facet.d.ts +2 -2
  43. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facets/facet/headless-core-facet.d.ts +4 -4
  44. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facets/range-facet/date-facet/headless-core-date-facet.d.ts +2 -2
  45. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facets/range-facet/date-facet/headless-core-date-filter.d.ts +1 -1
  46. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facets/range-facet/numeric-facet/headless-core-numeric-facet.d.ts +1 -1
  47. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/facets/range-facet/numeric-facet/headless-core-numeric-filter.d.ts +1 -1
  48. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/folded-result-list/headless-core-folded-result-list.d.ts +1 -1
  49. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/pager/headless-core-pager.d.ts +1 -1
  50. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/query-error/headless-core-query-error.d.ts +1 -1
  51. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/recent-queries-list/headless-core-recent-queries-list.d.ts +3 -3
  52. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/result-list/headless-core-result-list.d.ts +1 -1
  53. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/results-per-page/headless-core-results-per-page.d.ts +1 -1
  54. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/search-box/headless-core-search-box-options.d.ts +3 -3
  55. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/smart-snippet-questions-list/headless-core-smart-snippet-questions-list.d.ts +1 -1
  56. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/sort/headless-core-sort.d.ts +1 -1
  57. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/status/headless-core-status.d.ts +1 -1
  58. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/tab/headless-core-tab.d.ts +1 -1
  59. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/triggers/headless-core-notify-trigger.d.ts +1 -1
  60. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/triggers/headless-core-query-trigger.d.ts +1 -1
  61. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/triggers/headless-core-redirection-trigger.d.ts +1 -1
  62. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/dictionary-field-context/headless-dictionary-field-context.d.ts +1 -1
  63. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/facets/automatic-facet-generator/headless-automatic-facet-generator.d.ts +3 -3
  64. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/field-suggestions/category-facet/headless-category-field-suggestions.d.ts +1 -1
  65. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/field-suggestions/facet/headless-field-suggestions.d.ts +1 -1
  66. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/history-manager/headless-history-manager.d.ts +1 -1
  67. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/instant-results/instant-results.d.ts +1 -1
  68. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/query-summary/headless-query-summary.d.ts +1 -1
  69. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/quickview/headless-quickview.d.ts +1 -1
  70. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/recent-results-list/headless-recent-results-list.d.ts +1 -1
  71. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/recommendation/headless-recommendation.d.ts +1 -1
  72. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/relevance-inspector/headless-relevance-inspector.d.ts +1 -1
  73. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/result-list/headless-interactive-result.d.ts +1 -1
  74. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/smart-snippet-questions-list/headless-smart-snippet-questions-list.d.ts +1 -1
  75. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/standalone-search-box/headless-standalone-search-box.d.ts +1 -1
  76. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/static-filter/headless-static-filter.d.ts +1 -1
  77. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/static-filter/static-filter-value.d.ts +2 -2
  78. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/triggers/headless-execute-trigger.d.ts +2 -2
  79. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/url-manager/headless-url-manager.d.ts +5 -5
  80. package/force-app/main/default/staticresources/coveoheadless/definitions/features/advanced-search-queries/advanced-search-queries-state.d.ts +6 -6
  81. package/force-app/main/default/staticresources/coveoheadless/definitions/features/analytics/analytics-actions.d.ts +2 -2
  82. package/force-app/main/default/staticresources/coveoheadless/definitions/features/analytics/search-action-cause.d.ts +3 -3
  83. package/force-app/main/default/staticresources/coveoheadless/definitions/features/analytics/search-analytics-actions-loader.d.ts +1 -1
  84. package/force-app/main/default/staticresources/coveoheadless/definitions/features/case-assist-configuration/case-assist-configuration-actions.d.ts +1 -1
  85. package/force-app/main/default/staticresources/coveoheadless/definitions/features/case-assist-configuration/case-assist-configuration-state.d.ts +1 -1
  86. package/force-app/main/default/staticresources/coveoheadless/definitions/features/case-field/case-field-actions.d.ts +1 -1
  87. package/force-app/main/default/staticresources/coveoheadless/definitions/features/case-input/case-input-actions.d.ts +1 -1
  88. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/configuration/configuration-actions.d.ts +1 -1
  89. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/configuration/configuration-state.d.ts +1 -1
  90. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/facets/core-facet/core-facet-actions.d.ts +1 -1
  91. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/facets/location-facet/location-facet-actions.d.ts +1 -1
  92. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/facets/numeric-facet/manual-numeric-facet-selectors.d.ts +1 -21
  93. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/facets/numeric-facet/numeric-facet-actions.d.ts +3 -3
  94. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/pagination/pagination-selectors.d.ts +6 -126
  95. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/product-listing/product-listing-selectors.d.ts +6 -160
  96. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/query/query-actions.d.ts +1 -1
  97. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/recommendations/recommendations-actions.d.ts +1 -1
  98. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/recommendations/recommendations-selectors.d.ts +2 -42
  99. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/search/search-actions.d.ts +1 -1
  100. package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/search/search-selectors.d.ts +7 -181
  101. package/force-app/main/default/staticresources/coveoheadless/definitions/features/configuration/configuration-actions.d.ts +13 -13
  102. package/force-app/main/default/staticresources/coveoheadless/definitions/features/configuration/configuration-selectors.d.ts +4 -48
  103. package/force-app/main/default/staticresources/coveoheadless/definitions/features/configuration/configuration-state.d.ts +5 -5
  104. package/force-app/main/default/staticresources/coveoheadless/definitions/features/context/context-actions-loader.d.ts +1 -1
  105. package/force-app/main/default/staticresources/coveoheadless/definitions/features/context/context-selector.d.ts +2 -24
  106. package/force-app/main/default/staticresources/coveoheadless/definitions/features/debug/ranking-info-parser.d.ts +1 -1
  107. package/force-app/main/default/staticresources/coveoheadless/definitions/features/dictionary-field-context/dictionary-field-context-actions-loader.d.ts +1 -1
  108. package/force-app/main/default/staticresources/coveoheadless/definitions/features/did-you-mean/did-you-mean-actions-loader.d.ts +1 -1
  109. package/force-app/main/default/staticresources/coveoheadless/definitions/features/did-you-mean/did-you-mean-selectors.d.ts +1 -21
  110. package/force-app/main/default/staticresources/coveoheadless/definitions/features/excerpt-length/excerpt-length-selectors.d.ts +2 -24
  111. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facet-options/facet-options-actions-loader.d.ts +2 -2
  112. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/category-facet-set/category-facet-set-actions-loader.d.ts +1 -1
  113. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/category-facet-set/category-facet-set-actions.d.ts +5 -5
  114. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/facet-set/facet-set-actions-loader.d.ts +1 -1
  115. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/facet-set/facet-set-actions.d.ts +6 -6
  116. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/range-facets/date-facet-set/date-facet-actions-loader.d.ts +1 -1
  117. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/range-facets/date-facet-set/date-facet-actions.d.ts +3 -3
  118. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/range-facets/numeric-facet-set/numeric-facet-actions-loader.d.ts +1 -1
  119. package/force-app/main/default/staticresources/coveoheadless/definitions/features/facets/range-facets/numeric-facet-set/numeric-facet-actions.d.ts +3 -3
  120. package/force-app/main/default/staticresources/coveoheadless/definitions/features/fields/fields-actions-loader.d.ts +1 -1
  121. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-actions.d.ts +3 -2
  122. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-mocks.d.ts +11 -0
  123. package/force-app/main/default/staticresources/coveoheadless/definitions/features/instant-items/instant-items-state.d.ts +1 -1
  124. package/force-app/main/default/staticresources/coveoheadless/definitions/features/pipeline/select-pipeline.d.ts +2 -24
  125. package/force-app/main/default/staticresources/coveoheadless/definitions/features/query/query-actions.d.ts +2 -2
  126. package/force-app/main/default/staticresources/coveoheadless/definitions/features/query/query-selectors.d.ts +4 -48
  127. package/force-app/main/default/staticresources/coveoheadless/definitions/features/query/query-state.d.ts +2 -2
  128. package/force-app/main/default/staticresources/coveoheadless/definitions/features/query-suggest/query-suggest-actions.d.ts +6 -6
  129. package/force-app/main/default/staticresources/coveoheadless/definitions/features/query-suggest/query-suggest-state.d.ts +2 -2
  130. package/force-app/main/default/staticresources/coveoheadless/definitions/features/question-answering/question-answering-state.d.ts +2 -2
  131. package/force-app/main/default/staticresources/coveoheadless/definitions/features/recommendation/recommendation-state.d.ts +1 -1
  132. package/force-app/main/default/staticresources/coveoheadless/definitions/features/search/search-actions.d.ts +1 -1
  133. package/force-app/main/default/staticresources/coveoheadless/definitions/features/search-hub/search-hub-selectors.d.ts +2 -24
  134. package/force-app/main/default/staticresources/coveoheadless/definitions/features/search-parameters/search-parameter-actions.d.ts +1 -1
  135. package/force-app/main/default/staticresources/coveoheadless/definitions/features/sort-criteria/criteria-parser.d.ts +2 -2
  136. package/force-app/main/default/staticresources/coveoheadless/definitions/features/sort-criteria/sort-criteria-selectors.d.ts +2 -24
  137. package/force-app/main/default/staticresources/coveoheadless/definitions/features/static-filter-set/static-filter-set-actions-loader.d.ts +1 -1
  138. package/force-app/main/default/staticresources/coveoheadless/definitions/features/static-filter-set/static-filter-set-state.d.ts +2 -2
  139. package/force-app/main/default/staticresources/coveoheadless/definitions/features/tab-set/tab-set-actions-loader.d.ts +1 -1
  140. package/force-app/main/default/staticresources/coveoheadless/definitions/features/tab-set/tab-set-actions.d.ts +1 -1
  141. package/force-app/main/default/staticresources/coveoheadless/definitions/insight.index.d.ts +0 -1
  142. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/common/types/engine.d.ts +9 -0
  143. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/search/controllers/facets/range-facet/date-facet/headless-date-facet.ssr.d.ts +0 -1
  144. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/search/controllers/facets/range-facet/numeric-facet/headless-numeric-facet.ssr.d.ts +0 -1
  145. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/search/controllers/static-filter/headless-static-filter.ssr.d.ts +0 -1
  146. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/types/build.d.ts +75 -0
  147. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/types/engine.d.ts +52 -2
  148. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/common/types/engine.d.ts +53 -0
  149. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/controllers/facets/range-facet/date-facet/headless-date-facet.ssr.d.ts +0 -1
  150. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/controllers/facets/range-facet/numeric-facet/headless-numeric-facet.ssr.d.ts +0 -1
  151. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/controllers/static-filter/headless-static-filter.ssr.d.ts +0 -1
  152. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/engine/search-engine.ssr.d.ts +17 -5
  153. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/factories/standalone-static-state-factory.d.ts +9 -0
  154. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/types/engine.d.ts +4 -0
  155. package/force-app/main/default/staticresources/coveoheadless/headless.js +10 -10
  156. package/force-app/main/default/staticresources/coveoheadless/insight/headless.js +9 -9
  157. package/force-app/main/default/staticresources/coveoheadless/recommendation/headless.js +7 -7
  158. package/package.json +3 -3
@@ -28,7 +28,7 @@ export interface BaseProduct {
28
28
  */
29
29
  ec_brand: string | null;
30
30
  /**
31
- * The category of the product (e.g., `"Electronics;Electronics|Televisions;Electronics|Televisions|4K Televisions"`).
31
+ * The category of the product (for example, `"Electronics;Electronics|Televisions;Electronics|Televisions|4K Televisions"`).
32
32
  *
33
33
  * From the `ec_category` field.
34
34
  */
@@ -139,7 +139,7 @@ export interface Product extends BaseProduct {
139
139
  /**
140
140
  * The 1-based product's position across the non-paginated result set.
141
141
  *
142
- * E.g., if the product is the third one on the second page, and there are 10 products per page, its position is 13 (not 3).
142
+ * For example, if the product is the third one on the second page, and there are 10 products per page, its position is 13 (not 3).
143
143
  */
144
144
  position: number;
145
145
  }
@@ -1,4 +1,4 @@
1
- import dayjs, { type ConfigType } from 'dayjs';
1
+ import dayjs, { type ConfigType } from 'dayjs/esm/index.js';
2
2
  /**
3
3
  * The date format supported by the Search API.
4
4
  */
@@ -11,7 +11,7 @@ export interface PlanResponseSuccess {
11
11
  preprocessingOutput: {
12
12
  /**
13
13
  * The query response output generated by _trigger_ rules in the query
14
- * pipeline (i.e., by `execute`, `notify`, `query`, and `redirect` rules).
14
+ * pipeline (that is, by `execute`, `notify`, `query`, and `redirect` rules).
15
15
  */
16
16
  triggers: Trigger[];
17
17
  };
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Terms to highlight (with [stemming](https://docs.coveo.com/en/1576)) in the results.
3
3
  *
4
- * E.g., for the query "indexing consultant", where a result contains "Techzample is a consulting firm specializing in search indexes. It employs consultants that can analyze and improve your search index.", the `TermsToHighlight` might be `{ "indexing": ["indexes", "index"], "consultant": ["consulting", "consultants"] }`.
4
+ * For example, for the query "indexing consultant", where a result contains "Techzample is a consulting firm specializing in search indexes. It employs consultants that can analyze and improve your search index.", the `TermsToHighlight` might be `{ "indexing": ["indexes", "index"], "consultant": ["consulting", "consultants"] }`.
5
5
  */
6
6
  export type TermsToHighlight = {
7
7
  [originalTerm: string]: string[];
@@ -9,7 +9,7 @@ export type TermsToHighlight = {
9
9
  /**
10
10
  * Phrases to highlight (with [stemming](https://docs.coveo.com/en/1576)) in the results.
11
11
  *
12
- * E.g., for the exact phrase "indexing consultant", where a result contains "Techzample is a consulting firm specializing in search indexes. It employs consultants that can analyze and improve your search index.", the `PhrasesToHighlight` might be `{ "indexing consultant": {"indexing": ["indexes", "index"], "consultant": ["consulting", "consultants"]}}`.
12
+ * For example, for the exact phrase "indexing consultant", where a result contains "Techzample is a consulting firm specializing in search indexes. It employs consultants that can analyze and improve your search index.", the `PhrasesToHighlight` might be `{ "indexing consultant": {"indexing": ["indexes", "index"], "consultant": ["consulting", "consultants"]}}`.
13
13
  */
14
14
  export declare type PhrasesToHighlight = {
15
15
  [originalPhrase: string]: TermsToHighlight;
@@ -22,7 +22,7 @@ export interface CaseAssistEngineConfiguration extends EngineConfiguration {
22
22
  */
23
23
  searchHub?: string;
24
24
  /**
25
- * The base URL to use to proxy Coveo case assist requests (e.g., `https://example.com/case-assist`).
25
+ * The base URL to use to proxy Coveo case assist requests (for example, `https://example.com/case-assist`).
26
26
  *
27
27
  * This is an advanced option that you only set if you proxy Coveo case assist requests through your own
28
28
  * server. In most cases, you should not set this option.
@@ -19,7 +19,7 @@ export interface CommerceEngineConfiguration extends EngineConfiguration {
19
19
  */
20
20
  cart?: CartInitialState;
21
21
  /**
22
- * The base URL to use to proxy Coveo commerce requests (e.g., `https://example.com/commerce`).
22
+ * The base URL to use to proxy Coveo commerce requests (for example, `https://example.com/commerce`).
23
23
  *
24
24
  * This is an advanced option that you only set if you proxy Coveo commerce requests through your own
25
25
  * server. In most cases, you should not set this option.
@@ -8,11 +8,11 @@ import type { CoveoFramework } from '../utils/version.js';
8
8
  */
9
9
  export interface EngineConfiguration {
10
10
  /**
11
- * The unique identifier of the target Coveo Cloud organization (e.g., `mycoveocloudorganizationg8tp8wu3`)
11
+ * The unique identifier of the target Coveo organization (for example, `mycoveocloudorganizationg8tp8wu3`)
12
12
  */
13
13
  organizationId: string;
14
14
  /**
15
- * The access token to use to authenticate requests against the Coveo Cloud endpoints. Typically, this will be an API key or search token that grants the privileges to execute queries and push usage analytics data in the target Coveo Cloud organization.
15
+ * The access token to use to authenticate requests against the Coveo endpoints. Typically, this will be an API key or search token that grants the privileges to execute queries and push usage analytics data in the target Coveo organization.
16
16
  */
17
17
  accessToken: string;
18
18
  /**
@@ -28,7 +28,7 @@ export interface EngineConfiguration {
28
28
  */
29
29
  preprocessRequest?: PreprocessRequest;
30
30
  /**
31
- * The Engine name (e.g., myEngine). Specifying your Engine name will help in debugging when using an application with multiple Redux stores.
31
+ * The Engine name (for example, myEngine). Specifying your Engine name will help in debugging when using an application with multiple Redux stores.
32
32
  * @defaultValue 'coveo-headless'
33
33
  */
34
34
  name?: string;
@@ -39,7 +39,7 @@ export interface EngineConfiguration {
39
39
  /**
40
40
  * The environment in which the organization is hosted.
41
41
  *
42
- * The `dev` and `stg` environments are only available internally for Coveo employees (e.g., Professional Services).
42
+ * The `dev` and `stg` environments are only available internally for Coveo employees (for example, Professional Services).
43
43
  *
44
44
  * Defaults to `prod`.
45
45
  */
@@ -116,8 +116,8 @@ export interface AnalyticsConfiguration {
116
116
  trackingId?: string;
117
117
  /**
118
118
  * The analytics client to use.
119
- * - `legacy`: The legacy analytics client, i.e., the Coveo Analytics.js library.
120
- * - `next`: The next analytics client, i.e., the Coveo Event Protocol with the Relay library.
119
+ * - `legacy`: The legacy analytics client, that is, the Coveo Analytics.js library.
120
+ * - `next`: The next analytics client, that is, the Coveo Event Protocol with the Relay library.
121
121
  *
122
122
  * The default value is `next`.
123
123
  *
@@ -130,7 +130,7 @@ export interface AnalyticsConfiguration {
130
130
  */
131
131
  source?: Partial<Record<CoveoFramework, string>>;
132
132
  /**
133
- * The base URL to use to proxy Coveo analytics requests (e.g., `https://example.com/analytics`).
133
+ * The base URL to use to proxy Coveo analytics requests (for example, `https://example.com/analytics`).
134
134
  *
135
135
  * This is an advanced option that you only set if you proxy Coveo analytics requests through your own
136
136
  * server. In most cases, you should not set this option.
@@ -26,7 +26,7 @@ export interface InsightEngineSearchConfigurationOptions {
26
26
  */
27
27
  locale?: string;
28
28
  /**
29
- * The base URL to use to proxy Coveo insight requests (e.g., `https://example.com/insight`).
29
+ * The base URL to use to proxy Coveo insight requests (for example, `https://example.com/insight`).
30
30
  *
31
31
  * This is an advanced option that you only set if you proxy Coveo insight requests through your own
32
32
  * server. In most cases, you should not set this option.
@@ -38,7 +38,7 @@ export interface RecommendationEngineConfiguration extends EngineConfiguration {
38
38
  */
39
39
  preprocessSearchResponseMiddleware?: PostprocessSearchResponseMiddleware;
40
40
  /**
41
- * The base URL to use to proxy Coveo search requests (e.g., `https://example.com/search`).
41
+ * The base URL to use to proxy Coveo search requests (for example, `https://example.com/search`).
42
42
  *
43
43
  * This is an advanced option that you only set if you proxy Coveo search requests through your own
44
44
  * server. In most cases, you should not set this option.
@@ -58,7 +58,7 @@ export interface SearchConfigurationOptions {
58
58
  */
59
59
  preprocessQuerySuggestResponseMiddleware?: PostprocessQuerySuggestResponseMiddleware;
60
60
  /**
61
- * The base URL to use to proxy Coveo search requests (e.g., `https://example.com/search`).
61
+ * The base URL to use to proxy Coveo search requests (for example, `https://example.com/search`).
62
62
  *
63
63
  * This is an advanced option that you only set if you proxy Coveo searchrequests through your own
64
64
  * server. In most cases, you should not set this option.
@@ -1,5 +1,6 @@
1
1
  /**
2
- * The Coveo Headless Commerce sub-package exposes exposes the engine, controllers, actions, and utility functions to build a commerce search experience.
2
+ * The Coveo Headless Commerce sub-package exposes the engine, controllers, actions, and utility functions to
3
+ * build a [commerce search experience](https://docs.coveo.com/en/o6r70022/).
3
4
  *
4
5
  * @example
5
6
  * ```typescript
@@ -5,7 +5,7 @@ export type { NumericFacetBreadcrumb, FacetBreadcrumb, DateFacetBreadcrumb, Cate
5
5
  /**
6
6
  * The `BreadcrumbManager` headless controller manages a summary of the currently active facet filters.
7
7
  *
8
- * Example: [breadcrumb-manager.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/breadcrumb-manager/breadcrumb-manager.fn.tsx)
8
+ * Example: [breadcrumb-manager.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/breadcrumb-manager/breadcrumb-manager.fn.tsx)
9
9
  *
10
10
  * @group Controllers
11
11
  * @category BreadcrumbManager
@@ -44,7 +44,7 @@ export interface BreadcrumbManagerState {
44
44
  */
45
45
  facetBreadcrumbs: Breadcrumb<AnyFacetValueResponse>[];
46
46
  /**
47
- * Whether any breadcrumbs are available (i.e., if any facet values are currently active).
47
+ * Whether any breadcrumbs are available (that is, if any facet values are currently active).
48
48
  */
49
49
  hasBreadcrumbs: boolean;
50
50
  }
@@ -29,7 +29,6 @@ export interface FacetGenerator extends Controller {
29
29
  state: string[];
30
30
  /**
31
31
  * The facet sub-controllers created by the facet generator.
32
- * Array of [RegularFacet](./regular-facet), [DateRangeFacet](./date-range-facet), [NumericFacet](./numeric-facet), [CategoryFacet](./category-facet), and [LocationFacet](./location-facet).
33
32
  */
34
33
  facets: GeneratedFacetControllers;
35
34
  /**
@@ -1,5 +1,5 @@
1
1
  import { type SchemaDefinition } from '@coveo/bueno';
2
- import { type UnknownAction } from '@reduxjs/toolkit';
2
+ import type { UnknownAction } from '@reduxjs/toolkit';
3
3
  import type { CommerceEngine } from '../../../../app/commerce-engine/commerce-engine.js';
4
4
  import { stateKey } from '../../../../app/state-key.js';
5
5
  import type { Parameters } from '../../../../features/commerce/parameters/parameters-actions.js';
@@ -43,7 +43,7 @@ export interface ParameterManagerInitialState<T> {
43
43
  parameters: T;
44
44
  }
45
45
  /**
46
- * The `ParameterManager` sub-controller allows restoring parameters that affect the results (e.g., from the URL).
46
+ * The `ParameterManager` sub-controller allows restoring parameters that affect the results (for example, from the URL).
47
47
  *
48
48
  * @group Sub-controllers
49
49
  * @category ParameterManager
@@ -60,7 +60,7 @@ export interface CategoryFilterSuggestions extends Controller, FacetControllerTy
60
60
  * updated query.
61
61
  *
62
62
  * For example, if this method is called with `jeans` as an argument, it will request values from the controller's
63
- * field (e.g., `ec_category`) that would return results if selected when the search query is `jeans` (such as
63
+ * field (for example, `ec_category`) that would return results if selected when the search query is `jeans` (such as
64
64
  * `Clothing`, `Clothing;Pants`, and `Clothing;Shorts`).
65
65
  *
66
66
  * @param query - The search query to use as context to request the category filter suggestions. In a typical
@@ -61,7 +61,7 @@ export interface FilterSuggestions extends Controller, FacetControllerType<'regu
61
61
  * query.
62
62
  *
63
63
  * For example, if this method is called with `jeans` as an argument, it will request values from the controller's
64
- * field (e.g., `ec_brand`) that would return results if selected when the search query is `jeans` (such as
64
+ * field (for example, `ec_brand`) that would return results if selected when the search query is `jeans` (such as
65
65
  * `Calvin Klein`, `Columbia`, and `Nautica`).
66
66
  *
67
67
  * @param query - The search query to use as context to request the category filter suggestions. In a typical
@@ -41,7 +41,7 @@ export interface InstantProducts extends Controller {
41
41
  *
42
42
  * This method is useful when leveraging the product grouping feature to allow users to select nested products.
43
43
  *
44
- * E.g., if a product has children (such as color variations), you can call this method when the user selects a child
44
+ * For example, if a product has children (such as color variations), you can call this method when the user selects a child
45
45
  * to make that child the new parent product, and re-render the product as such in the storefront.
46
46
  *
47
47
  * **Note:** In the controller state, a product that has children will always include itself as its own child so that
@@ -8,7 +8,7 @@ import type { ProductListingSummaryState } from './summary/headless-product-list
8
8
  /**
9
9
  * The `ProductListing` controller exposes a method for retrieving product listing content in a commerce interface.
10
10
  *
11
- * Example: [product-listing.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/commerce/product-listing.fn.tsx)
11
+ * Example: [product-listing.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/commerce/product-listing.fn.tsx)
12
12
  *
13
13
  * @group Buildable controllers
14
14
  * @category ProductListing
@@ -29,7 +29,7 @@ export interface ProductListing extends Controller, SearchAndListingSubControlle
29
29
  *
30
30
  * This method is useful when leveraging the product grouping feature to allow users to select nested products.
31
31
  *
32
- * E.g., if a product has children (such as color variations), you can call this method when the user selects a child
32
+ * For example, if a product has children (such as color variations), you can call this method when the user selects a child
33
33
  * to make that child the new parent product, and re-render the product as such in the storefront.
34
34
  *
35
35
  * **Note:** In the controller state, a product that has children will always include itself as its own child so that
@@ -44,7 +44,7 @@ export interface RecentQueriesState {
44
44
  */
45
45
  maxLength: number;
46
46
  /**
47
- * Whether analytics & tracking are enabled.
47
+ * Whether analytics and tracking are enabled.
48
48
  * In the case where it is disabled, it is recommended not to save recent queries.
49
49
  */
50
50
  analyticsEnabled: boolean;
@@ -7,7 +7,7 @@ import type { SummaryState } from '../core/summary/headless-core-summary.js';
7
7
  /**
8
8
  * The `Recommendations` controller exposes a method for retrieving recommendations content in a commerce interface.
9
9
  *
10
- * Example: [recommendations.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/commerce/recommendations.fn.tsx)
10
+ * Example: [recommendations.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/commerce/recommendations.fn.tsx)
11
11
  *
12
12
  * @group Buildable controllers
13
13
  * @category Recommendations
@@ -24,7 +24,7 @@ export interface Recommendations extends Controller, BaseSolutionTypeSubControll
24
24
  *
25
25
  * This method is useful when leveraging the product grouping feature to allow users to select nested products.
26
26
  *
27
- * E.g., if a product has children (such as color variations), you can call this method when the user selects a child
27
+ * For example, if a product has children (such as color variations), you can call this method when the user selects a child
28
28
  * to make that child the new parent product, and re-render the product as such in the storefront.
29
29
  *
30
30
  * **Note:** In the controller state, a product that has children will always include itself as its own child so that
@@ -51,7 +51,7 @@ export interface RecommendationsState {
51
51
  }
52
52
  export interface RecommendationsOptions {
53
53
  /**
54
- * The unique identifier of the recommendations slot (e.g., `b953ab2e-022b-4de4-903f-68b2c0682942`).
54
+ * The unique identifier of the recommendations slot (for example, `b953ab2e-022b-4de4-903f-68b2c0682942`).
55
55
  */
56
56
  slotId: string;
57
57
  /**
@@ -6,7 +6,7 @@ import { type SearchSubControllers } from '../core/sub-controller/headless-sub-c
6
6
  /**
7
7
  * The `Search` controller lets you create a commerce search page.
8
8
  *
9
- * Example: [search.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/commerce/search.fn.tsx)
9
+ * Example: [search.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/commerce/search.fn.tsx)
10
10
  *
11
11
  * @group Buildable controllers
12
12
  * @category Search
@@ -23,7 +23,7 @@ export interface Search extends Controller, SearchSubControllers {
23
23
  *
24
24
  * This method is useful when leveraging the product grouping feature to allow users to select nested products.
25
25
  *
26
- * E.g., if a product has children (such as color variations), you can call this method when the user selects a child
26
+ * For example, if a product has children (such as color variations), you can call this method when the user selects a child
27
27
  * to make that child the new parent product, and re-render the product as such in the storefront.
28
28
  *
29
29
  * **Note:** In the controller state, a product that has children will always include itself as its own child so that
@@ -54,7 +54,7 @@ export interface BreadcrumbManagerState {
54
54
  */
55
55
  staticFilterBreadcrumbs: StaticFilterBreadcrumb[];
56
56
  /**
57
- * Returns `true` if there are any available breadcrumbs (i.e., if there are any active facet values), and `false` if not.
57
+ * Returns `true` if there are any available breadcrumbs (that is, if there are any active facet values), and `false` if not.
58
58
  */
59
59
  hasBreadcrumbs: boolean;
60
60
  }
@@ -18,7 +18,7 @@ export interface ContextInitialState {
18
18
  * The `Context` controller injects [custom contextual information](https://docs.coveo.com/en/3389/)
19
19
  * into the search requests and usage analytics search events sent from a search interface.
20
20
  *
21
- * Example: [context.ts](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/context/context.ts)
21
+ * Example: [context.ts](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/context/context.ts)
22
22
  *
23
23
  * @group Controllers
24
24
  * @category Context
@@ -27,7 +27,7 @@ export interface DidYouMeanOptions {
27
27
  /**
28
28
  * The `DidYouMean` controller is responsible for handling query corrections.
29
29
  *
30
- * Example: [did-you-mean.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/did-you-mean/did-you-mean.fn.tsx)
30
+ * Example: [did-you-mean.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/did-you-mean/did-you-mean.fn.tsx)
31
31
  *
32
32
  * @group Controllers
33
33
  * @category DidYouMean
@@ -9,14 +9,14 @@ export interface FacetManagerPayload<T> {
9
9
  */
10
10
  facetId: string;
11
11
  /**
12
- * The payload to associate with the facetId. This can be anything e.g., a DOM element, JSX, a string.
12
+ * The payload to associate with the facetId. This can be anything such as a DOM element, JSX, a string.
13
13
  */
14
14
  payload: T;
15
15
  }
16
16
  /**
17
17
  * The `FacetManager` controller helps reorder facets to match the most recent search response.
18
18
  *
19
- * Example: [facet-manager.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/facet-manager/facet-manager.fn.tsx)
19
+ * Example: [facet-manager.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/facet-manager/facet-manager.fn.tsx)
20
20
  *
21
21
  * @group Controllers
22
22
  * @category FacetManager
@@ -13,8 +13,8 @@ export interface CategoryFacetProps {
13
13
  * The `CategoryFacet` headless controller offers a high-level interface for designing a facet UI controller that renders values hierarchically.
14
14
  *
15
15
  * Example:
16
- * - [category-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/category-facet/category-facet.fn.tsx)
17
- * - [category-facet-search.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/category-facet/category-facet-search.tsx)
16
+ * - [category-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/category-facet/category-facet.fn.tsx)
17
+ * - [category-facet-search.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/category-facet/category-facet-search.tsx)
18
18
  *
19
19
  * @group Controllers
20
20
  * @category CategoryFacet
@@ -12,14 +12,14 @@ interface CoreFacetProps {
12
12
  }
13
13
  /**
14
14
  * The `Facet` controller allows you to create a search interface component that the end user
15
- * can use to refine a query by selecting filters based on item metadata (i.e., field values).
15
+ * can use to refine a query by selecting filters based on item metadata (that is, field values).
16
16
  * If you have enabled a [Dynamic Navigation Experience (DNE)](https://docs.coveo.com/en/m2na0333/)
17
17
  * model, the `Facet` controller automatically reorders facet values according to the user query.
18
18
  *
19
19
  * Examples:
20
- * - [facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/facet/facet.fn.tsx)
21
- * - [facet-search.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/facet/facet-search.tsx)
22
- * - [facet.class.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/facet/facet.class.tsx)
20
+ * - [facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/facet/facet.fn.tsx)
21
+ * - [facet-search.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/facet/facet-search.tsx)
22
+ * - [facet.class.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/facet/facet.class.tsx)
23
23
  *
24
24
  * @group Controllers
25
25
  * @category Facet
@@ -17,8 +17,8 @@ export interface DateFacetProps {
17
17
  * The `DateFacet` controller makes it possible to create a facet with date ranges.
18
18
  *
19
19
  * Examples:
20
- * - [date-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/date-facet/date-facet.fn.tsx)
21
- * - [relative-date-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/relative-date-facet/relative-date-facet.fn.tsx)
20
+ * - [date-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/date-facet/date-facet.fn.tsx)
21
+ * - [relative-date-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/relative-date-facet/relative-date-facet.fn.tsx)
22
22
  *
23
23
  * @document relative-date-format.md
24
24
  *
@@ -93,7 +93,7 @@ export interface DateFilterState {
93
93
  /**
94
94
  * The `DateFilter` controller makes it possible to create a date filter.
95
95
  *
96
- * Example: [date-filter.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/date-filter/date-filter.fn.tsx)
96
+ * Example: [date-filter.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/date-filter/date-filter.fn.tsx)
97
97
  *
98
98
  * @group Controllers
99
99
  * @category DateFilter
@@ -16,7 +16,7 @@ export interface NumericFacetProps {
16
16
  /**
17
17
  * The `NumericFacet` controller makes it possible to create a facet with numeric ranges.
18
18
  *
19
- * Example: [numeric-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/numeric-facet/numeric-facet.fn.tsx)
19
+ * Example: [numeric-facet.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/numeric-facet/numeric-facet.fn.tsx)
20
20
  *
21
21
  * @group Controllers
22
22
  * @category NumericFacet
@@ -93,7 +93,7 @@ export interface NumericFilterState {
93
93
  /**
94
94
  * The `NumericFilter` controller makes it possible to create a numeric filter.
95
95
  *
96
- * Example: [numeric-filter.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/numeric-filter/numeric-filter.fn.tsx)
96
+ * Example: [numeric-filter.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/numeric-filter/numeric-filter.fn.tsx)
97
97
  *
98
98
  * @group Controllers
99
99
  * @category NumericFilter
@@ -53,7 +53,7 @@ export interface CoreFoldedResultListProps {
53
53
  /**
54
54
  * The `FoldedResultList` headless controller re-organizes results into hierarchical collections (a.k.a. threads).
55
55
  *
56
- * Example: [folded-result-list.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/folded-result-list/folded-result-list.fn.tsx)
56
+ * Example: [folded-result-list.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/folded-result-list/folded-result-list.fn.tsx)
57
57
  *
58
58
  * @group Controllers
59
59
  * @category FoldedResultList
@@ -27,7 +27,7 @@ export interface PagerProps {
27
27
  /**
28
28
  * The `Pager` controller allows to navigate through the different result pages.
29
29
  *
30
- * [pager.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/pager/pager.fn.tsx)
30
+ * [pager.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/pager/pager.fn.tsx)
31
31
  *
32
32
  * @group Controllers
33
33
  * @category Pager
@@ -4,7 +4,7 @@ import { type Controller } from '../../controller/headless-controller.js';
4
4
  /**
5
5
  * The `QueryError` controller allows to retrieve information about the current error returned by the search API, if any.
6
6
  *
7
- * Example: [query-error.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/query-error/query-error.fn.tsx)
7
+ * Example: [query-error.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/query-error/query-error.fn.tsx)
8
8
  *
9
9
  * @group Controllers
10
10
  * @category QueryError
@@ -25,14 +25,14 @@ export interface RecentQueriesListOptions {
25
25
  maxLength: number;
26
26
  /**
27
27
  * Whether to clear all active query filters when the end user submits a new query from the recent queries list.
28
- * Setting this option to "false" is not recommended & can lead to an increasing number of queries returning no results.
28
+ * Setting this option to "false" is not recommended and can lead to an increasing number of queries returning no results.
29
29
  */
30
30
  clearFilters?: boolean;
31
31
  }
32
32
  /**
33
33
  * The `RecentQueriesList` controller manages the user's recent queries.
34
34
  *
35
- * Example: [recent-queries.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/recent-queries/recent-queries.fn.tsx)
35
+ * Example: [recent-queries.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/recent-queries/recent-queries.fn.tsx)
36
36
  *
37
37
  * @group Controllers
38
38
  * @category RecentQueriesList
@@ -73,7 +73,7 @@ export interface RecentQueriesState {
73
73
  */
74
74
  maxLength: number;
75
75
  /**
76
- * Whether analytics & tracking are enabled.
76
+ * Whether analytics and tracking are enabled.
77
77
  * When analyticsEnabled is `false`, it is recommended not to save recent queries.
78
78
  */
79
79
  analyticsEnabled: boolean;
@@ -24,7 +24,7 @@ export interface ResultListProps {
24
24
  /**
25
25
  * The `ResultList` headless controller offers a high-level interface for designing a common result list UI controller.
26
26
  *
27
- * Example: [result-list.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/result-list/result-list.fn.tsx)
27
+ * Example: [result-list.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/result-list/result-list.fn.tsx)
28
28
  *
29
29
  * @group Controllers
30
30
  * @category ResultList
@@ -15,7 +15,7 @@ export interface ResultsPerPageInitialState {
15
15
  /**
16
16
  * The `ResultsPerPage` controller allows the end user to choose how many results to display per page.
17
17
  *
18
- * Example: [results-per-page.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/results-per-page/results-per-page.fn.tsx)
18
+ * Example: [results-per-page.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/results-per-page/results-per-page.fn.tsx)
19
19
  *
20
20
  * @group Controllers
21
21
  * @category ResultsPerPage
@@ -7,7 +7,7 @@ export interface SearchBoxOptions {
7
7
  */
8
8
  id?: string;
9
9
  /**
10
- * Whether to interpret advanced [Coveo Cloud query syntax](https://docs.coveo.com/en/1814/) in the query.
10
+ * Whether to interpret advanced [Coveo query syntax](https://docs.coveo.com/en/1552/) in the query.
11
11
  *
12
12
  * @defaultValue `false`
13
13
  */
@@ -17,7 +17,7 @@ export interface SearchBoxOptions {
17
17
  */
18
18
  highlightOptions?: SuggestionHighlightingOptions;
19
19
  /**
20
- * The number of query suggestions to request from Coveo ML (e.g., `3`).
20
+ * The number of query suggestions to request from Coveo ML (for example, `3`).
21
21
  *
22
22
  * Using the value `0` disables the query suggest feature.
23
23
  *
@@ -26,7 +26,7 @@ export interface SearchBoxOptions {
26
26
  numberOfSuggestions?: number;
27
27
  /**
28
28
  * Whether to clear all active query filters when the end user submits a new query from the search box.
29
- * Setting this option to "false" is not recommended & can lead to an increasing number of queries returning no results.
29
+ * Setting this option to "false" is not recommended and can lead to an increasing number of queries returning no results.
30
30
  */
31
31
  clearFilters?: boolean;
32
32
  }
@@ -66,7 +66,7 @@ export interface SmartSnippetRelatedQuestion {
66
66
  */
67
67
  documentId: QuestionAnswerDocumentIdentifier;
68
68
  /**
69
- * The unique identifier for this question & answer.
69
+ * The unique identifier for this question and answer.
70
70
  */
71
71
  questionAnswerId: string;
72
72
  /**
@@ -16,7 +16,7 @@ export interface SortInitialState {
16
16
  /**
17
17
  * The `Sort` controller manages how the results are sorted.
18
18
  *
19
- * Example: [sort.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/sort/sort.fn.tsx)
19
+ * Example: [sort.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/sort/sort.fn.tsx)
20
20
  *
21
21
  * @group Controllers
22
22
  * @category Sort
@@ -3,7 +3,7 @@ import { type Controller } from '../../controller/headless-controller.js';
3
3
  /**
4
4
  * The `SearchStatus` controller lets you access search status information.
5
5
  *
6
- * Example: [search-status.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/search-status/search-status.fn.tsx)
6
+ * Example: [search-status.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/search-status/search-status.fn.tsx)
7
7
  *
8
8
  * @group Controllers
9
9
  * @category SearchStatus
@@ -38,7 +38,7 @@ export interface TabProps {
38
38
  /**
39
39
  * The `Tab` headless controller offers a high-level interface for designing a common tab UI controller.
40
40
  *
41
- * Example: [tab.fn.tsx](https://github.com/coveo/ui-kit/blob/main/packages/samples/headless-react/src/components/tab/tab.fn.tsx)
41
+ * Example: [tab.fn.tsx](https://github.com/coveo/ui-kit/blob/main/samples/headless/search-react/src/components/tab/tab.fn.tsx)
42
42
  *
43
43
  * @group Controllers
44
44
  * @category Tab