@odla-ai/chapter 0.56.0 → 0.56.2

package/dist/ui/index.d.ts

@@ -1,6 +1,6 @@
 export { APPLICATION_STAGES, AdminAccountMenuProps, AdminBuilderLibraryData, AdminChrome, AdminMemberContentData, AdminNote, AdminPage, AdminResource, AdminRouteState, AdminRouteTarget, AdminRouting, AdminSection, AdminSectionContext, AdminWorkspace, AdminWorkspaceFrameProps, AdminWorkspaceNavProps, AdmissionGrantsWorkspace, AvailabilitySectionOptions, BillingSectionOptions, BuilderLibraryAdmin, CandidateStagePanel, CandidateStagePanelProps, ChapterAdmin, ChapterAdminAuthAdapter, ChapterAdminAuthConfig, ChapterAdminAuthLoadContext, ChapterAdminProps, ChapterAdminUser, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, LeaderAdmissionAction, LeaderAdmissionActionProps, LeaderNetworkOverview, MeetingsSectionOptions, MemberContentAdmin, MembershipPolicyVersions, MembershipPolicyVersionsProps, NamedSeatRecordPanel, NamedSeatRecordPanelProps, NetworkRecordEditor, NetworkRecordsWorkspace, NetworkSeatBilling, NetworkShareActions, NetworkShareActionsProps, Panel, PaymentRecoveryQueue, PeopleSectionOptions, RecordActions, RecordActionsProps, RecordAdmissionPanel, RecordAdmissionPanelProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, admissionGrantsWorkspace, applicationLifecycleAdapter, availabilitySection, billingSection, builderLibrarySection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, memberContentSection, networkRecordsWorkspace, peopleSection, useAdminResource } from './admin/index.js';
 export { C as ChapterCopyProvider, u as useChapterCopy } from '../copy-context-CaUXIxUI.js';
-export { ApiFn, BrandStyle, BrandStyleProps, GiftCodeRedeemResult, GiftCodeRedeemer, GiftCodeRedeemerCopy, GiftCodeRedeemerProps, GiftOfferCards, GiftOfferCardsMode, GiftOfferCardsProps, GiftPurchases, GiftPurchasesProps, JoinBookingSimulation, JoinConfig, JoinFlowState, JoinIsland, JoinIslandProps, JoinSimulation, JoinStepRenderContext, JoinSubmitRenderContext, JoinTier, JoinTierRenderContext, JourneyFrame, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberContentArea, MemberContentAreaProps, MemberGifts, MemberProvisionalRenderContext, MemberRestart, MembersArea, MembersAreaProps, MembershipCardTokenName, MembershipCards, MembershipCardsMode, MembershipCardsProps, NAMED_SEAT_RECIPIENT_WORDS, NamedSeatPurchase, NamedSeatRecipientLine, PaymentPriceLines, PaymentStep, PaymentStepProps, PaymentStepSimulation, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, SubResponse, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection } from './member/index.js';
+export { ADDITIONAL_MEMBER_COPY, AdditionalMemberCopy, AdditionalMemberDraft, AdditionalMemberEditor, AdditionalMemberEditorOptions, AdditionalMemberEditorProps, AdditionalMemberFieldNames, AdditionalMemberFields, AdditionalMemberFieldsProps, AdditionalMemberOffer, AdditionalMemberOptions, ApiFn, BrandStyle, BrandStyleProps, CheckoutSeatEditor, CheckoutSeatEditorContext, GiftCodeRedeemResult, GiftCodeRedeemer, GiftCodeRedeemerCopy, GiftCodeRedeemerProps, GiftOfferCards, GiftOfferCardsMode, GiftOfferCardsProps, GiftPurchases, GiftPurchasesProps, JoinBookingSimulation, JoinConfig, JoinFlowState, JoinIsland, JoinIslandProps, JoinSimulation, JoinStepRenderContext, JoinSubmitButton, JoinSubmitRenderContext, JoinTier, JoinTierRenderContext, JourneyFrame, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberContentArea, MemberContentAreaProps, MemberGifts, MemberProvisionalRenderContext, MemberRestart, MembersArea, MembersAreaProps, MembershipCardTokenName, MembershipCards, MembershipCardsMode, MembershipCardsProps, NAMED_SEAT_RECIPIENT_WORDS, NamedSeatPurchase, NamedSeatRecipientLine, PaymentPriceLines, PaymentStep, PaymentStepProps, PaymentStepSimulation, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, SubResponse, TierPlaceholder, additionalMemberSelection, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection } from './member/index.js';
 import 'preact';
 import '@odla-ai/crm';
 import '@odla-ai/crm/ui';

package/dist/ui/index.js

@@ -1,8 +1,12 @@
 import {
+  ADDITIONAL_MEMBER_COPY,
+  AdditionalMemberEditor,
+  AdditionalMemberFields,
   GiftCodeRedeemer,
   GiftOfferCards,
   GiftPurchases,
   JoinIsland,
+  JoinSubmitButton,
   JourneyFrame,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
   MemberContentArea,
@@ -17,6 +21,7 @@ import {
   Rescheduler,
   SlotPicker,
   TierPlaceholder,
+  additionalMemberSelection,
   dayKey,
   dayLabel,
   fmtDate,
@@ -29,7 +34,7 @@ import {
   timeLabel,
   tzShort,
   useTierSelection
-} from "../chunk-IQZWCG42.js";
+} from "../chunk-E7CB5K2D.js";
 import {
   APPLICATION_STAGES,
   AdminNote,
@@ -82,7 +87,10 @@ import {
 } from "../chunk-4M2PN5K3.js";
 import "../chunk-IVXVECKR.js";
 export {
+  ADDITIONAL_MEMBER_COPY,
   APPLICATION_STAGES,
+  AdditionalMemberEditor,
+  AdditionalMemberFields,
   AdminNote,
   AdminPage,
   AdmissionGrantsWorkspace,
@@ -95,6 +103,7 @@ export {
   GiftOfferCards,
   GiftPurchases,
   JoinIsland,
+  JoinSubmitButton,
   JourneyFrame,
   LeaderAdmissionAction,
   LeaderNetworkOverview,
@@ -123,6 +132,7 @@ export {
   SlotPicker,
   ThemeWarning,
   TierPlaceholder,
+  additionalMemberSelection,
   adminFetch,
   adminRouteFromUrl,
   adminRouteHref,

package/dist/ui/member/index.d.ts

@@ -209,6 +209,8 @@ interface PaymentPriceLines {
     dueTodayCents: number;
     /** Included in dueTodayCents; zero means the selected SKU includes the additional member. */
     namedSeatCents?: number;
+    /** True when an included additional member is available but no recipient was selected. Display Pick later. */
+    namedSeatPickLater?: boolean;
     founding?: {
         cohortLabel: string;
     };
@@ -374,6 +376,106 @@ interface ChapterFlowFieldContract {
     fields: readonly ChapterFlowField[];
 }
 
+/** The optional recipient selected before the applicant consents to payment. */
+interface CheckoutNamedSeatSelection {
+    recipientName: string;
+    recipientEmail: string;
+}
+
+/** Reopens the host's original recipient fields before payment begins. */
+interface CheckoutSeatEditorContext {
+    /** Server-saved selection; null means the applicant has not chosen a recipient. */
+    selection: CheckoutNamedSeatSelection | null;
+    /** The current authority-owned additional-member price and billing interval. */
+    offer: {
+        amountCents: number;
+        currency: string;
+        interval: string;
+    };
+    /** Validate and save a recipient, or null to remove them, then return to checkout. */
+    save: (selection: CheckoutNamedSeatSelection | null) => Promise<void>;
+    /** Return to checkout without changing its saved selection. */
+    cancel: () => void;
+}
+/** Host-owned recipient fields reused from the application instead of a second checkout editor. */
+type CheckoutSeatEditor = (context: CheckoutSeatEditorContext) => ComponentChildren;
+
+/** Editable additional-member values retained while the selection checkbox is off. */
+interface AdditionalMemberDraft {
+    /** Whether the applicant wants to include this recipient. */
+    selected: boolean;
+    /** Recipient's full name. */
+    name: string;
+    /** Recipient's email address. */
+    email: string;
+}
+/** Price information supplied by the membership authority; zero means included. */
+interface AdditionalMemberOffer {
+    /** Additional amount in minor currency units. */
+    amountCents: number;
+    /** ISO currency code; defaults to USD for display. */
+    currency?: string;
+    /** Billing interval; defaults to year for display. */
+    interval?: string;
+}
+/** Site wording for shared recipient controls; behavior and validation remain in Chapter. */
+interface AdditionalMemberCopy {
+    /** Heading above the selection. */
+    label: string;
+    /** Checkbox label for an included recipient. */
+    includedChoice: string;
+    /** Checkbox label for a paid recipient. */
+    paidChoice: string;
+    /** Explanation when the additional membership costs zero. */
+    includedHint: string;
+    /** Explanation when the authority has not supplied a price yet. */
+    pendingHint: string;
+    /** Heading when editing a previously selected recipient. */
+    editTitle: string;
+}
+/** Form field names must match the host's server-side application field contract. */
+interface AdditionalMemberFieldNames {
+    /** Selection checkbox field. */
+    selected: string;
+    /** Full-name field. */
+    name: string;
+    /** Email field. */
+    email: string;
+}
+/** Presentation options shared by the initial fields and the checkout editor. */
+interface AdditionalMemberOptions {
+    /** Overrides for site-specific language. */
+    copy?: Partial<AdditionalMemberCopy>;
+    /** Application field names; defaults use the additionalMember prefix. */
+    names?: Partial<AdditionalMemberFieldNames>;
+}
+/** Controlled field props for application composition. */
+interface AdditionalMemberFieldsProps extends AdditionalMemberOptions {
+    /** Current draft, including details retained when unchecked. */
+    value: AdditionalMemberDraft;
+    /** Receive the next draft after a field changes. */
+    onChange: (value: AdditionalMemberDraft) => void;
+    /** Authoritative additional-member price, when available. */
+    offer?: AdditionalMemberOffer;
+}
+/** Default wording for additional-member controls. */
+declare const ADDITIONAL_MEMBER_COPY: AdditionalMemberCopy;
+/** Convert an editor draft to the selection accepted by checkout; null removes the recipient. */
+declare function additionalMemberSelection(value: AdditionalMemberDraft): CheckoutNamedSeatSelection | null;
+/** One field set for included and paid recipients, reused on Apply and when editing checkout details. */
+declare function AdditionalMemberFields({ value, onChange, offer, ...options }: AdditionalMemberFieldsProps): preact.JSX.Element;
+
+/** Optional host notification after Chapter saves the selection successfully. */
+interface AdditionalMemberEditorOptions extends AdditionalMemberOptions {
+    /** Sync the application's draft after a successful save or removal. */
+    onSaved?: (value: AdditionalMemberDraft) => void;
+}
+/** Shared editor receives the server-saved recipient and authoritative save/cancel actions. */
+interface AdditionalMemberEditorProps extends CheckoutSeatEditorContext, AdditionalMemberEditorOptions {
+}
+/** Own validation, saving, error recovery and action layout for included and paid recipients. */
+declare function AdditionalMemberEditor({ selection, offer, save, cancel, onSaved, ...options }: AdditionalMemberEditorProps): preact.JSX.Element;
+
 /** The public join config (the shape `GET /api/join-config` returns). */
 interface JoinConfig {
     id: string;
@@ -426,12 +528,15 @@ type JoinFlowState = {
 /** Canonical flow state supplied to a site's per-step heading render slot. */
 interface JoinStepRenderContext {
     state: JoinFlowState;
+    /** True while returning to the application's family-member fields; the saved application stays on its payment step. */
+    editingNamedSeat?: boolean;
     invitation?: JoinInvitation;
     applicationId?: string;
 }
 /** Submission state supplied to a site's submit-control render slot. */
 interface JoinSubmitRenderContext {
     submitting: boolean;
+    /** True while submitting, while a host gate is closed, or while required form/recipient fields are invalid. */
     disabled: boolean;
 }
 /** Props for {@link JoinIsland}. */
@@ -484,6 +589,12 @@ interface JoinIslandProps {
             recipientName: string;
             recipientEmail: string;
         };
+        /** Use Chapter's recipient editor and read-only checkout review; configure only copy and field names. */
+        additionalMember?: AdditionalMemberEditorOptions;
+        /** Reuse the application's recipient fields for edits. Checkout automatically quotes initialNamedSeat and shows a read-only review. */
+        renderNamedSeatEditor?: CheckoutSeatEditor;
+        /** Heading for the read-only recipient review. Defaults to Additional member. */
+        namedSeatLabel?: string;
         appearance?: Record<string, unknown>;
         fonts?: readonly Record<string, unknown>[];
         /** Render the server-owned price lines; `lines.founding` says the difference is a policy-backed founding discount,
@@ -711,4 +822,7 @@ declare function JourneyFrame({ children }: {
     children: ComponentChildren;
 }): preact.JSX.Element;
 
-export { type ApiFn, BrandStyle, type BrandStyleProps, type GiftCodeRedeemResult, GiftCodeRedeemer, type GiftCodeRedeemerCopy, type GiftCodeRedeemerProps, GiftOfferCards, type GiftOfferCardsMode, type GiftOfferCardsProps, GiftPurchases, type GiftPurchasesProps, type JoinBookingSimulation, type JoinConfig, type JoinFlowState, JoinIsland, type JoinIslandProps, type JoinSimulation, type JoinStepRenderContext, type JoinSubmitRenderContext, type JoinTier, type JoinTierRenderContext, JourneyFrame, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberContentArea, type MemberContentAreaProps, MemberGifts, type MemberProvisionalRenderContext, MemberRestart, MembersArea, type MembersAreaProps, type MembershipCardTokenName, MembershipCards, type MembershipCardsMode, type MembershipCardsProps, NAMED_SEAT_RECIPIENT_WORDS, NamedSeatPurchase, NamedSeatRecipientLine, type PaymentPriceLines, PaymentStep, type PaymentStepProps, type PaymentStepSimulation, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, type SubResponse, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection };
+/** A themed application submit control. Pass the disabled state supplied by JoinIsland's renderSubmit slot. */
+declare function JoinSubmitButton(props: JSX.ButtonHTMLAttributes<HTMLButtonElement>): JSX.Element;
+
+export { ADDITIONAL_MEMBER_COPY, type AdditionalMemberCopy, type AdditionalMemberDraft, AdditionalMemberEditor, type AdditionalMemberEditorOptions, type AdditionalMemberEditorProps, type AdditionalMemberFieldNames, AdditionalMemberFields, type AdditionalMemberFieldsProps, type AdditionalMemberOffer, type AdditionalMemberOptions, type ApiFn, BrandStyle, type BrandStyleProps, type CheckoutSeatEditor, type CheckoutSeatEditorContext, type GiftCodeRedeemResult, GiftCodeRedeemer, type GiftCodeRedeemerCopy, type GiftCodeRedeemerProps, GiftOfferCards, type GiftOfferCardsMode, type GiftOfferCardsProps, GiftPurchases, type GiftPurchasesProps, type JoinBookingSimulation, type JoinConfig, type JoinFlowState, JoinIsland, type JoinIslandProps, type JoinSimulation, type JoinStepRenderContext, JoinSubmitButton, type JoinSubmitRenderContext, type JoinTier, type JoinTierRenderContext, JourneyFrame, MEMBERSHIP_CARD_TOKEN_DEFAULTS, MemberContentArea, type MemberContentAreaProps, MemberGifts, type MemberProvisionalRenderContext, MemberRestart, MembersArea, type MembersAreaProps, type MembershipCardTokenName, MembershipCards, type MembershipCardsMode, type MembershipCardsProps, NAMED_SEAT_RECIPIENT_WORDS, NamedSeatPurchase, NamedSeatRecipientLine, type PaymentPriceLines, PaymentStep, type PaymentStepProps, type PaymentStepSimulation, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, type SubResponse, TierPlaceholder, additionalMemberSelection, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, membershipApplicationHref, tierNeedsPayment, timeLabel, tzShort, useTierSelection };

package/dist/ui/member/index.js

@@ -1,8 +1,12 @@
 import {
+  ADDITIONAL_MEMBER_COPY,
+  AdditionalMemberEditor,
+  AdditionalMemberFields,
   GiftCodeRedeemer,
   GiftOfferCards,
   GiftPurchases,
   JoinIsland,
+  JoinSubmitButton,
   JourneyFrame,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
   MemberContentArea,
@@ -17,6 +21,7 @@ import {
   Rescheduler,
   SlotPicker,
   TierPlaceholder,
+  additionalMemberSelection,
   dayKey,
   dayLabel,
   fmtDate,
@@ -29,7 +34,7 @@ import {
   timeLabel,
   tzShort,
   useTierSelection
-} from "../../chunk-IQZWCG42.js";
+} from "../../chunk-E7CB5K2D.js";
 import {
   BrandStyle,
   ChapterCopyProvider,
@@ -37,12 +42,16 @@ import {
 } from "../../chunk-4M2PN5K3.js";
 import "../../chunk-IVXVECKR.js";
 export {
+  ADDITIONAL_MEMBER_COPY,
+  AdditionalMemberEditor,
+  AdditionalMemberFields,
   BrandStyle,
   ChapterCopyProvider,
   GiftCodeRedeemer,
   GiftOfferCards,
   GiftPurchases,
   JoinIsland,
+  JoinSubmitButton,
   JourneyFrame,
   MEMBERSHIP_CARD_TOKEN_DEFAULTS,
   MemberContentArea,
@@ -57,6 +66,7 @@ export {
   Rescheduler,
   SlotPicker,
   TierPlaceholder,
+  additionalMemberSelection,
   dayKey,
   dayLabel,
   fmtDate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@odla-ai/chapter",
-  "version": "0.56.0",
+  "version": "0.56.2",
   "description": "A leader/follower foundation for branded membership sites: shared CRM, admin, auth, payments, booking, and explicit record delivery from one defineChapter config.",
   "license": "MIT",
   "homepage": "https://odla.ai/docs/packages/chapter",