@supersoniks/concorde 4.9.93 → 4.9.95

package/docs/llms-full.txt

@@ -215,6 +215,63 @@ Plain HTML without Lit: HTML integration.
 
 ---
 
+## Jsonata
+
+- URL: https://concorde.supersoniks.org/crawl/core/components/functional/jsonata/jsonata.html
+- Doc ID: core/components/functional/jsonata/jsonata
+- Keywords: Concorde, supersoniks, core/components/functional/jsonata/jsonata, jsonata, Jsonata, functional component, sonic-jsonata, web component, sonic-mix, serviceURL="/docs-mock-api", inputProvider, $input, outputProvider, expression, formDataProvider, $top, $taxPercent
+
+Jsonata
+
+sonic-jsonata : 1 input → expression → 1 output (readonly).
+
+Unidirectional (fetch → compute → display), unlike sonic-mix.
+
+> Offline : serviceURL="/docs-mock-api" — Local API demos.
+
+Demos
+
+Groupby + top N
+
+Change Top N → recalcul sans refetch.
+
+Totaux (somme + taxe)
+
+Change Tax % → même idée.
+
+Attributes
+
+| Attribute | Role |
+|-----------|------|
+| inputProvider | Entrée ($input dans l’expression) |
+| outputProvider | Sortie (readonly) |
+| expression | Expression JSONata |
+| formDataProvider | Form optionnel ($top, $taxPercent, …) — même id que le form |
+| outputSchema | Schéma léger optionnel (type, required) |
+
+Helpers
+
+$ucFirst · $currency · $percent · $date · $toChart(items, labelKey, valueKey, datasetLabel?)
+
+Pas de DOM, pas de réseau, pas d’eval.
+
+Markup
+
+<sonic-jsonata
+  inputProvider="api/space-cats"
+  outputProvider="leaderboard"
+  formDataProvider="topForm"
+  expression='$input{name: $sum(points)} ~> $each(function($v,$k){{"name":$k,"points":$v}}) ^(>points)[[0..$number($top)-1]]'
+></sonic-jsonata>
+
+Pour du multi-entrées ou une fonction TS : primitive derive.
+
+States
+
+{output}/state → { status, error? } (loading | ready | error | empty). Brancher avec sonic-states.
+
+---
+
 ## List
 
 - URL: https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html
@@ -2503,7 +2560,8 @@ Quick map
 | HTTP GET | @get + Endpoint, or sonic-list / sonic-queue with fetch |
 | HTTP POST (body from store) | @post + Endpoint + body DataProviderKey |
 | HTTP PUT / PATCH (body from store) | @put / @patch — same model as @post |
-| Forms | formDataProvider + name on fields |
+| Forms | formDataProvider + name on fields (no Subscriber on form elements) |
+| Derived / aggregate (JSONata) | derive() or sonic-jsonata — Jsonata |
 | Offline doc demos | serviceURL="/docs-mock-api" — Local API demos |
 
 Skill: concorde-get-set-dp in the package ai/ folder.
@@ -2551,6 +2609,14 @@ npx @supersoniks/create-concorde-ts-starter my-app
 
 Interactive routes mirror these patterns (/concepts/, /demo/).
 
+Derived data (derive / sonic-jsonata)
+
+Use when you need client-side aggregations (groupby, top N, chart shapes) from existing DataProviders — without inline app JS in SDUI.
+
+- Primitive: derive({ inputs, compute, output, variables? }) from @supersoniks/concorde/utils (read-only output, debounce, generation, cycle detection, {output}/state).
+- SDUI adapter: sonic-jsonata (inputProvider → expression → outputProvider, optional formDataProvider).
+- vs sonic-mix: mix composes bidirectionally; jsonata computes unidirectionally.
+
 Legacy integration
 
 | Topic | Page |
@@ -3137,9 +3203,7 @@ Shared data: Sharing data.
 - Keywords: Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult, undefined, payload.result, payload.response, payload.request, 
 
 The first argument is always an
-[, serviceURL, refetch(component), 
-
-
+[, serviceURL, refetch(component)
 
 @get
 
@@ -3158,6 +3222,17 @@ const usersEndpoint = new Endpoint ("users");
 @state()
 payload?: ApiResult ;
 
+The same decorator adapts to a method. The method receives the complete
+ApiResult  payload after each GET:
+
+@get(usersEndpoint)
+handleUsers(payload?: ApiResult ) {
+  if (!payload) return;
+
+  console.log(payload.response?.status);
+  console.log(payload.result);
+}
+
 The first argument is always an
 Endpoint . API configuration is read
 from the HTML scope (serviceURL, token, etc.), so the component is usually
@@ -3185,6 +3260,20 @@ async refresh() {
 refetch(component) returns a Promise  | undefined> that resolves
 after the GET has completed.
 
+The named handle can also decorate a method and be reused for refetching:
+
+const usersGet = get(new Endpoint ("users"));
+
+@usersGet
+handleUsers(payload?: ApiResult ) {
+  // ...
+}
+
+@refetch(usersGet)
+reloadUsers() {
+  // The GET runs and handleUsers receives its payload.
+}
+
 From a method decorator
 
 The refetch can decorate a local method. The default is after; if the
@@ -3775,6 +3864,13 @@ const patchUser = patch(new Endpoint ("users/42"), bodyKey);
 @state()
 payload?: ApiResult ;
 
+The same decorator adapts to a method:
+
+@patch(new Endpoint ("users/42"), bodyKey)
+handlePatch(payload?: ApiResult ) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+
 To run the operation again from the component:
 
 async savePatch() {
@@ -3842,6 +3938,13 @@ const createUser = post(new Endpoint ("users"), userBodyKey);
 @state()
 payload?: ApiResult ;
 
+The same decorator adapts to a method and receives the complete payload:
+
+@post(new Endpoint ("users"), userBodyKey)
+handleCreate(payload?: ApiResult ) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+
 The current body is read from userBodyKey. By default, the POST is sent when
 the component connects and after each body mutation. Mutations in the same
 frame are coalesced into one request.
@@ -4011,6 +4114,13 @@ const updateUser = put(new Endpoint ("users/42"), bodyKey);
 @state()
 payload?: ApiResult ;
 
+The same decorator adapts to a method:
+
+@put(new Endpoint ("users/42"), bodyKey)
+handleUpdate(payload?: ApiResult ) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+
 To run the operation again from the component:
 
 async update() {
@@ -5364,6 +5474,9 @@ Routes
 |------|---------|
 | /docs-mock-api/api/users | sonic-list, sonic-fetch, sonic-queue (users) |
 | /docs-mock-api/api/users/:id | Single user, docs-user |
+| /docs-mock-api/api/space-cats | sonic-jsonata top-N demo |
+| /docs-mock-api/api/coffee-bags | fixtures / tests jsonata (?roast=) |
+| /docs-mock-api/api/market-order | sonic-jsonata totals demo |
 | POST /docs-mock-api/api/register | sonic-submit — JSON, multipart/form-data (sendAsFormData), or application/x-www-form-urlencoded (native  ); response includes parsed email + token |
 | POST /docs-mock-api/api/register/nested | Wrapped body { data: { id, token } } for submit-result-key demo |
 | GET /docs-mock-api/api/register/echo | Echoes query string (method="get" on submit) |
@@ -5531,16 +5644,138 @@ See also
 
 ---
 
+## FormElement without Subscriber (REDMINE-79569)
+
+- URL: https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html
+- Doc ID: docs/_misc/formelement-subscriber-removal
+- Keywords: Concorde, supersoniks, docs/_misc/formelement-subscriber-removal, formelement-subscriber-removal, FormElement without Subscriber (REDMINE-79569), reference, sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete, dataProvider, formDataProvider
+
+FormElement without Subscriber (REDMINE-79569)
+
+Form fields (sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete) no longer inherit the Subscriber mixin.
+
+Behaviour now
+
+| Before | After |
+|--------|--------|
+| Dual channel dataProvider (autofill) + formDataProvider | formDataProvider + name only |
+| Ancestor dataProvider auto-filled field props | Ignored by form fields |
+| noAutoFill on fields/buttons inside a dataProvider tree | Dead on form fields (attribute harmless; can be cleaned in apps) |
+
+Preview pattern still valid: form writes via formDataProvider, display card reads via dataProvider on a Subscriber (or @subscribe) sibling — not on the fields themselves.
+
+Migration checklist (apps)
+
+1. Prefer formDataProvider alone on forms / fieldsets.
+2. Drop redundant dataProvider={sameKey} on form containers when it only existed for field autofill.
+3. Prefill edit forms with set(formKey, row) / dp(formKey.field).set(...) before mount — not field dataProvider.
+4. Remove noAutoFill on sonic-button / fields when it only blocked Subscriber autofill.
+5. initFromPublisher still works (form publisher only).
+
+Billetterie collect — dual-channel risk
+
+Files under la-billetterie/concorde that mention both formDataProvider and dataProvider= (review; many are filter+queue, not field autofill):
+
+High priority (same key on form container)
+
+- la-billetterie/components/reservation-request/atoms/request-event-form.ts — form / fieldset with both attrs equal
+- la-billetterie/components/reservation/atoms/new-quote-form.ts
+- la-billetterie/components/stats/sales-summary/sales-summary.ts
+- la-billetterie/components/product/price-selection-form/price-selection-form.ts — formDataProvider + dataProvider="cart/editForm"
+- la-billetterie/components/user/account/link-ticket/link-ticket.ts — distinct keys (API vs form) — keep dataProvider only if used by fetch/submit siblings
+
+Filters + queue (usually OK)
+
+formDataProvider on filter bar, dataProvider on sonic-queue / list — no field autofill dependency:
+
+- access-control/components/event/list/index.ts
+- access-control/components/control/search/views/list.ts
+- la-billetterie/components/event/form-event-filter/form-event-filter.ts
+- la-billetterie/components/counter/ (agenda, store, reservation-request-treatment, …)
+- widgets/agenda/agenda.ts
+- … see full dual list in ticket notes / grep below
+
+Full dual-channel file list (55)
+
+concorde/src/access-control/components/control/search/views/list.ts
+concorde/src/access-control/components/event/list/index.ts
+concorde/src/la-billetterie/components/access-control-mobile/access-controller-picker.ts
+concorde/src/la-billetterie/components/accreditations-directory/accreditations-directory.ts
+concorde/src/la-billetterie/components/address/address-suggestion.ts
+concorde/src/la-billetterie/components/bulk/bulk.ts
+concorde/src/la-billetterie/components/campaign/campaign-content.ts
+concorde/src/la-billetterie/components/counter/agenda/agenda.ts
+concorde/src/la-billetterie/components/counter/event-selector/event-selector.ts
+concorde/src/la-billetterie/components/counter/order-validation/order-validation-settings.ts
+concorde/src/la-billetterie/components/counter/print/format-menu.ts
+concorde/src/la-billetterie/components/counter/reservation-request-treatment/reservation-request-treatment.ts
+concorde/src/la-billetterie/components/counter/store/counter-store.ts
+concorde/src/la-billetterie/components/counter/widgets-settings/widgets-settings-page.ts
+concorde/src/la-billetterie/components/custom-list/custom-list.ts
+concorde/src/la-billetterie/components/event/agenda/agenda.ts
+concorde/src/la-billetterie/components/event/atoms/buy-event-block/buy-event-block.ts
+concorde/src/la-billetterie/components/event/atoms/categorizedPrices/categorizedPrices.ts
+concorde/src/la-billetterie/components/event/event-store/event-store-content.ts
+concorde/src/la-billetterie/components/event/form-event-filter/form-event-filter.ts
+concorde/src/la-billetterie/components/form/event-selection/event-selection-filters.ts
+concorde/src/la-billetterie/components/form/event-selection/event-selection.ts
+concorde/src/la-billetterie/components/giftcards/giftcard-link.ts
+concorde/src/la-billetterie/components/layout/header.ts
+concorde/src/la-billetterie/components/orders/recover/recover.ts
+concorde/src/la-billetterie/components/placing/atoms/placement-choice/placement-choice.ts
+concorde/src/la-billetterie/components/placing/seatmap-view/seatmap-view.ts
+concorde/src/la-billetterie/components/product/price-selection-form/price-selection-form.ts
+concorde/src/la-billetterie/components/product/prices-form/price-button/price-button.ts
+concorde/src/la-billetterie/components/purchase/purchase-summary/complementary-info/complementary-info.ts
+concorde/src/la-billetterie/components/reservation-request/atoms/request-event-form.ts
+concorde/src/la-billetterie/components/reservation/atoms/new-quote-form.ts
+concorde/src/la-billetterie/components/reservation/reservation-content.ts
+concorde/src/la-billetterie/components/seatmap/seatmap.ts
+concorde/src/la-billetterie/components/shop/shop.ts
+concorde/src/la-billetterie/components/stats/dashboard/dashboard.ts
+concorde/src/la-billetterie/components/stats/event/event-stats-check.ts
+concorde/src/la-billetterie/components/stats/sales-summary/sales-summary.ts
+concorde/src/la-billetterie/components/subscription/atoms/quick-select-display-toggle/quick-select-display-toggle.ts
+concorde/src/la-billetterie/components/subscription/cart-quick-select.ts
+concorde/src/la-billetterie/components/subscription/edit/subscription-renew-form.ts
+concorde/src/la-billetterie/components/ticket/ticket-freeup.ts
+concorde/src/la-billetterie/components/tickets-app/default-router.ts
+concorde/src/la-billetterie/components/user/account/account-purchases.ts
+concorde/src/la-billetterie/components/user/account/account-tickets.ts
+concorde/src/la-billetterie/components/user/account/link-ticket/link-ticket.ts
+concorde/src/la-billetterie/components/user/form/login.ts
+concorde/src/la-billetterie/components/user/user-attach/buyer-attach-form.ts
+concorde/src/la-billetterie/components/user/user-attach/buyer-attach.ts
+concorde/src/la-billetterie/components/user/user-attach/owner-attach-form.ts
+concorde/src/la-billetterie/components/user/user-attach/subscription-attach-form.ts
+concorde/src/la-billetterie/components/user/user-attach/subscription-selector.ts
+concorde/src/la-billetterie/components/user/user-selector/user-selector.ts
+concorde/src/la-billetterie/components/user/user-suggest/user-suggest.ts
+concorde/src/widgets/agenda/agenda.ts
+
+Re-run audit:
+
+from la-billetterie
+rg -l 'formDataProvider' concorde/src | while read f; do rg -q 'dataProvider\s=' "$f" && echo "$f"; done
+
+Non-regression (Concorde docs)
+
+Smoke form demos: input, textarea, select, checkbox (incl. check-all), radio, switch, button form modes, input-autocomplete, queue + dataFilterProvider, submit, validation / sameValueAs.
+
+---
+
 ## HTML integration (no Lit)
 
 - URL: https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html
 - Doc ID: docs/_misc/html-integration
-- Keywords: Concorde, supersoniks, docs/_misc/html-integration, html-integration, HTML integration (no Lit), reference, data-bind, dataProvider, formDataProvider, src/docs/example/, , src/docs/example/*.ts, @subscribe
+- Keywords: Concorde, supersoniks, docs/_misc/html-integration, html-integration, HTML integration (no Lit), reference, data-bind, dataProvider, formDataProvider, sonic-input, name, src/docs/example/, 
 
 HTML integration (no Lit)
 
 Some hosts (legacy PHP pages, static HTML) embed Concorde components without a Lit build step. They can use HTML attributes such as data-bind, dataProvider, and formDataProvider on tags directly in the page.
 
+Form fields (sonic-input, checkbox, select, …) bind only via formDataProvider + name. They do not autofill from ancestor dataProvider (Subscriber was removed from FormElement — see FormElement without Subscriber).
+
 That style is not what we demonstrate in this doc site: live examples are Lit components under src/docs/example/, registered once and reused from Markdown via tags like  .
 
 | Goal | Use |

package/docs/llms.txt

@@ -19,6 +19,7 @@ Full text: https://concorde.supersoniks.org/llms-full.txt
 - [Date](https://concorde.supersoniks.org/crawl/core/components/functional/date/date.html) (core/components/functional/date/date): Nothing is displayed.
 - [Fetch](https://concorde.supersoniks.org/crawl/core/components/functional/fetch/fetch.html) (core/components/functional/fetch/fetch): > New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL="/docs-mock-api") to try examples offline.
 - [if](https://concorde.supersoniks.org/crawl/core/components/functional/if/if.html) (core/components/functional/if/if): The sonic-if component shows its slot when .condition is true. In Lit, bind .condition from store-driven state (@subscribe on a formDataProvider field) — live preview and TypeScript source are the sam
+- [Jsonata](https://concorde.supersoniks.org/crawl/core/components/functional/jsonata/jsonata.html) (core/components/functional/jsonata/jsonata): sonic-jsonata : 1 input → expression → 1 output (readonly).
 - [List](https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html) (core/components/functional/list/list): > Try offline: serviceURL="/docs-mock-api" and dataProvider="api/users" with key="data" — see Local API demos. Recommended patterns: Data flow.
 - [Mix](https://concorde.supersoniks.org/crawl/core/components/functional/mix/mix.html) (core/components/functional/mix/mix): Mix allows you to mix several subsets of dataProvider in a new key/value structure which is itself associated with a new dataProvider. The data update is then bidirectional.
 - [Queue](https://concorde.supersoniks.org/crawl/core/components/functional/queue/queue.html) (core/components/functional/queue/queue): > Try offline: serviceURL="/docs-mock-api" — see Local API demos. Row rendering: Data flow (.items property binding).
@@ -95,6 +96,7 @@ Custom
 - [Local API demos (offline)](https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html) (docs/_misc/docs-mock-api): The Concorde doc site does not call fragile third-party APIs during yarn dev. A Service Worker and the Vite dev middleware serve /docs-mock-api/* on the same origin.
 - [Dynamic path placeholders](https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html) (docs/_misc/dynamic-path): Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:
 - [Endpoint](https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html) (docs/_misc/endpoint): Endpoint<T, U> describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.
+- [FormElement without Subscriber (REDMINE-79569)](https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html) (docs/_misc/formelement-subscriber-removal): Form fields (sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete) no longer inherit the Subscriber mixin.
 - [HTML integration (no Lit)](https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html) (docs/_misc/html-integration): Some hosts (legacy PHP pages, static HTML) embed Concorde components without a Lit build step. They can use HTML attributes such as data-bind, dataProvider, and formDataProvider on tags directly in th
 
 ## Optional

package/docs/sitemap.xml

@@ -21,6 +21,9 @@
   <url>
     <loc>https://concorde.supersoniks.org/crawl/core/components/functional/if/if.html</loc>
   </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/jsonata/jsonata.html</loc>
+  </url>
   <url>
     <loc>https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html</loc>
   </url>
@@ -225,6 +228,9 @@
   <url>
     <loc>https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html</loc>
   </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html</loc>
+  </url>
   <url>
     <loc>https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html</loc>
   </url>

package/docs/src/core/components/functional/jsonata/jsonata.md

@@ -0,0 +1,56 @@
+# Jsonata
+
+`sonic-jsonata` : **1 input → expression → 1 output** (readonly).
+
+Unidirectional (fetch → compute → display), unlike [`sonic-mix`](#core/components/functional/mix/mix.md/mix).
+
+> Offline : `serviceURL="/docs-mock-api"` — [Local API demos](#docs/_misc/docs-mock-api.md/docs-mock-api).
+
+## Demos
+
+### Groupby + top N
+
+Change **Top N** → recalcul sans refetch.
+
+<docs-lit-demo for="docs-jsonata-space-cats-demo"></docs-lit-demo>
+
+### Totaux (somme + taxe)
+
+Change **Tax %** → même idée.
+
+<docs-lit-demo for="docs-jsonata-table-totals-demo"></docs-lit-demo>
+
+## Attributes
+
+| Attribute | Role |
+|-----------|------|
+| `inputProvider` | Entrée (`$input` dans l’expression) |
+| `outputProvider` | Sortie (readonly) |
+| `expression` | Expression JSONata |
+| `formDataProvider` | Form optionnel (`$top`, `$taxPercent`, …) — même id que le form |
+| `outputSchema` | Schéma léger optionnel (`type`, `required`) |
+
+## Helpers
+
+`$ucFirst` · `$currency` · `$percent` · `$date` · `$toChart(items, labelKey, valueKey, datasetLabel?)`
+
+Pas de DOM, pas de réseau, pas d’`eval`.
+
+## Markup
+
+<sonic-code language="html">
+  <template>
+&lt;sonic-jsonata
+  inputProvider="api/space-cats"
+  outputProvider="leaderboard"
+  formDataProvider="topForm"
+  expression='$input{name: $sum(points)} ~> $each(function($v,$k){{"name":$k,"points":$v}}) ^(>points)[[0..$number($top)-1]]'
+&gt;&lt;/sonic-jsonata&gt;
+  </template>
+</sonic-code>
+
+Pour du multi-entrées ou une fonction TS : primitive [`derive`](#docs/_core-concept/dataFlow.md/dataFlow).
+
+## States
+
+`{output}/_state_` → `{ status, error? }` (`loading` | `ready` | `error` | `empty`). Brancher avec `sonic-states`.

package/docs/src/core/components/ui/form/checkbox/checkbox.md

@@ -52,7 +52,7 @@
 ## Check all checkbox
 <sonic-code>
   <template>    
-      <div formDataProvider="checkbox-check-all-demo" dataProvider="checkbox-check-all-demo">
+      <div formDataProvider="checkbox-check-all-demo">
       <sonic-checkbox  name='someSharedName' value="all" checksAll>All</sonic-checkbox>
       <sonic-divider></sonic-divider>
       <div class="grid gap-2">

package/docs/src/docs/_core-concept/dataFlow.md

@@ -15,7 +15,8 @@ Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, d
 | HTTP GET | `@get` + `Endpoint`, or `sonic-list` / `sonic-queue` with `fetch` |
 | HTTP POST (body from store) | `@post` + `Endpoint` + body `DataProviderKey` |
 | HTTP PUT / PATCH (body from store) | `@put` / `@patch` — same model as `@post` |
-| Forms | `formDataProvider` + `name` on fields |
+| Forms | `formDataProvider` + `name` on fields (no Subscriber on form elements) |
+| Derived / aggregate (JSONata) | `derive()` or `sonic-jsonata` — [Jsonata](#core/components/functional/jsonata/jsonata.md/jsonata) |
 | Offline doc demos | `serviceURL="/docs-mock-api"` — [Local API demos](#docs/_misc/docs-mock-api.md/docs-mock-api) |
 
 Skill: `concorde-get-set-dp` in the package `ai/` folder.
@@ -69,6 +70,14 @@ npx @supersoniks/create-concorde-ts-starter my-app
 
 Interactive routes mirror these patterns (`/concepts/*`, `/demo/*`).
 
+## Derived data (`derive` / `sonic-jsonata`)
+
+Use when you need **client-side aggregations** (groupby, top N, chart shapes) from existing DataProviders — without inline app JS in SDUI.
+
+- Primitive: `derive({ inputs, compute, output, variables? })` from `@supersoniks/concorde/utils` (read-only output, debounce, generation, cycle detection, `{output}/_state_`).
+- SDUI adapter: [`sonic-jsonata`](#core/components/functional/jsonata/jsonata.md/jsonata) (`inputProvider` → `expression` → `outputProvider`, optional `formDataProvider`).
+- vs [`sonic-mix`](#core/components/functional/mix/mix.md/mix): mix composes bidirectionally; jsonata **computes** unidirectionally.
+
 ## Legacy integration
 
 | Topic | Page |

package/docs/src/docs/_decorators/get.md

@@ -17,6 +17,19 @@ const usersEndpoint = new Endpoint<User[]>("users");
 payload?: ApiResult<User[]>;
 ```
 
+The same decorator adapts to a method. The method receives the complete
+`ApiResult<T>` payload after each GET:
+
+```typescript
+@get(usersEndpoint)
+handleUsers(payload?: ApiResult<User[]>) {
+  if (!payload) return;
+
+  console.log(payload.response?.status);
+  console.log(payload.result);
+}
+```
+
 The first argument is always an
 [`Endpoint<T>`](#docs/_misc/endpoint.md/endpoint). API configuration is read
 from the HTML scope (`serviceURL`, token, etc.), so the component is usually
@@ -46,6 +59,22 @@ async refresh() {
 `refetch(component)` returns a `Promise<ApiResult<T> | undefined>` that resolves
 after the GET has completed.
 
+The named handle can also decorate a method and be reused for refetching:
+
+```typescript
+const usersGet = get(new Endpoint<User[]>("users"));
+
+@usersGet
+handleUsers(payload?: ApiResult<User[]>) {
+  // ...
+}
+
+@refetch(usersGet)
+reloadUsers() {
+  // The GET runs and handleUsers receives its payload.
+}
+```
+
 ### From a method decorator
 
 The refetch can decorate a local method. The default is `after`; if the
@@ -116,6 +145,8 @@ import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
   <template>
     <docs-demo-sources for="demo-api-get"></docs-demo-sources>
     <demo-api-get></demo-api-get>
+    <docs-demo-sources for="demo-api-get-method"></docs-demo-sources>
+    <demo-api-get-method></demo-api-get-method>
     <docs-demo-sources for="demo-api-get-configuration-key"></docs-demo-sources>
     <demo-api-get-configuration-key></demo-api-get-configuration-key>
   </template>

package/docs/src/docs/_decorators/patch.md

@@ -16,6 +16,15 @@ const patchUser = patch(new Endpoint<User>("users/42"), bodyKey);
 payload?: ApiResult<User>;
 ```
 
+The same decorator adapts to a method:
+
+```typescript
+@patch(new Endpoint<User>("users/42"), bodyKey)
+handlePatch(payload?: ApiResult<User>) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+```
+
 To run the operation again from the component:
 
 ```typescript

package/docs/src/docs/_decorators/post.md

@@ -17,6 +17,15 @@ const createUser = post(new Endpoint<User>("users"), userBodyKey);
 payload?: ApiResult<User>;
 ```
 
+The same decorator adapts to a method and receives the complete payload:
+
+```typescript
+@post(new Endpoint<User>("users"), userBodyKey)
+handleCreate(payload?: ApiResult<User>) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+```
+
 The current body is read from `userBodyKey`. By default, the POST is sent when
 the component connects and after each body mutation. Mutations in the same
 frame are coalesced into one request.
@@ -120,6 +129,8 @@ import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
   <template>
     <docs-demo-sources for="demo-api-post"></docs-demo-sources>
     <demo-api-post></demo-api-post>
+    <docs-demo-sources for="demo-api-post-method"></docs-demo-sources>
+    <demo-api-post-method></demo-api-post-method>
     <docs-demo-sources for="demo-api-post-dynamic"></docs-demo-sources>
     <demo-api-post-dynamic></demo-api-post-dynamic>
   </template>

package/docs/src/docs/_decorators/put.md

@@ -16,6 +16,15 @@ const updateUser = put(new Endpoint<User>("users/42"), bodyKey);
 payload?: ApiResult<User>;
 ```
 
+The same decorator adapts to a method:
+
+```typescript
+@put(new Endpoint<User>("users/42"), bodyKey)
+handleUpdate(payload?: ApiResult<User>) {
+  if (payload?.response?.ok) console.log(payload.result);
+}
+```
+
 To run the operation again from the component:
 
 ```typescript

package/docs/src/docs/_misc/docs-mock-api.md

@@ -16,6 +16,9 @@ TypeScript constants: `src/docs/mock-api/urls.ts` (`DOCS_MOCK_REQRES_SERVICE`, `
 |------|---------|
 | `/docs-mock-api/api/users` | `sonic-list`, `sonic-fetch`, `sonic-queue` (users) |
 | `/docs-mock-api/api/users/:id` | Single user, `docs-user` |
+| `/docs-mock-api/api/space-cats` | `sonic-jsonata` top-N demo |
+| `/docs-mock-api/api/coffee-bags` | fixtures / tests jsonata (`?roast=`) |
+| `/docs-mock-api/api/market-order` | `sonic-jsonata` totals demo |
 | `POST /docs-mock-api/api/register` | **sonic-submit** — JSON, `multipart/form-data` (`sendAsFormData`), or `application/x-www-form-urlencoded` (native `<form>`); response includes parsed `email` + `token` |
 | `POST /docs-mock-api/api/register/nested` | Wrapped body `{ data: { id, token } }` for `submit-result-key` demo |
 | `GET /docs-mock-api/api/register/echo` | Echoes query string (`method="get"` on submit) |