@supersoniks/concorde 4.9.94 → 4.9.95

package/docs/src/docs/_misc/formelement-subscriber-removal.md

@@ -0,0 +1,115 @@
+# 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:
+
+```bash
+# 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.

package/docs/src/docs/_misc/html-integration.md

@@ -2,6 +2,8 @@
 
 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](#docs/_misc/formelement-subscriber-removal.md/formelement-subscriber-removal)).
+
 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 `<docs-joke-search-demo>`.
 
 | Goal | Use |

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

@@ -549,6 +549,171 @@
       }
     }
   },
+  {
+    "search": "Jsonata",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sonic-jsonata adapts the derive primitive: it watches input DataProviders (and optional form variables), evaluates a JSONata expression, and publishes a read-only output DataProvider.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Unlike sonic-mix (bidirectional composition, no compute), sonic-jsonata is unidirectional (fetch → compute → display).\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "jsonata": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Seed sessions via mock API or imperative set, then:\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "sdui-example-palmarès": {
+            "count": 1,
+            "title": "SDUI example (palmarès)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "No DOM, no network, no eval.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "helpers-whitelist": {
+            "count": 1,
+            "title": "Helpers (whitelist)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "type Session = { edito: { title: string }; stock: { internal: { revenue: number } } };\ntype Row = { titre: string; ca: number };\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "typescript--derive--dataproviderkey": {
+            "count": 1,
+            "title": "TypeScript — `derive` + `DataProviderKey`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const sessions = new DataProviderKey<Session[]>("sessions");\nconst form = new DataProviderKey<{ top: number }>("lbForm");\nconst palmares = new DataProviderKey<Row[]>("palmares");\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "typescript--derive--dataproviderkey": {
+            "count": 1,
+            "title": "TypeScript — `derive` + `DataProviderKey`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "const handle = derive({\n  inputs: { s: sessions },\n  variables: form,\n  output: palmares,\n  compute: async (i, v) => {\n    const expr = compileJsonata(\n      '$s{edito.title: $sum(stock.internal.revenue)} ~> $each(function($v,$k){{"titre":$k,"ca":$v}}) ^(>ca)[[0..$number($top)-1]]',\n    );\n    return expr.evaluate({}, { ...i, ...v }) as Row[];\n  },\n});\n// handle.stop() on disconnect\n  \n\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "typescript--derive--dataproviderkey": {
+            "count": 1,
+            "title": "TypeScript — `derive` + `DataProviderKey`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Compile-safe: pass DataProviderKey<T> — not bare untyped strings — for TS callers.\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "typescript--derive--dataproviderkey": {
+            "count": 1,
+            "title": "TypeScript — `derive` + `DataProviderKey`",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Status is published on {outputRoot}/_state_ as { status, error? } with status ∈ loading | ready | error | empty. Wire sonic-states with dataProvider="palmares/_state_" and data-path="status".\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "states": {
+            "count": 1,
+            "title": "States",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "See the live demo embedded below (fixtures demo14).\n",
+    "files": {
+      "core/components/functional/jsonata/jsonata.md": {
+        "title": "Jsonata",
+        "hashes": {
+          "demo-widget": {
+            "count": 1,
+            "title": "Demo widget",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "List",
     "files": {
@@ -3304,6 +3469,21 @@
       }
     }
   },
+  {
+    "search": "Use when you need client-side aggregations (groupby, top N, chart shapes) from existing DataProviders — without inline app JS in SDUI.\n",
+    "files": {
+      "docs/_core-concept/dataFlow.md": {
+        "title": "Data flow",
+        "hashes": {
+          "derived-data-derive--sonic-jsonata": {
+            "count": 1,
+            "title": "Derived data (`derive` / `sonic-jsonata`)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "lit + tailwind + vite",
     "files": {

package/docs/src/tsconfig.json

@@ -54,6 +54,12 @@
       "./functional/if": [
         "/sites/concorde/src/core/components/functional/if/if.ts"
       ],
+      "./jsonata": [
+        "/sites/concorde/src/core/components/functional/jsonata/jsonata.ts"
+      ],
+      "./functional/jsonata": [
+        "/sites/concorde/src/core/components/functional/jsonata/jsonata.ts"
+      ],
       "./list": [
         "/sites/concorde/src/core/components/functional/list/list.ts"
       ],
@@ -714,6 +720,9 @@
       "./decorators/subscriber/common": [
         "/sites/concorde/src/core/decorators/subscriber/common.ts"
       ],
+      "./decorators/subscriber/derive": [
+        "/sites/concorde/src/core/decorators/subscriber/derive.ts"
+      ],
       "./decorators/subscriber/dynamicPath": [
         "/sites/concorde/src/core/decorators/subscriber/dynamicPath.ts"
       ],
@@ -804,9 +813,18 @@
       "./utils/dataProviderKey": [
         "/sites/concorde/src/core/utils/dataProviderKey.ts"
       ],
+      "./utils/derive": [
+        "/sites/concorde/src/core/utils/derive.ts"
+      ],
       "./utils/endpoint": [
         "/sites/concorde/src/core/utils/endpoint.ts"
       ],
+      "./utils/jsonataHelpers": [
+        "/sites/concorde/src/core/utils/jsonataHelpers.ts"
+      ],
+      "./utils/jsonataRuntime": [
+        "/sites/concorde/src/core/utils/jsonataRuntime.ts"
+      ],
       "./utils/route": [
         "/sites/concorde/src/core/utils/route.ts"
       ],