@odla-ai/chapter 0.30.0 → 0.31.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 } from '@odla-ai/crm';
-import { a as Chapter, b as ChapterCopy } from '../../copy-context-efEMF_aD.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-efEMF_aD.js';
+import { a as Chapter, b as ChapterCopy } from '../../copy-context-HAhNTZdl.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-HAhNTZdl.js';
 import { CrmLifecycleAdapter, CrmWorkspaceMasterContext, CrmWorkspaceRecordContext, RecordPanelTab } from '@odla-ai/crm/ui';
 
 /** Normalized public auth configuration consumed by the Clerk gate. */

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

@@ -0,0 +1,29 @@
+import { JSX } from 'preact';
+import { FieldState, FieldConditions } from '@odla-ai/crm';
+
+/** What {@link useFieldConditions} hands back. */
+interface FieldConditionsHandle {
+    /** Live form answers, refreshed on every input. */
+    values: Record<string, unknown>;
+    /** Per-field verdict. A field with no declared condition is visible. */
+    states: Record<string, FieldState>;
+    /** Whether to render a field. Unconditional fields are always visible. */
+    isVisible: (field: string) => boolean;
+    /** Whether a field must be answered given the current values. */
+    isRequired: (field: string) => boolean;
+    /** Attach to the form (or any ancestor of the inputs) to track answers. */
+    onInput: (event: JSX.TargetedEvent<HTMLElement>) => void;
+}
+/**
+ * Track a join form's answers and resolve which fields apply.
+ *
+ * Values are read straight off the DOM `FormData` rather than mirrored into
+ * component state, so a site keeps uncontrolled inputs and this stays a
+ * read-only observer of a form it does not own.
+ *
+ * @param conditions Per-field conditions, as `GET /api/join-config` returns them.
+ * @param staticRequired Fields required unconditionally, for the fallback.
+ */
+declare function useFieldConditions(conditions?: Readonly<Record<string, FieldConditions>>, staticRequired?: readonly string[]): FieldConditionsHandle;
+
+export { type FieldConditionsHandle, useFieldConditions };

package/dist/ui/conditions/index.js

@@ -0,0 +1,32 @@
+import {
+  collectFormFields
+} from "../../chunk-IVXVECKR.js";
+
+// src/ui/field-conditions.tsx
+import { useMemo, useState } from "preact/hooks";
+import { resolveFieldStates } from "@odla-ai/crm";
+function useFieldConditions(conditions = {}, staticRequired = []) {
+  const [values, setValues] = useState({});
+  const states = useMemo(
+    () => resolveFieldStates(conditions, values, staticRequired),
+    [conditions, values, staticRequired]
+  );
+  return {
+    values,
+    states,
+    // Absent from `states` means undeclared and unconditional: visible, and
+    // required only if the caller said so. Never hide a field we know nothing
+    // about — the same fail-open rule the evaluator uses.
+    isVisible: (field) => states[field]?.visible ?? true,
+    isRequired: (field) => states[field]?.required ?? staticRequired.includes(field),
+    onInput: (event) => {
+      const target = event.currentTarget;
+      const form = target instanceof HTMLFormElement ? target : target.closest?.("form") ?? null;
+      if (form) setValues(collectFormFields(new FormData(form)));
+    }
+  };
+}
+export {
+  useFieldConditions
+};
+//# sourceMappingURL=index.js.map

package/dist/ui/conditions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/ui/field-conditions.tsx"],"sourcesContent":["// The conditional-field seam for a join form. The site owns every input; this\n// only answers \"should that one be shown, and must it be answered right now?\"\n//\n// The verdict comes from @odla-ai/crm's resolver — the same function\n// submitApplication calls server-side — so a form and its validator cannot\n// disagree about a field. That is the whole reason the rule is data rather than\n// a render-time `&&`.\nimport { useMemo, useState } from \"preact/hooks\";\nimport type { JSX } from \"preact\";\nimport { resolveFieldStates, type FieldConditions, type FieldState } from \"@odla-ai/crm\";\nimport { collectFormFields } from \"./form-fields.js\";\n\n/** What {@link useFieldConditions} hands back. */\nexport interface FieldConditionsHandle {\n  /** Live form answers, refreshed on every input. */\n  values: Record<string, unknown>;\n  /** Per-field verdict. A field with no declared condition is visible. */\n  states: Record<string, FieldState>;\n  /** Whether to render a field. Unconditional fields are always visible. */\n  isVisible: (field: string) => boolean;\n  /** Whether a field must be answered given the current values. */\n  isRequired: (field: string) => boolean;\n  /** Attach to the form (or any ancestor of the inputs) to track answers. */\n  onInput: (event: JSX.TargetedEvent<HTMLElement>) => void;\n}\n\n/**\n * Track a join form's answers and resolve which fields apply.\n *\n * Values are read straight off the DOM `FormData` rather than mirrored into\n * component state, so a site keeps uncontrolled inputs and this stays a\n * read-only observer of a form it does not own.\n *\n * @param conditions Per-field conditions, as `GET /api/join-config` returns them.\n * @param staticRequired Fields required unconditionally, for the fallback.\n */\nexport function useFieldConditions(\n  conditions: Readonly<Record<string, FieldConditions>> = {},\n  staticRequired: readonly string[] = [],\n): FieldConditionsHandle {\n  const [values, setValues] = useState<Record<string, unknown>>({});\n  const states = useMemo(\n    () => resolveFieldStates(conditions, values, staticRequired),\n    [conditions, values, staticRequired],\n  );\n  return {\n    values,\n    states,\n    // Absent from `states` means undeclared and unconditional: visible, and\n    // required only if the caller said so. Never hide a field we know nothing\n    // about — the same fail-open rule the evaluator uses.\n    isVisible: (field) => states[field]?.visible ?? true,\n    isRequired: (field) => states[field]?.required ?? staticRequired.includes(field),\n    onInput: (event) => {\n      const target = event.currentTarget;\n      const form = target instanceof HTMLFormElement\n        ? target\n        : target.closest?.(\"form\") ?? null;\n      if (form) setValues(collectFormFields(new FormData(form)));\n    },\n  };\n}\n"],"mappings":";;;;;AAOA,SAAS,SAAS,gBAAgB;AAElC,SAAS,0BAAiE;AA2BnE,SAAS,mBACd,aAAwD,CAAC,GACzD,iBAAoC,CAAC,GACd;AACvB,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAkC,CAAC,CAAC;AAChE,QAAM,SAAS;AAAA,IACb,MAAM,mBAAmB,YAAY,QAAQ,cAAc;AAAA,IAC3D,CAAC,YAAY,QAAQ,cAAc;AAAA,EACrC;AACA,SAAO;AAAA,IACL;AAAA,IACA;AAAA;AAAA;AAAA;AAAA,IAIA,WAAW,CAAC,UAAU,OAAO,KAAK,GAAG,WAAW;AAAA,IAChD,YAAY,CAAC,UAAU,OAAO,KAAK,GAAG,YAAY,eAAe,SAAS,KAAK;AAAA,IAC/E,SAAS,CAAC,UAAU;AAClB,YAAM,SAAS,MAAM;AACrB,YAAM,OAAO,kBAAkB,kBAC3B,SACA,OAAO,UAAU,MAAM,KAAK;AAChC,UAAI,KAAM,WAAU,kBAAkB,IAAI,SAAS,IAAI,CAAC,CAAC;AAAA,IAC3D;AAAA,EACF;AACF;","names":[]}

package/dist/ui/index.d.ts

@@ -1,6 +1,6 @@
 export { AdminAccountMenuProps, AdminChrome, AdminNote, AdminPage, AdminResource, AdminRouteState, AdminRouteTarget, AdminRouting, AdminSection, AdminSectionContext, AdminWorkspace, AdminWorkspaceNavProps, AvailabilitySectionOptions, BillingSectionOptions, ChapterAdmin, ChapterAdminAuthAdapter, ChapterAdminAuthConfig, ChapterAdminAuthLoadContext, ChapterAdminProps, ChapterAdminUser, CollectionSectionOptions, DashboardSectionOptions, EmailSectionOptions, LeaderNetworkOverview, MeetingsSectionOptions, NetworkRecordsWorkspace, NetworkShareActions, NetworkShareActionsProps, Panel, PeopleSectionOptions, RecordActions, RecordActionsProps, ThemeWarning, adminFetch, adminRouteFromUrl, adminRouteHref, adminSectionFromUrl, adminSectionHref, applicationLifecycleAdapter, availabilitySection, billingSection, collectionSection, dashboardSection, defaultAdminSections, defaultAdminWorkspaces, emailSection, loadChapterAdminConfig, loadChapterAdminUser, meetingsSection, networkRecordsWorkspace, peopleSection, useAdminResource } from './admin/index.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../copy-context-efEMF_aD.js';
-export { ApiFn, BrandStyle, BrandStyleProps, JoinConfig, JoinFlowState, JoinIsland, JoinIslandProps, JoinStepRenderContext, JoinSubmitRenderContext, MemberProvisionalRenderContext, MembersArea, MembersAreaProps, PaymentPriceLines, PaymentStep, PaymentStepProps, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, timeLabel, tzShort } from './member/index.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../copy-context-HAhNTZdl.js';
+export { ApiFn, BrandStyle, BrandStyleProps, JoinConfig, JoinFlowState, JoinIsland, JoinIslandProps, JoinStepRenderContext, JoinSubmitRenderContext, JoinTier, JoinTierRenderContext, MemberProvisionalRenderContext, MembersArea, MembersAreaProps, PaymentPriceLines, PaymentStep, PaymentStepProps, RescheduleProps, Rescheduler, Slot, SlotPicker, SlotPickerClasses, SlotPickerProps, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, tierNeedsPayment, timeLabel, tzShort, useTierSelection } from './member/index.js';
 import 'preact';
 import '@odla-ai/crm';
 import '@odla-ai/crm/ui';

package/dist/ui/index.js

@@ -4,6 +4,7 @@ import {
   PaymentStep,
   Rescheduler,
   SlotPicker,
+  TierPlaceholder,
   dayKey,
   dayLabel,
   fmtDate,
@@ -11,9 +12,11 @@ import {
   fullLabel,
   groupSlotsByDay,
   loadJoinResume,
+  tierNeedsPayment,
   timeLabel,
-  tzShort
-} from "../chunk-IOHVFBXH.js";
+  tzShort,
+  useTierSelection
+} from "../chunk-QWMP6TSM.js";
 import {
   AdminNote,
   AdminPage,
@@ -49,6 +52,7 @@ import {
   ChapterCopyProvider,
   useChapterCopy
 } from "../chunk-JAWTIROV.js";
+import "../chunk-IVXVECKR.js";
 export {
   AdminNote,
   AdminPage,
@@ -66,6 +70,7 @@ export {
   Rescheduler,
   SlotPicker,
   ThemeWarning,
+  TierPlaceholder,
   adminFetch,
   adminRouteFromUrl,
   adminRouteHref,
@@ -91,9 +96,11 @@ export {
   meetingsSection,
   networkRecordsWorkspace,
   peopleSection,
+  tierNeedsPayment,
   timeLabel,
   tzShort,
   useAdminResource,
-  useChapterCopy
+  useChapterCopy,
+  useTierSelection
 };
 //# sourceMappingURL=index.js.map

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

@@ -1,7 +1,7 @@
 import * as preact from 'preact';
 import { ComponentChildren, JSX } from 'preact';
-import { b as ChapterCopy, c as ChapterBrand } from '../../copy-context-efEMF_aD.js';
-export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-efEMF_aD.js';
+import { b as ChapterCopy, c as ChapterBrand } from '../../copy-context-HAhNTZdl.js';
+export { C as ChapterCopyProvider, u as useChapterCopy } from '../../copy-context-HAhNTZdl.js';
 import '@odla-ai/crm';
 
 /** A bookable slot: a start instant in epoch milliseconds. */
@@ -127,12 +127,65 @@ interface RescheduleProps {
  *  rebooks on pick. Degrades to a message when scheduling is unavailable. */
 declare function Rescheduler(props: RescheduleProps): preact.JSX.Element;
 
+/** One membership tier as the public join config exposes it. */
+interface JoinTier {
+    id: string;
+    name: string;
+    priceCents: number;
+    blurb: string;
+    /** True when the tier costs nothing, so the flow skips the payment step. */
+    free: boolean;
+}
+/**
+ * What a site needs to render its own tier chooser.
+ *
+ * Pass `renderTiers` to take over presentation entirely — the built-in output
+ * is an unstyled placeholder, not a design.
+ */
+interface JoinTierRenderContext {
+    /** Offered tiers, in display order. */
+    tiers: readonly JoinTier[];
+    /** The chosen tier, or null while nothing is chosen. */
+    selected: JoinTier | null;
+    selectedTierId: string | null;
+    /** Choose a tier. Unknown ids are ignored. */
+    selectTier: (tierId: string) => void;
+}
+/**
+ * Track the selected tier.
+ *
+ * A single offered tier is selected implicitly: the choice is unambiguous, so
+ * a chooser would be furniture. Nothing is preselected when several are on
+ * offer, because defaulting silently picks a price on the applicant's behalf.
+ */
+declare function useTierSelection(tiers: readonly JoinTier[], initialTierId?: string): JoinTierRenderContext;
+/**
+ * The unstyled fallback chooser.
+ *
+ * Deliberately plain and self-labelling: the flow stays usable before a site
+ * has designed anything, and it is obvious on sight that this was never meant
+ * to ship. Sites replace it wholesale via `renderTiers`; the `data-*` hook is
+ * there so a build can assert no placeholder survives into production.
+ */
+declare function TierPlaceholder(context: JoinTierRenderContext): ComponentChildren;
+/**
+ * Whether the flow should charge for this submission.
+ *
+ * A free tier skips payment even on a chapter otherwise wired for it. With no
+ * tier in play the chapter-wide readiness decides, which is how every chapter
+ * behaved before tiers existed.
+ */
+declare function tierNeedsPayment(selected: JoinTier | null, paymentsReady: boolean): boolean;
+
 /** The public join config (the shape `GET /api/join-config` returns). */
 interface JoinConfig {
     id: string;
     name: string;
     paymentsReady: boolean;
     refundPolicyText?: string;
+    /** Offered membership tiers, in display order. Empty on a chapter that
+     *  declares none, in which case no tier is posted and nothing renders. */
+    tiers?: readonly JoinTier[];
     /** Resolved copy for the packaged join flow. */
     copy?: ChapterCopy["join"];
 }
@@ -192,6 +245,12 @@ interface JoinIslandProps {
     }) => ComponentChildren;
     /** Replace the submit control without replacing the application form. */
     renderSubmit?: (context: JoinSubmitRenderContext) => ComponentChildren;
+    /** Render the site's own tier chooser. Omitted, the flow still works and
+     *  emits an unstyled placeholder meant to be replaced, never shipped. */
+    renderTiers?: (context: JoinTierRenderContext) => ComponentChildren;
+    /** Preselect a tier, e.g. from a pricing page link. Ignored if not offered.
+     *  With exactly one offered tier the selection is implicit and needs no UI. */
+    initialTierId?: string;
     /** Additional host validation gate for the submit action. */
     submitDisabled?: boolean;
     /** Stripe Elements presentation and site-owned payment content. */
@@ -250,4 +309,4 @@ interface BrandStyleProps {
  *  there is no brand to theme). */
 declare function BrandStyle(props: BrandStyleProps): preact.JSX.Element | null;
 
-export { type ApiFn, BrandStyle, type BrandStyleProps, type JoinConfig, type JoinFlowState, JoinIsland, type JoinIslandProps, type JoinStepRenderContext, type JoinSubmitRenderContext, type MemberProvisionalRenderContext, MembersArea, type MembersAreaProps, type PaymentPriceLines, PaymentStep, type PaymentStepProps, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, timeLabel, tzShort };
+export { type ApiFn, BrandStyle, type BrandStyleProps, type JoinConfig, type JoinFlowState, JoinIsland, type JoinIslandProps, type JoinStepRenderContext, type JoinSubmitRenderContext, type JoinTier, type JoinTierRenderContext, type MemberProvisionalRenderContext, MembersArea, type MembersAreaProps, type PaymentPriceLines, PaymentStep, type PaymentStepProps, type RescheduleProps, Rescheduler, type Slot, SlotPicker, type SlotPickerClasses, type SlotPickerProps, TierPlaceholder, dayKey, dayLabel, fmtDate, fmtMoney, fullLabel, groupSlotsByDay, loadJoinResume, tierNeedsPayment, timeLabel, tzShort, useTierSelection };

package/dist/ui/member/index.js

@@ -4,6 +4,7 @@ import {
   PaymentStep,
   Rescheduler,
   SlotPicker,
+  TierPlaceholder,
   dayKey,
   dayLabel,
   fmtDate,
@@ -11,14 +12,17 @@ import {
   fullLabel,
   groupSlotsByDay,
   loadJoinResume,
+  tierNeedsPayment,
   timeLabel,
-  tzShort
-} from "../../chunk-IOHVFBXH.js";
+  tzShort,
+  useTierSelection
+} from "../../chunk-QWMP6TSM.js";
 import {
   BrandStyle,
   ChapterCopyProvider,
   useChapterCopy
 } from "../../chunk-JAWTIROV.js";
+import "../../chunk-IVXVECKR.js";
 export {
   BrandStyle,
   ChapterCopyProvider,
@@ -27,6 +31,7 @@ export {
   PaymentStep,
   Rescheduler,
   SlotPicker,
+  TierPlaceholder,
   dayKey,
   dayLabel,
   fmtDate,
@@ -34,8 +39,10 @@ export {
   fullLabel,
   groupSlotsByDay,
   loadJoinResume,
+  tierNeedsPayment,
   timeLabel,
   tzShort,
-  useChapterCopy
+  useChapterCopy,
+  useTierSelection
 };
 //# sourceMappingURL=index.js.map