@supersoniks/concorde 4.9.7 → 4.9.91

package/src/docs/search/docs-search.json

@@ -350,19 +350,14 @@
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "lazy-load": {
+          "lazy-load--offset-and-limit": {
             "count": 1,
-            "title": "Lazy load",
+            "title": "Lazy load — `$offset` and `$limit`",
             "type": "paragraph"
           },
-          "manual-next-signal--supplement": {
+          "simple-batch-no-lazy-scroll": {
             "count": 1,
-            "title": "Manual next (signal) — supplement",
-            "type": "paragraph"
-          },
-          "simple-batch-no-pagination": {
-            "count": 1,
-            "title": "Simple batch (no pagination)",
+            "title": "Simple batch (no lazy scroll)",
             "type": "paragraph"
           }
         }
@@ -825,14 +820,14 @@
     }
   },
   {
-    "search": "In Lit apps, use defineQueue + .config on <sonic-queue> — typed Endpoint, DataProviderKey, enums. See src/docs/example/docs-queue-demos.ts.\n",
+    "search": "When the expression contains $offset and $limit, the queue:\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "queue": {
+          "lazy-load--offset-and-limit": {
             "count": 1,
-            "title": "",
+            "title": "Lazy load — `$offset` and `$limit`",
             "type": "paragraph"
           }
         }
@@ -840,14 +835,14 @@
     }
   },
   {
-    "search": "Required: endpoint + items. Add rowsAt when rows live in a nested property. Everything else has sensible defaults (strategy: Lazy, pageSize: 10, offset/limit query names).\n",
+    "search": "The doc mock implements this on GET /docs-mock-api/api/users?offset=…&per_page=… (paginateUsers in src/docs/mock-api/router.ts).\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "queue": {
+          "lazy-load--offset-and-limit": {
             "count": 1,
-            "title": "",
+            "title": "Lazy load — `$offset` and `$limit`",
             "type": "paragraph"
           }
         }
@@ -855,14 +850,14 @@
     }
   },
   {
-    "search": "Layout (class, id, …) stays on <sonic-queue> — not inside .config.\n",
+    "search": "Wrap the queue in a fixed height with overflow-y-auto so lazy load triggers when scrolling inside the box (same layout as the TS starter demo-queue-templates).\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "queue": {
+          "lazy-load--offset-and-limit": {
             "count": 1,
-            "title": "",
+            "title": "Lazy load — `$offset` and `$limit`",
             "type": "paragraph"
           }
         }
@@ -870,14 +865,14 @@
     }
   },
   {
-    "search": "When pagination is enabled (default QueueLoadStrategy.Lazy), the queue:\n",
+    "search": "Try scrolling after load — batches of 4 users. Search e.g. George, Bluth, or zzz for empty results.\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "lazy-load": {
+          "lazy-load--offset-and-limit": {
             "count": 1,
-            "title": "Lazy load",
+            "title": "Lazy load — `$offset` and `$limit`",
             "type": "paragraph"
           }
         }
@@ -885,14 +880,14 @@
     }
   },
   {
-    "search": "Mock: GET /docs-mock-api/api/users?offset=…&limit=… (paginateUsers in src/docs/mock-api/router.ts).\n",
+    "search": "Without $offset in the expression, the queue behaves like a single list (one batch), e.g. geo communes below.\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "lazy-load": {
+          "expression-example": {
             "count": 1,
-            "title": "Lazy load",
+            "title": "Expression example",
             "type": "paragraph"
           }
         }
@@ -900,37 +895,7 @@
     }
   },
   {
-    "search": "Wrap the queue in a fixed height with overflow-y-auto so lazy load triggers when scrolling inside the box.\n",
-    "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
-        "hashes": {
-          "lazy-load": {
-            "count": 1,
-            "title": "Lazy load",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Without pagination offset ( $offset not generated), the queue behaves as a single batch — see geo communes below.\n",
-    "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
-        "hashes": {
-          "lazy-load": {
-            "count": 1,
-            "title": "Lazy load",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Pass a filter DataProviderKey in defineQueue (same publisher as formDataProvider on the search form). On change, the queue:\n",
+    "search": "One search field (name="q") on formDataProvider="filter". The queue listens via dataFilterProvider="filter" and, on change:\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
@@ -945,7 +910,7 @@
     }
   },
   {
-    "search": "Use filteredFields in the config only when the form has fields that must not be sent to the API.\n",
+    "search": "Use filteredFields only when the form has extra fields that must not be sent to the API (e.g. filteredFields="rememberMe internalId").\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
@@ -960,7 +925,7 @@
     }
   },
   {
-    "search": "The users demo above wires docsQueueUsersFilterKey + sonic-input name="q". Mock filter: filterDocsUsers in src/docs/mock-api/fixtures.ts.\n",
+    "search": "The mock API filters before pagination — same haystack logic as the starter (filterDocsUsers in src/docs/mock-api/fixtures.ts, used by paginateUsers in router.ts / Service Worker):\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
@@ -975,29 +940,14 @@
     }
   },
   {
-    "search": "Default lazy scroll loads the next batch automatically. For a button that triggers the next batch via publishers — without touching the queue instance — use QueueLoadStrategy.Signal and a void next key (invalidate(), same idea as triggerKey on @get).\n",
-    "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
-        "hashes": {
-          "manual-next-signal--supplement": {
-            "count": 1,
-            "title": "Manual next (signal) — supplement",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "state exposes QueuePublisherState on the queue dataProvider: meta (e.g. total), loadedCount, hasMore. Wire sonic-button invalidate to the same next key.\n",
+    "search": "Geo communes: expression uses $limit only (no $offset) — one request, one batch.\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "manual-next-signal--supplement": {
+          "simple-batch-no-lazy-scroll": {
             "count": 1,
-            "title": "Manual next (signal) — supplement",
+            "title": "Simple batch (no lazy scroll)",
             "type": "paragraph"
           }
         }
@@ -1005,29 +955,14 @@
     }
   },
   {
-    "search": "Elsewhere: dp(usersNextKey).invalidate().\n",
+    "search": "Optional for hosts without Lit — see HTML integration.\n",
     "files": {
       "core/components/functional/queue/queue.md": {
         "title": "Queue",
         "hashes": {
-          "manual-next-signal--supplement": {
+          "html-template-children": {
             "count": 1,
-            "title": "Manual next (signal) — supplement",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Geo communes: one request, one batch ($limit only).\n",
-    "files": {
-      "core/components/functional/queue/queue.md": {
-        "title": "Queue",
-        "hashes": {
-          "simple-batch-no-pagination": {
-            "count": 1,
-            "title": "Simple batch (no pagination)",
+            "title": "HTML `<template>` children",
             "type": "paragraph"
           }
         }
@@ -2334,21 +2269,6 @@
       }
     }
   },
-  {
-    "search": "Emit a publisher signal on click (same idea as triggerKey on @get, or dataNextProvider on sonic-queue). Value is the publisher path.\n",
-    "files": {
-      "core/components/ui/button/button.md": {
-        "title": "Button",
-        "hashes": {
-          "invalidate": {
-            "count": 1,
-            "title": "Invalidate",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
   {
     "search": "Captcha",
     "files": {
@@ -4780,7 +4700,7 @@
     }
   },
   {
-    "search": "Loads data through API.getDetailed. The decorated property is ApiResult&lt;T&gt; | null: request, response (or null for dataProvider(...) resolution without HTTP), and typed result.\n",
+    "search": "@get loads data and stores the result in an ApiResult&lt;T&gt; | null property.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
@@ -4795,14 +4715,14 @@
     }
   },
   {
-    "search": "Pass an Endpoint&lt;T&gt; as the first argument. Import get and ApiResult from @supersoniks/concorde/decorators, and Endpoint from @supersoniks/concorde/utils/endpoint.\n",
+    "search": "The first argument is always an\nEndpoint&lt;T&gt;. API configuration is read\nfrom the HTML scope (serviceURL, token, etc.), so the component is usually\nplaced below an element that provides this configuration.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "get": {
+          "minimal-usage": {
             "count": 1,
-            "title": "",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -4810,14 +4730,14 @@
     }
   },
   {
-    "search": "${prop} on the endpoint or config key is resolved on the host. While a placeholder is null or undefined, no GET runs. Optional skipEmptyPlaceholder: true also blocks &quot;&quot; (empty string only). Details: Dynamic path placeholders.\n",
+    "search": "Keep the decorator in a constant to access refetch(component). Refetch only\ntargets the instance passed as the argument, even before it has received a\nresult.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "dynamic-path": {
+          "from-the-component": {
             "count": 1,
-            "title": "Dynamic path",
+            "title": "From the component",
             "type": "paragraph"
           }
         }
@@ -4825,14 +4745,14 @@
     }
   },
   {
-    "search": "Pass as the second argument (scoped config) or third (with a configuration key). Same shape as send decorators where applicable:\n",
+    "search": "The refetch can decorate a local method. The default is after; if the\nmethod returns a Promise, the GET waits for its resolution.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "options-getoptions": {
+          "from-a-method-decorator": {
             "count": 1,
-            "title": "Options (`GetOptions`)",
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -4840,14 +4760,14 @@
     }
   },
   {
-    "search": "Same pattern as @post: a publisher acts as a signal, independent of the response payload.\n",
+    "search": "Use { when: &quot;before&quot; } when the GET must be scheduled before the method:\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "manual-refetch-triggerkey": {
+          "from-a-method-decorator": {
             "count": 1,
-            "title": "Manual refetch (`triggerKey`)",
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -4855,14 +4775,14 @@
     }
   },
   {
-    "search": "Prefer triggerKey over mutating the API configuration publisher when you only want to reload the same URL — no need to touch serviceURL, tokens, etc.\n",
+    "search": "The method decorator adds an explicit trigger; changes to dynamic endpoint\nproperties and configuration publishers keep their existing automatic behavior.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "manual-refetch-triggerkey": {
+          "from-a-method-decorator": {
             "count": 1,
-            "title": "Manual refetch (`triggerKey`)",
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -4870,14 +4790,14 @@
     }
   },
   {
-    "search": "The docs mock adds an X-Fetched-At response header on /docs-mock-api/geo/communes so live demos can show when the last fetch happened (response.headers.get(&quot;X-Fetched-At&quot;)).\n",
+    "search": "Options are the second argument, or the third argument when an API\nconfiguration key is provided.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "manual-refetch-triggerkey": {
+          "options-getoptions": {
             "count": 1,
-            "title": "Manual refetch (`triggerKey`)",
+            "title": "Options (`GetOptions`)",
             "type": "paragraph"
           }
         }
@@ -4885,14 +4805,14 @@
     }
   },
   {
-    "search": "Same demo service as sonic-queue (/docs-mock-api/geo/). Publisher setup lives in decorators-demo-geo.ts and decorators-demo-subscribe-publish-get-demos.ts.\n",
+    "search": "With a configuration key, use:\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "minimal-example": {
+          "options-getoptions": {
             "count": 1,
-            "title": "Minimal example",
+            "title": "Options (`GetOptions`)",
             "type": "paragraph"
           }
         }
@@ -4900,29 +4820,24 @@
     }
   },
   {
-    "search": "@get with triggerKey — refresh button + X-Fetched-At timestamp in the UI:\n",
+    "search": "See Dynamic path placeholders for\ndynamic path details.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "live-demos": {
+          "when-the-get-runs-again": {
             "count": 1,
-            "title": "Live demos",
+            "title": "When the GET runs again",
             "type": "paragraph"
           }
         }
-      }
-    }
-  },
-  {
-    "search": "Dynamic config and endpoint path. Manual refetch is triggered from a separate component (same triggerKey publisher):\n",
-    "files": {
-      "docs/_decorators/get.md": {
-        "title": "@get",
+      },
+      "docs/_decorators/post.md": {
+        "title": "@post",
         "hashes": {
-          "live-demos": {
+          "options-postoptions": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Options (`PostOptions`)",
             "type": "paragraph"
           }
         }
@@ -4930,14 +4845,14 @@
     }
   },
   {
-    "search": "Scoped @get with @publish / @subscribe on the payload (see @publish and @subscribe) — wrap under an ancestor with serviceURL=&quot;/docs-mock-api/geo/&quot;:\n",
+    "search": "See @post,\n@put, and\n@patch for write operations.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "live-demos": {
+          "demos": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Demos",
             "type": "paragraph"
           }
         }
@@ -4945,14 +4860,14 @@
     }
   },
   {
-    "search": "Stale responses are ignored if the path or generation changed before the request finished.\n",
+    "search": "External invalidation is currently available through triggerKey; it is kept\nout of the main usage examples.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
         "hashes": {
-          "live-demos": {
+          "advanced": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Advanced",
             "type": "paragraph"
           }
         }
@@ -4960,9 +4875,9 @@
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "live-demos": {
+          "advanced": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Advanced",
             "type": "paragraph"
           }
         }
@@ -5870,7 +5785,7 @@
     }
   },
   {
-    "search": "Sends data through API.patchDetailed. Same model as @post: decorated property is ApiResult&lt;T&gt; | null (request, response, result).\n",
+    "search": "@patch applies a partial update with the body from a publisher. It uses the\nsame model as @post:\nEndpoint&lt;T&gt;, DataProviderKey&lt;B&gt;, ApiResult&lt;T&gt;, options, and the\nsend(component) handle.\n",
     "files": {
       "docs/_decorators/patch.md": {
         "title": "@patch",
@@ -5885,14 +5800,39 @@
     }
   },
   {
-    "search": "Pass an Endpoint&lt;T&gt; and a DataProviderKey for the request body. Import patch and ApiResult from @supersoniks/concorde/decorators.\n",
+    "search": "To run the operation again from the component:\n",
     "files": {
       "docs/_decorators/patch.md": {
         "title": "@patch",
         "hashes": {
-          "patch": {
+          "minimal-usage": {
             "count": 1,
-            "title": "",
+            "title": "Minimal usage",
+            "type": "paragraph"
+          }
+        }
+      },
+      "docs/_decorators/put.md": {
+        "title": "@put",
+        "hashes": {
+          "minimal-usage": {
+            "count": 1,
+            "title": "Minimal usage",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "The PATCH is also sent automatically when the body mutates, unless\nautoPostOnBodyMutation: false is set. The available options are described in\n@post:\n",
+    "files": {
+      "docs/_decorators/patch.md": {
+        "title": "@patch",
+        "hashes": {
+          "minimal-usage": {
+            "count": 1,
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -5900,14 +5840,14 @@
     }
   },
   {
-    "search": "Same as @post / @get: scoped HTML.getApiConfiguration(host) or DataProviderKey&lt;APIConfiguration&gt; as third argument.\n",
+    "search": "Pass explicit API configuration as the third argument:\n",
     "files": {
       "docs/_decorators/patch.md": {
         "title": "@patch",
         "hashes": {
-          "configuration": {
+          "minimal-usage": {
             "count": 1,
-            "title": "Configuration",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -5915,9 +5855,9 @@
       "docs/_decorators/put.md": {
         "title": "@put",
         "hashes": {
-          "configuration": {
+          "minimal-usage": {
             "count": 1,
-            "title": "Configuration",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -5925,24 +5865,29 @@
     }
   },
   {
-    "search": "Same shape as PostOptions on @post (ApiSendOptions): refetchEveryMs, skipIfBodyMissing, autoPostOnBodyMutation, triggerKey, skipEmptyPlaceholder. See Dynamic path placeholders for ${sessionId} and empty-string behaviour.\n",
+    "search": "@post",
     "files": {
-      "docs/_decorators/patch.md": {
-        "title": "@patch",
+      "docs/_decorators/post.md": {
+        "title": "@post",
         "hashes": {
-          "options-patchoptions": {
+          "post": {
             "count": 1,
-            "title": "Options (`PatchOptions`)",
-            "type": "paragraph"
+            "title": "",
+            "type": "page"
           }
         }
-      },
-      "docs/_decorators/put.md": {
-        "title": "@put",
+      }
+    }
+  },
+  {
+    "search": "@post sends the contents of a publisher and stores the response in an\nApiResult&lt;T&gt; | null property.\n",
+    "files": {
+      "docs/_decorators/post.md": {
+        "title": "@post",
         "hashes": {
-          "options-putoptions": {
+          "post": {
             "count": 1,
-            "title": "Options (`PutOptions`)",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -5950,14 +5895,14 @@
     }
   },
   {
-    "search": "@patch(\n  new Endpoint&lt;Resource, { resourceId: string }&gt;(&quot;resources/${resourceId}&quot;),\n  patchBodyKey,\n  { skipEmptyPlaceholder: true },\n)\n@state()\npayload?: ApiResult&lt;Resource&gt; | null;\n  \n\n",
+    "search": "Pass an Endpoint&lt;T&gt; and a DataProviderKey&lt;B&gt; for the request body.\n",
     "files": {
-      "docs/_decorators/patch.md": {
-        "title": "@patch",
+      "docs/_decorators/post.md": {
+        "title": "@post",
         "hashes": {
-          "example": {
+          "minimal-usage": {
             "count": 1,
-            "title": "Example",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -5965,29 +5910,29 @@
     }
   },
   {
-    "search": "@post",
+    "search": "The current body is read from userBodyKey. By default, the POST is sent when\nthe component connects and after each body mutation. Mutations in the same\nframe are coalesced into one request.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "post": {
+          "minimal-usage": {
             "count": 1,
-            "title": "",
-            "type": "page"
+            "title": "Minimal usage",
+            "type": "paragraph"
           }
         }
       }
     }
   },
   {
-    "search": "Sends data through API.postDetailed. The decorated property is ApiResult&lt;T&gt; | null: request, response, and typed result.\n",
+    "search": "API configuration is read from the HTML scope, as with\n@get.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "post": {
+          "minimal-usage": {
             "count": 1,
-            "title": "",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -5995,14 +5940,14 @@
     }
   },
   {
-    "search": "Pass an Endpoint&lt;T&gt; as the first argument and a DataProviderKey for the request body as the second. Import post and ApiResult from @supersoniks/concorde/decorators, and Endpoint from @supersoniks/concorde/utils/endpoint.\n",
+    "search": "Keep the decorator to access send(component). The body is read again when the\noperation runs.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "post": {
+          "from-the-component": {
             "count": 1,
-            "title": "",
+            "title": "From the component",
             "type": "paragraph"
           }
         }
@@ -6010,14 +5955,14 @@
     }
   },
   {
-    "search": "Same as @get: scoped HTML.getApiConfiguration(host) by default, or DataProviderKey&lt;APIConfiguration&gt; as third argument. See API configuration for mock demos.\n",
+    "search": "send() is useful for “Save” or “Retry” buttons. It can repeat an operation\nwith side effects.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "configuration": {
+          "from-the-component": {
             "count": 1,
-            "title": "Configuration",
+            "title": "From the component",
             "type": "paragraph"
           }
         }
@@ -6025,14 +5970,14 @@
     }
   },
   {
-    "search": "Mock service: POST /docs-mock-api/api/register (same route as sonic-submit demos). Publisher setup lives in decorators-demo-post.ts.\n",
+    "search": "The send action can decorate a local method. It runs after the method by\ndefault and waits for an eventual Promise to resolve:\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "minimal-example": {
+          "from-a-method-decorator": {
             "count": 1,
-            "title": "Minimal example",
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -6040,14 +5985,14 @@
     }
   },
   {
-    "search": "@post(\n  new Endpoint&lt;SyncResponse, { sessionId: string }&gt;(&quot;sessions/${sessionId}/sync&quot;),\n  syncRequest,\n  { triggerKey: syncTrigger },\n)\n@state()\npayload?: ApiResult&lt;SyncResponse&gt; | null;\n  \n\n",
+    "search": "Use { when: &quot;before&quot; } when the body must be sent before the method runs:\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "minimal-example": {
+          "from-a-method-decorator": {
             "count": 1,
-            "title": "Minimal example",
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -6055,14 +6000,14 @@
     }
   },
   {
-    "search": "Dynamic endpoint path — changing sessionId on the host re-runs the POST (POST /docs-mock-api/api/sessions/{id}/sync):\n",
+    "search": "The method decorator adds an explicit send. If the method also mutates the body\npublisher, set autoPostOnBodyMutation: false when the decorated method must\nbe the only trigger.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "live-demos": {
+          "from-a-method-decorator": {
             "count": 1,
-            "title": "Live demos",
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -6070,14 +6015,14 @@
     }
   },
   {
-    "search": "@post + @publish on the same property (see @publish):\n",
+    "search": "Options are the third argument, or the fourth argument when a configuration key\nis provided.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "live-demos": {
+          "options-postoptions": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Options (`PostOptions`)",
             "type": "paragraph"
           }
         }
@@ -6085,14 +6030,14 @@
     }
   },
   {
-    "search": "Note: plusieurs composants @post sur la même page qui partagent le même bodyKey enverront chacun une requête à chaque mutation du body — utiliser une clé par composant (voir les deux démos live ci-dessus).\n",
+    "search": "With a configuration key:\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "live-demos": {
+          "options-postoptions": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Options (`PostOptions`)",
             "type": "paragraph"
           }
         }
@@ -6100,14 +6045,14 @@
     }
   },
   {
-    "search": "Path placeholders (${sessionId}, …): Dynamic path placeholders.\n",
+    "search": "See @put and\n@patch: they use the same model with a\ndifferent HTTP method.\n",
     "files": {
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "live-demos": {
+          "demos": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Demos",
             "type": "paragraph"
           }
         }
@@ -6190,22 +6135,7 @@
     }
   },
   {
-    "search": "Sends data through API.putDetailed. Same model as @post: decorated property is ApiResult&lt;T&gt; | null (request, response, result).\n",
-    "files": {
-      "docs/_decorators/put.md": {
-        "title": "@put",
-        "hashes": {
-          "put": {
-            "count": 1,
-            "title": "",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Pass an Endpoint&lt;T&gt; and a DataProviderKey for the request body. Import put and ApiResult from @supersoniks/concorde/decorators.\n",
+    "search": "@put replaces a resource with the body from a publisher. It uses exactly the\nsame model as @post:\nEndpoint&lt;T&gt;, DataProviderKey&lt;B&gt;, ApiResult&lt;T&gt;, options, and the\nsend(component) handle.\n",
     "files": {
       "docs/_decorators/put.md": {
         "title": "@put",
@@ -6220,29 +6150,14 @@
     }
   },
   {
-    "search": "@put(new Endpoint&lt;Resource, { resourceId: string }&gt;(&quot;resources/${resourceId}&quot;), bodyKey)\n@state()\npayload?: ApiResult&lt;Resource&gt; | null;\n  \n\n",
-    "files": {
-      "docs/_decorators/put.md": {
-        "title": "@put",
-        "hashes": {
-          "example": {
-            "count": 1,
-            "title": "Example",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "Changing resourceId on the host re-runs the PUT when the path becomes ready — see Dynamic path placeholders.\n",
+    "search": "The PUT is also sent automatically when the body mutates, unless\nautoPostOnBodyMutation: false is set. See\n@post for the option details:\n",
     "files": {
       "docs/_decorators/put.md": {
         "title": "@put",
         "hashes": {
-          "example": {
+          "minimal-usage": {
             "count": 1,
-            "title": "Example",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }