@odla-ai/chapter 0.56.1 → 0.57.0

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

@@ -1,8 +1,8 @@
 import * as preact from 'preact';
 import { ComponentChildren, JSX } from 'preact';
 import { CrmClient, Crm, CrmRecord, FieldType } from '@odla-ai/crm';
-import { a as Chapter, b as ChapterCopy, M as MemberContentDocument, E as EffectiveMemberContent, c as MemberContentTierAuthority } from '../../copy-context-CaUXIxUI.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-CaUXIxUI.js';
+import { a as Chapter, b as ChapterCopy, M as MemberContentDocument, E as EffectiveMemberContent, c as MemberContentTierAuthority } from '../../copy-context-DE4YMAbz.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-DE4YMAbz.js';
 import { CrmLifecycleAdapter, CrmWorkspaceMasterContext, CrmWorkspaceRecordContext, RecordPanelTab } from '@odla-ai/crm/ui';
 
 /** Normalized public auth configuration consumed by the Clerk gate. */
@@ -290,7 +290,8 @@ interface NamedSeatRecordPanelProps {
     superAdmin: boolean;
     onChanged?: () => void;
 }
-/** The purchaser's additional seat beside their billing: who it is for, where it stands, and the one manual refund. */
+/** The purchaser's additional seat beside their billing: who it is for, where it stands, the one manual refund, and, while the
+ * seat is not yet active, naming a different recipient on the purchaser's behalf. */
 declare function NamedSeatRecordPanel(props: NamedSeatRecordPanelProps): preact.JSX.Element | null;
 
 /** The membership workflow's own statuses. A person reaches them only through an application, never by hand. */

package/dist/ui/admin/index.js

@@ -42,11 +42,11 @@ import {
   networkRecordsWorkspace,
   peopleSection,
   useAdminResource
-} from "../../chunk-ZAE24YKY.js";
+} from "../../chunk-L2IPS2FQ.js";
 import {
   ChapterCopyProvider,
   useChapterCopy
-} from "../../chunk-4M2PN5K3.js";
+} from "../../chunk-FHKZVF5G.js";
 export {
   APPLICATION_STAGES,
   AdminNote,

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, CheckoutSeatEditor, CheckoutSeatEditorContext, 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 { C as ChapterCopyProvider, u as useChapterCopy } from '../copy-context-DE4YMAbz.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-NK267YQZ.js";
+} from "../chunk-CKC6X5H2.js";
 import {
   APPLICATION_STAGES,
   AdminNote,
@@ -74,15 +79,18 @@ import {
   networkRecordsWorkspace,
   peopleSection,
   useAdminResource
-} from "../chunk-ZAE24YKY.js";
+} from "../chunk-L2IPS2FQ.js";
 import {
   BrandStyle,
   ChapterCopyProvider,
   useChapterCopy
-} from "../chunk-4M2PN5K3.js";
+} from "../chunk-FHKZVF5G.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

@@ -1,7 +1,7 @@
 import * as preact from 'preact';
 import { ComponentChildren, JSX } from 'preact';
-import { d as MemberContentProjection, e as MemberContentPageProjection, b as ChapterCopy, f as ChapterBrand } from '../../copy-context-CaUXIxUI.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-CaUXIxUI.js';
+import { d as MemberContentProjection, e as MemberContentPageProjection, b as ChapterCopy, f as ChapterBrand } from '../../copy-context-DE4YMAbz.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-DE4YMAbz.js';
 import { FieldType, FieldConditions } from '@odla-ai/crm';
 
 /** A bookable slot: a start instant in epoch milliseconds. */
@@ -400,6 +400,82 @@ interface CheckoutSeatEditorContext {
 /** 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;
@@ -460,6 +536,7 @@ interface JoinStepRenderContext {
 /** 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}. */
@@ -512,6 +589,8 @@ 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. */
@@ -724,11 +803,18 @@ interface NamedSeatOfferSeat {
     acceptedAt?: number;
     /** When the recipient's own application was approved; the seat is active from then, once the primary is. */
     joinedAt?: number;
+    /** True while the invitation waits for the buying member's own approval; nothing has been sent to the recipient yet. */
+    invitationHeld?: true;
+    /** True while the purchaser may still name someone else: the seat is invited or accepted but not yet active. */
+    regiftable?: true;
+    /** When the purchaser last replaced the recipient. */
+    regiftedAt?: number;
 }
 
 /** What the purchaser reads about the person they named, keyed by the offer's `recipientState`. */
 declare const NAMED_SEAT_RECIPIENT_WORDS: Record<NamedSeatOfferSeat["recipientState"], string>;
-/** One line on the named recipient: who they are and whether they accepted or joined. */
+/** One line on the named recipient: who they are and whether they accepted or joined. An invitation the network holds until
+ * the purchaser's own approval says so, instead of claiming it was sent. */
 declare function NamedSeatRecipientLine({ seat }: {
     seat: NamedSeatOfferSeat;
 }): preact.JSX.Element;
@@ -743,4 +829,7 @@ declare function JourneyFrame({ children }: {
     children: ComponentChildren;
 }): preact.JSX.Element;
 
-export { 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, 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,20 +34,24 @@ import {
   timeLabel,
   tzShort,
   useTierSelection
-} from "../../chunk-NK267YQZ.js";
+} from "../../chunk-CKC6X5H2.js";
 import {
   BrandStyle,
   ChapterCopyProvider,
   useChapterCopy
-} from "../../chunk-4M2PN5K3.js";
+} from "../../chunk-FHKZVF5G.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,