@supersoniks/concorde 4.9.9 → 4.9.92

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

@@ -4700,7 +4700,7 @@
     }
   },
   {
-    "search": "Loads data through API.getDetailed. The decorated property is ApiResult<T> | null: request, response (or null for dataProvider(...) resolution without HTTP), and typed result.\n",
+    "search": "@get loads data and stores the result in an optional ApiResult<T> property.\nThe property is undefined until a result is available.\n",
     "files": {
       "docs/_decorators/get.md": {
         "title": "@get",
@@ -4715,14 +4715,14 @@
     }
   },
   {
-    "search": "Pass an Endpoint<T> 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<T>. 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"
           }
         }
@@ -4730,14 +4730,44 @@
     }
   },
   {
-    "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 "" (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"
+          }
+        }
+      }
+    }
+  },
+  {
+    "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": {
+          "from-a-method-decorator": {
+            "count": 1,
+            "title": "From a method decorator",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Use { when: "before" } when the GET must be scheduled before the method:\n",
+    "files": {
+      "docs/_decorators/get.md": {
+        "title": "@get",
+        "hashes": {
+          "from-a-method-decorator": {
+            "count": 1,
+            "title": "From a method decorator",
             "type": "paragraph"
           }
         }
@@ -4745,7 +4775,22 @@
     }
   },
   {
-    "search": "Pass as the second argument (scoped config) or third (with a configuration key). Same shape as send decorators where applicable:\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": {
+          "from-a-method-decorator": {
+            "count": 1,
+            "title": "From a method decorator",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "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",
@@ -4760,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"
           }
         }
@@ -4775,14 +4820,24 @@
     }
   },
   {
-    "search": "Dynamic config and endpoint path (demo-api-get-configuration-key in doc sources):\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"
+          }
+        }
+      },
+      "docs/_decorators/post.md": {
+        "title": "@post",
+        "hashes": {
+          "options-postoptions": {
+            "count": 1,
+            "title": "Options (`PostOptions`)",
             "type": "paragraph"
           }
         }
@@ -4790,14 +4845,14 @@
     }
   },
   {
-    "search": "Scoped @get with @publish / @subscribe on the payload (see @publish and @subscribe) — wrap under an ancestor with serviceURL="/docs-mock-api/geo/":\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"
           }
         }
@@ -4805,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"
           }
         }
@@ -4820,9 +4875,9 @@
       "docs/_decorators/post.md": {
         "title": "@post",
         "hashes": {
-          "live-demos": {
+          "advanced": {
             "count": 1,
-            "title": "Live demos",
+            "title": "Advanced",
             "type": "paragraph"
           }
         }
@@ -5730,7 +5785,7 @@
     }
   },
   {
-    "search": "Sends data through API.patchDetailed. Same model as @post: decorated property is ApiResult<T> | 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<T>, DataProviderKey<B>, ApiResult<T>, options, and the\nsend(component) handle.\n",
     "files": {
       "docs/_decorators/patch.md": {
         "title": "@patch",
@@ -5745,14 +5800,39 @@
     }
   },
   {
-    "search": "Pass an Endpoint<T> 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"
           }
         }
@@ -5760,14 +5840,14 @@
     }
   },
   {
-    "search": "Same as @post / @get: scoped HTML.getApiConfiguration(host) or DataProviderKey<APIConfiguration> 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"
           }
         }
@@ -5775,9 +5855,9 @@
       "docs/_decorators/put.md": {
         "title": "@put",
         "hashes": {
-          "configuration": {
+          "minimal-usage": {
             "count": 1,
-            "title": "Configuration",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -5785,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\noptional ApiResult<T> property. The property is undefined until a result\nis available.\n",
+    "files": {
+      "docs/_decorators/post.md": {
+        "title": "@post",
         "hashes": {
-          "options-putoptions": {
+          "post": {
             "count": 1,
-            "title": "Options (`PutOptions`)",
+            "title": "",
             "type": "paragraph"
           }
         }
@@ -5810,14 +5895,14 @@
     }
   },
   {
-    "search": "@patch(\n  new Endpoint<Resource, { resourceId: string }>("resources/${resourceId}"),\n  patchBodyKey,\n  { skipEmptyPlaceholder: true },\n)\n@state()\npayload?: ApiResult<Resource> | null;\n  \n\n",
+    "search": "Pass an Endpoint<T> and a DataProviderKey<B> 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"
           }
         }
@@ -5825,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<T> | 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"
           }
         }
@@ -5855,14 +5940,14 @@
     }
   },
   {
-    "search": "Pass an Endpoint<T> 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"
           }
         }
@@ -5870,14 +5955,14 @@
     }
   },
   {
-    "search": "Same as @get: scoped HTML.getApiConfiguration(host) by default, or DataProviderKey<APIConfiguration> 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"
           }
         }
@@ -5885,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"
           }
         }
@@ -5900,14 +5985,14 @@
     }
   },
   {
-    "search": "@post(\n  new Endpoint<SyncResponse, { sessionId: string }>("sessions/${sessionId}/sync"),\n  syncRequest,\n  { triggerKey: syncTrigger },\n)\n@state()\npayload?: ApiResult<SyncResponse> | null;\n  \n\n",
+    "search": "Use { when: "before" } 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"
           }
         }
@@ -5915,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"
           }
         }
@@ -5930,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"
           }
         }
@@ -5945,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"
           }
         }
@@ -5960,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"
           }
         }
@@ -6050,7 +6135,7 @@
     }
   },
   {
-    "search": "Sends data through API.putDetailed. Same model as @post: decorated property is ApiResult<T> | null (request, response, result).\n",
+    "search": "@put replaces a resource with the body from a publisher. It uses exactly the\nsame model as @post:\nEndpoint<T>, DataProviderKey<B>, ApiResult<T>, options, and the\nsend(component) handle.\n",
     "files": {
       "docs/_decorators/put.md": {
         "title": "@put",
@@ -6065,44 +6150,14 @@
     }
   },
   {
-    "search": "Pass an Endpoint<T> and a DataProviderKey for the request body. Import put and ApiResult from @supersoniks/concorde/decorators.\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": {
-          "put": {
+          "minimal-usage": {
             "count": 1,
-            "title": "",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "@put(new Endpoint<Resource, { resourceId: string }>("resources/${resourceId}"), bodyKey)\n@state()\npayload?: ApiResult<Resource> | 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",
-    "files": {
-      "docs/_decorators/put.md": {
-        "title": "@put",
-        "hashes": {
-          "example": {
-            "count": 1,
-            "title": "Example",
+            "title": "Minimal usage",
             "type": "paragraph"
           }
         }
@@ -6874,6 +6929,21 @@
       }
     }
   },
+  {
+    "search": "Everything after <!-- concorde-ai --> is replaced on each ai-init run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in AGENTS.concorde.md (overlay). If the preamble duplicates package AGENTS.md, ai-init slims or drops it and prints a warning. Legacy filenames AGENTS.overlay.md / AGENTS.starter.md are still accepted with a deprecation warning.\n",
+    "files": {
+      "docs/_getting-started/ai-agents.md": {
+        "title": "AI agents (skills & AGENTS.md)",
+        "hashes": {
+          "agentsmd-policy-non-invasive": {
+            "count": 1,
+            "title": "`AGENTS.md` policy (non-invasive)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Source files in the npm package: node_modules/@supersoniks/concorde/ai/ (see also ai/README.md in the Concorde repository).\n",
     "files": {