@algolia/wizard 0.84.0-rc.202.651 → 0.84.0-rc.202.653

package/dist/main.js

@@ -2315,7 +2315,7 @@ async function ensureApplication(resumeAppId) {
 // package.json
 var package_default = {
   name: "@algolia/wizard",
-  version: "0.84.0-rc.202.651",
+  version: "0.84.0-rc.202.653",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {
@@ -6321,7 +6321,10 @@ function ingestionInstructions(input) {
       "Write the script in the project's primary language, using Algolia's official client for that language. Do not use the raw HTTP API.",
       "After a successful ingest, the script must print exactly one line to stdout in the form `ALGOLIA_WIZARD_RECORD_COUNT=<n>`, where <n> is the total number of records pushed to Algolia. Print it last, on its own line, with no surrounding text.",
       recordSizeInstruction(input.appPlan),
-      "When you split one source item into several records, keep the fields that the search UI shows (title, description, URL parts) on every record. After you push the records, the script must set the index settings with attributeForDistinct set to the parent identifier and distinct set to true, so that a search returns each source item once.",
+      "When you split one source item into several records, keep the fields that the search UI shows (title, description, URL parts) on every record. After you push those split records, the script must set the index settings with attributeForDistinct set to the parent identifier and distinct set to true, so that a search returns each source item once.",
+      "After you push the records, set searchableAttributes to the primary text fields the UI will search and show. For any longer text field the UI may snippet (description, body, content), set attributesToSnippet (for example description:20). Without attributesToSnippet, Algolia returns no _snippetResult and Snippet helpers render blank.",
+      "Store plain text in fields the UI shows or snippets. Strip Markdown, HTML, and similar markup at index time (or index a separate plain-text field) so result rows do not show raw ###, backticks, or tags.",
+      "URL and slug fields used to build result links must resolve to real routes in this app. Do not invent ids or prefixes that the app does not serve.",
       ...algoliaClientDoc(input),
       "Install the Algolia client with the project's own package manager via runShell, declaring it in whatever manifest the project uses (e.g. package.json, requirements.txt, Gemfile, go.mod, composer.json) so the dependency is not just installed ad hoc.",
       `If the script loads its env vars from a file (e.g. via dotenv or an equivalent for its language) rather than the process environment directly, decide that up front and call writeCredentials on that file before you finish the script \u2014 do not wait to discover the need for it by having a writeFile call refused.`,
@@ -6366,6 +6369,7 @@ function searchInstructions(input) {
     indexedContentMessage ?? "",
     `Build the search UI for ${input.searchUiTarget}.`,
     "Create search UI only. Do not create or modify ingestion scripts, rake/manage/CLI tasks, migrations, seeders, or other data-loading code, even if the data looks incomplete.",
+    "Prefer Highlight (or the plain attribute) for titles and short fields. Use Snippet only for longer text, and only when attributesToSnippet is set for that attribute \u2014 via the index searchParameters (for example attributesToSnippet: ['body:20']) or index settings. Without it, _snippetResult is missing and the result panel looks empty even though search returns hits.",
     FILE_EDIT_INSTRUCTION,
     EXISTING_COMPONENT_INSTRUCTION,
     mountCandidateMessage,
@@ -6461,7 +6465,7 @@ function validationInstructions(input) {
     `The confirmed placement candidate was "${input.searchLocation ?? "unknown"}", but verify the actual mount rather than assuming the candidate was used.`,
     "Inspect the generated search component, its actual mount file, that file's parent layout and sibling controls, and the relevant content UI. Do not rely only on type checks or tests.",
     "Confirm that the application renders exactly one search bar. Check for an old search bar and duplicate mounts.",
-    "If the project sets a Content-Security-Policy, confirm that connect-src allows https://*.algolia.net, https://*.algolianet.com, and https://insights.algolia.io, and that search-insights is loaded from npm. Otherwise set sufficient=false.",
+    "If the project sets a Content-Security-Policy, confirm that connect-src allows https://*.algolia.net, https://*.algolianet.com, and https://insights.algolia.io, and that search-insights is loaded from npm (not a CDN). If a CSP exists and fails either check, set sufficient=false. If the project has no CSP, skip both checks: do not set sufficient=false, and do not ask to add a CSP.",
     "Confirm content-specific search is placed with the corresponding content or task controls. Shared navigation is valid only for genuinely app-wide search that fits the visual hierarchy and responsive layout without crowding primary actions.",
     "Confirm the input has a persistent accessible name; widget-provided combobox, popup, and item relationships and keyboard behavior are preserved; and loading, empty, and error status text is perceivable to assistive technology.",
     "Inspect the CSS that actually applies to the generated DOM. Confirm the results panel and the element drawing the input frame have non-transparent surfaces, the input frame is distinguishable from its surrounding background in every supported theme, text meets 4.5:1 contrast, meaningful boundaries and focus indicators meet 3:1, and no state relies on color alone.",
@@ -9370,7 +9374,7 @@ async function resetProjectState() {
 // package.json with { type: 'json' }
 var package_default2 = {
   name: "@algolia/wizard",
-  version: "0.84.0-rc.202.651",
+  version: "0.84.0-rc.202.653",
   description: "Magically implement Algolia functionality in your codebase",
   type: "module",
   engines: {

package/docs/algolia-sdk/instantsearch-setup-js.md

@@ -76,6 +76,17 @@ search.start()
 
 Ensure the attributes you map into the component match the entity. 'title' above is an example.
 
+### Highlight vs Snippet
+
+- Prefer `components.Highlight` (or the plain attribute) for titles and other short
+  fields. Highlight uses `_highlightResult`, which Algolia returns by default.
+- Use `components.Snippet` only for longer text. Snippet reads `_snippetResult`,
+  which is **empty unless** `attributesToSnippet` is set. Without it, the result
+  row renders blank while search still returns hits.
+- When you use Snippet, set `attributesToSnippet` on that index's
+  `searchParameters` (for example `['body:20']`), or as an index setting. Do both
+  for the same attribute names the template passes to Snippet.
+
 ### Navigation is `getURL`'s job, not the template's
 
 - `indices[].getURL` — `(item) => string`, a route that already exists; don't invent one.

package/docs/algolia-sdk/instantsearch-setup-react.md

@@ -68,6 +68,17 @@ export function Search() {
 
 Ensure the attributes you map into the component match the entity. 'title' above is an example.
 
+### Highlight vs Snippet
+
+- Prefer plain attributes or `<Highlight>` for titles and other short fields.
+  Highlight uses `_highlightResult`, which Algolia returns by default.
+- Use `<Snippet>` only for longer text. Snippet reads `_snippetResult`, which is
+  **empty unless** `attributesToSnippet` is set. Without it, the result row
+  renders blank while search still returns hits.
+- When you use Snippet, set `attributesToSnippet` on that index's
+  `searchParameters` (for example `['body:20']`), or as an index setting. Do both
+  for the same attribute names the component passes to Snippet.
+
 ### Navigation is `getURL`'s job, not the item component's
 
 - `indices[].getURL` — `(item) => string`, a route that already exists; don't invent one.

package/docs/algolia-sdk/instantsearch-setup-vue.md

@@ -154,6 +154,17 @@ function onFocusOut(event) {
 Adapt the label, placeholder, highlighted attributes, result content, and destination to
 the confirmed indexed entity. `products` and `name` above are examples.
 
+### Highlight vs Snippet
+
+- Prefer `ais-highlight` (or the plain attribute) for titles and other short fields.
+  Highlight uses `_highlightResult`, which Algolia returns by default.
+- Use `ais-snippet` only for longer text. Snippet reads `_snippetResult`, which is
+  **empty unless** `attributesToSnippet` is set. Without it, the result row
+  renders blank while search still returns hits.
+- When you use Snippet, set `attributesToSnippet` via `ais-configure` or that
+  index's search parameters (for example `['body:20']`), or as an index setting.
+  Do both for the same attribute names the template passes to the snippet.
+
 Details that break accessibility if changed:
 
 - `role="combobox"` on the `input`, not a wrapper — with `aria-controls` at the popup's

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@algolia/wizard",
-  "version": "0.84.0-rc.202.651",
+  "version": "0.84.0-rc.202.653",
   "description": "Magically implement Algolia functionality in your codebase",
   "type": "module",
   "engines": {