@odla-ai/chapter 0.56.1 → 0.56.2

package/README.md

@@ -395,6 +395,45 @@ The same renderer can also replace the placeholder chooser inside
 ```
 
 `initialState` accepts trusted server state. On a browser redirect,
+### Shared application and additional-member controls
+
+`JoinIsland` owns application readiness. Its default Submit button and the
+`disabled` value passed to `renderSubmit` reflect required controls, native
+constraints, host-provided custom validity checks, conditional fields and recipient
+prefill. Use `JoinSubmitButton` in a custom submit slot to retain the packaged
+theme and disabled styling. `submitDisabled` remains an additional host gate.
+
+Use `AdditionalMemberFields` on Apply and `payment.additionalMember` for the
+packaged editor. Supply copy, application field names and theme tokens; do not
+reimplement validation, save/error handling, or action spacing in the host.
+Declare the same conditional name/email requirements in the server application
+field contract. The quote remains authoritative for price and saved details.
+
+```tsx
+const memberOptions = {
+  copy: { label: "A membership for your mother, daughter, or sister" },
+  names: { selected: "familySelected", name: "familyName", email: "familyEmail" },
+};
+const [member, setMember] = useState({ selected: false, name: "", email: "" });
+<JoinIsland config={config} payment={{
+  initialNamedSeat: additionalMemberSelection(member) ?? undefined,
+  additionalMember: { ...memberOptions, onSaved: setMember },
+  namedSeatLabel: "Additional family member",
+}}>
+  {/* Other site application fields */}
+  <AdditionalMemberFields {...memberOptions} value={member} onChange={setMember} offer={selectedTier?.seatOffer} />
+</JoinIsland>
+```
+
+Import these controls from `@odla-ai/chapter/ui/member`. The editor uses Save
+details for both included and paid members, a separate Cancel action, retryable
+errors, and disabled controls while saving. Checkout remains read-only until
+Edit details is chosen. Legacy `renderNamedSeatEditor` remains available for
+specialized composition; new hosts should use the packaged controls.
+`JourneyFrame` supplies responsive layout and uses `--ui-accent`,
+`--ui-on-accent`, `--ui-text-muted` and `--ui-surface-2` for enabled and disabled
+states. The default checkout editor also uses these shared fields and readiness.
+
 `JoinIsland` reads the `application` capability from the query string and asks
 `GET /api/join/resume` for the canonical payment, booking, or done state; raw
 `redirect_status` and `reschedule` values never choose a UI step. Supply