@voyant-travel/bookings-react 0.119.3

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for describing the origin of the Work and
+      reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may accept and charge a
+      fee for, the acceptance of support, warranty, indemnity, or
+      other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 PixelMakers Studio SRL
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,87 @@
+# @voyant-travel/bookings-react
+
+The bookings client tier: headless data hooks/clients plus the styled UI
+components and page-level compositions (formerly `@voyant-travel/bookings-ui`).
+
+Headless consumers (storefronts, portals) import from the root, `./hooks`,
+`./client`, or `./query-keys` — these pull no styling peers. Styled surfaces
+live under `./ui`, `./components/*`, `./journey`, `./admin`, `./i18n`, and
+`./styles.css`, whose heavier peers (`@voyant-travel/ui`, `@voyant-travel/admin`,
+`@tanstack/react-table`, `lucide-react`, the other modules' `*-react`/`*-ui`
+packages) are optional and only needed when you import those subpaths.
+
+`@voyant-travel/bookings-react` provides React Query hooks and provider utilities for Voyant bookings.
+
+It now includes public storefront flow helpers alongside the admin hooks:
+
+- `usePublicBookingSession`
+- `usePublicBookingSessionState`
+- `usePublicBookingSessionFlowMutation`
+- `getPublicBookingSessionQueryOptions`
+- `getPublicBookingSessionStateQueryOptions`
+
+Those helpers target the public booking session contract for wizard-state
+storage and room-selection repricing.
+
+## UI components
+
+Importable React UI components for Voyant bookings. Bundler-consumed (Vite, Next.js, webpack, etc.).
+
+### Install
+
+```bash
+pnpm add @voyant-travel/bookings-react @voyant-travel/ui @tanstack/react-query react react-dom
+```
+
+`@voyant-travel/ui` provides the design-system primitives; the data-layer hooks ship
+from this package's root and `./hooks` subpaths.
+
+All components accept a `className` prop and merge it with `cn()`. Wrap or compose to extend; use the registry copy-paste path (`npx shadcn add @voyant/...`) for components you want to fork outright.
+
+Page components render with `p-6` outer padding by default and are intended to
+mount directly into an app route outlet. Pass `className` to extend or override
+that spacing when a shell owns the page chrome.
+
+### Components
+
+- `BookingsPage`, `BookingDetailPage`
+- `BookingList`, `BookingDialog`, `BookingCreateSheet`, `BookingCancellationDialog`, `StatusChangeDialog`
+- `TravelerList`, `TravelerDialog`, `BookingItemList`, `BookingGroupSection`
+- `BookingPaymentsSummary`, `BookingPaymentScheduleList`, `BookingGuaranteeList`
+- `SupplierStatusList`, `BookingActivityTimeline`, `BookingNotes`
+
+`BookingDetailPage` is the canonical multi-tab booking surface (Overview,
+Travelers, Payments, Suppliers, Documents, Activity, plus optional `Invoices`
+and `Ledger` tabs). Starters inject starter-owned cards via the `slots`
+prop and wire router navigation through `onBack`, `onPersonOpen`,
+`onOrganizationOpen`, `onCollectPayment`, and `onRecordPayment` callbacks:
+
+```tsx
+<BookingDetailPage
+  id={bookingId}
+  hideBreadcrumb
+  onBack={() => router.push("/bookings")}
+  onPersonOpen={(personId) => router.push(`/people/${personId}`)}
+  onCollectPayment={() => setCollectOpen(true)}
+  onRecordPayment={() => setRecordOpen(true)}
+  slots={{
+    header: (booking) => <WidgetSlot slot="booking.header" props={{ booking }} />,
+    overviewStart: () => <CatalogSourceCard bookingId={bookingId} />,
+    financeStart: () => <PendingPaymentSessions bookingId={bookingId} />,
+    invoicesTab: { content: (booking) => <InvoicesCard booking={booking} /> },
+    ledgerTab: { content: <ActionLedgerPanel bookingId={bookingId} /> },
+    documents: () => <DocumentsTable bookingId={bookingId} />,
+  }}
+/>
+```
+
+### I18n
+
+Components render English by default. To localize them, wrap your UI in
+`BookingsUiMessagesProvider` and import only the locales your app supports.
+
+```tsx
+import { BookingsUiMessagesProvider } from "@voyant-travel/bookings-react/ui"
+import { bookingsUiEn } from "@voyant-travel/bookings-react/i18n/en"
+import { bookingsUiRo } from "@voyant-travel/bookings-react/i18n/ro"
+```

package/dist/admin/booking-contract-dialog.d.ts

@@ -0,0 +1,22 @@
+export interface BookingContractDialogProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    bookingId: string;
+    bookingNumber?: string | null;
+    onSuccess?: () => void;
+}
+/**
+ * "Add contract" dialog for a booking. Two modes:
+ *
+ *   - **Generate** (default): hits the server-side preview branch of
+ *     `/v1/admin/bookings/:id/generate-contract` (which runs the same
+ *     template + variable build the customer would see at checkout)
+ *     and renders the HTML in a sandboxed iframe. Confirm fires the
+ *     full generate, which creates the contract row + persists the PDF.
+ *
+ *   - **Upload**: operator picks a pre-signed PDF (e.g. countersigned
+ *     copy). The dialog creates a `signed`-status contract row and
+ *     attaches the uploaded file via the legal attachment upload route.
+ */
+export declare function BookingContractDialog({ open, onOpenChange, bookingId, bookingNumber, onSuccess, }: BookingContractDialogProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=booking-contract-dialog.d.ts.map

package/dist/admin/booking-contract-dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-contract-dialog.d.ts","sourceRoot":"","sources":["../../src/admin/booking-contract-dialog.tsx"],"names":[],"mappings":"AA0BA,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,OAAO,CAAA;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,aAAa,EACb,SAAS,GACV,EAAE,0BAA0B,2CA8N5B"}

package/dist/admin/booking-contract-dialog.js

@@ -0,0 +1,161 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useQueryClient } from "@tanstack/react-query";
+import { useOperatorAdminMessages } from "@voyant-travel/admin";
+import { legalQueryKeys, useLegalContractAttachmentMutation, useLegalContractMutation, } from "@voyant-travel/legal-react";
+import { Button, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, Input, Label, Skeleton, } from "@voyant-travel/ui/components";
+import { FileText, Loader2, Paperclip, X } from "lucide-react";
+import { useEffect, useState } from "react";
+import { useBookingContractGenerationMutation } from "../index.js";
+/**
+ * "Add contract" dialog for a booking. Two modes:
+ *
+ *   - **Generate** (default): hits the server-side preview branch of
+ *     `/v1/admin/bookings/:id/generate-contract` (which runs the same
+ *     template + variable build the customer would see at checkout)
+ *     and renders the HTML in a sandboxed iframe. Confirm fires the
+ *     full generate, which creates the contract row + persists the PDF.
+ *
+ *   - **Upload**: operator picks a pre-signed PDF (e.g. countersigned
+ *     copy). The dialog creates a `signed`-status contract row and
+ *     attaches the uploaded file via the legal attachment upload route.
+ */
+export function BookingContractDialog({ open, onOpenChange, bookingId, bookingNumber, onSuccess, }) {
+    const t = useOperatorAdminMessages().bookings.detail.contractDialog;
+    const queryClient = useQueryClient();
+    const { create: createContract } = useLegalContractMutation();
+    const { upload: uploadAttachment } = useLegalContractAttachmentMutation();
+    const { preview, generate } = useBookingContractGenerationMutation(bookingId);
+    const [mode, setMode] = useState("generate");
+    const [uploading, setUploading] = useState(false);
+    const [error, setError] = useState(null);
+    // Upload form state
+    const [title, setTitle] = useState("");
+    const [file, setFile] = useState(null);
+    // Reset on open. Generate is the leading mode so the preview fetch
+    // kicks off immediately.
+    const resetPreview = preview.reset;
+    useEffect(() => {
+        if (!open)
+            return;
+        setMode("generate");
+        setTitle("");
+        setFile(null);
+        setError(null);
+        setUploading(false);
+        resetPreview();
+    }, [open, resetPreview]);
+    // Fetch preview HTML every time the dialog opens (or the mode flips
+    // back to Generate). The preview reflects current booking + template
+    // state so re-fetching is intentional.
+    const fetchPreview = preview.mutate;
+    useEffect(() => {
+        if (!open || mode !== "generate")
+            return;
+        fetchPreview();
+    }, [open, mode, fetchPreview]);
+    const handleGenerate = async () => {
+        setError(null);
+        try {
+            await generate.mutateAsync({});
+            await queryClient.invalidateQueries({ queryKey: legalQueryKeys.contracts() });
+            onSuccess?.();
+            onOpenChange(false);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+    };
+    const handleUpload = async () => {
+        if (!file) {
+            setError(t.uploadFileRequired);
+            return;
+        }
+        setUploading(true);
+        setError(null);
+        try {
+            const fallbackTitle = title.trim() ||
+                (bookingNumber
+                    ? `Contract ${bookingNumber}`
+                    : `Contract for booking ${bookingId.slice(-8)}`);
+            const created = await createContract.mutateAsync({
+                scope: "customer",
+                status: "signed",
+                title: fallbackTitle,
+                bookingId,
+                metadata: { uploadedByOperator: true },
+            });
+            await uploadAttachment.mutateAsync({
+                contractId: created.id,
+                input: { file, kind: "document", name: file.name },
+            });
+            onSuccess?.();
+            onOpenChange(false);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            setUploading(false);
+        }
+    };
+    const submitting = generate.isPending || uploading;
+    const previewReady = preview.data != null;
+    const canSubmit = mode === "generate" ? previewReady && !submitting : file != null && !submitting;
+    return (_jsx(Dialog, { open: open, onOpenChange: onOpenChange, children: _jsxs(DialogContent, { className: "w-full! max-w-4xl! gap-0 p-0", children: [_jsxs(DialogHeader, { className: "shrink-0 border-b px-6 py-4", children: [_jsx(DialogTitle, { children: t.title }), _jsx(DialogDescription, { children: t.description })] }), _jsx("div", { className: "max-h-[70vh] overflow-y-auto", children: _jsxs("div", { className: "flex flex-col gap-4 px-6 py-5", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: t.modeLabel }), _jsx(SegmentedChoice, { value: mode, onChange: setMode, options: [
+                                            { value: "generate", label: t.modeGenerate },
+                                            { value: "upload", label: t.modeUpload },
+                                        ] })] }), mode === "generate" ? (_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: t.previewLabel }), _jsx("div", { className: "overflow-hidden rounded-md border bg-muted/30", children: preview.isPending ? (_jsxs("div", { className: "flex flex-col gap-3 p-6", children: [_jsx(Skeleton, { className: "h-6 w-1/2" }), _jsx(Skeleton, { className: "h-4 w-full" }), _jsx(Skeleton, { className: "h-4 w-5/6" }), _jsx(Skeleton, { className: "h-4 w-4/5" }), _jsx(Skeleton, { className: "h-4 w-full" })] })) : preview.isError ? (_jsxs("p", { className: "p-6 text-destructive text-sm", children: [t.previewErrorPrefix, " ", preview.error instanceof Error ? preview.error.message : t.previewFailed] })) : preview.data ? (_jsx("iframe", { title: preview.data.templateName || t.previewIframeFallback, srcDoc: wrapPreviewHtml(preview.data.html), sandbox: "", className: "h-[60vh] w-full border-0 bg-white" })) : null }), preview.data?.templateName ? (_jsxs("p", { className: "text-muted-foreground text-xs", children: [t.previewTemplateLabel, " ", preview.data.templateName] })) : null] })) : (_jsxs("div", { className: "flex flex-col gap-4", children: [_jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: t.uploadTitleLabel }), _jsx(Input, { value: title, onChange: (e) => setTitle(e.target.value), placeholder: bookingNumber ? `Contract ${bookingNumber}` : t.uploadTitlePlaceholder }), _jsx("p", { className: "text-muted-foreground text-xs", children: t.uploadTitleHint })] }), _jsxs("div", { className: "flex flex-col gap-2", children: [_jsx(Label, { children: t.uploadFileLabel }), _jsx("input", { type: "file", accept: "application/pdf", onChange: (e) => {
+                                                    const next = e.target.files?.[0] ?? null;
+                                                    setFile(next);
+                                                }, className: "block w-full text-sm file:mr-3 file:rounded-md file:border file:bg-muted file:px-3 file:py-1.5 file:text-sm file:font-medium hover:file:bg-muted/70" }), file ? (_jsxs("div", { className: "flex items-center justify-between gap-2 rounded-md border bg-background px-3 py-1.5 text-sm", children: [_jsxs("span", { className: "flex min-w-0 items-center gap-2", children: [_jsx(Paperclip, { className: "h-3.5 w-3.5 shrink-0 text-muted-foreground" }), _jsx("span", { className: "truncate", children: file.name })] }), _jsx(Button, { type: "button", variant: "ghost", size: "icon-sm", onClick: () => setFile(null), children: _jsx(X, { className: "h-3.5 w-3.5" }) })] })) : null] })] })), error ? _jsx("p", { className: "text-sm text-destructive", children: error }) : null] }) }), _jsxs("div", { className: "flex shrink-0 items-center justify-end gap-2 border-t px-6 py-4", children: [_jsx(Button, { type: "button", variant: "outline", onClick: () => onOpenChange(false), disabled: submitting, children: t.cancel }), _jsxs(Button, { type: "button", disabled: !canSubmit, onClick: () => {
+                                if (mode === "generate") {
+                                    void handleGenerate();
+                                }
+                                else {
+                                    void handleUpload();
+                                }
+                            }, children: [submitting ? _jsx(Loader2, { className: "mr-2 h-4 w-4 animate-spin" }) : null, mode === "generate" ? (_jsxs(_Fragment, { children: [_jsx(FileText, { className: "mr-1.5 h-3.5 w-3.5" }), t.generateAction] })) : (t.uploadAction)] })] })] }) }));
+}
+function SegmentedChoice({ value, onChange, options, }) {
+    return (_jsx("div", { className: "flex w-full rounded-md border bg-background p-0.5", children: options.map((opt) => {
+            const active = opt.value === value;
+            return (_jsx("button", { type: "button", onClick: () => onChange(opt.value), className: "flex-1 rounded-sm px-3 py-1.5 text-sm font-medium transition-colors " +
+                    (active ? "bg-muted text-foreground" : "text-muted-foreground hover:text-foreground"), children: opt.label }, opt.value));
+        }) }));
+}
+/**
+ * Wrap the rendered template body in a light-theme HTML document so
+ * the iframe doesn't inherit the dark dashboard background. Mirrors
+ * the storefront's contract-preview wrapper to keep the WYSIWYG
+ * promise honest.
+ */
+function wrapPreviewHtml(body) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<style>
+  :root { color-scheme: light; }
+  html, body { margin: 0; background: #ffffff; color: #111827; }
+  body {
+    padding: 1.5rem 2rem;
+    font-family: ui-serif, Georgia, "Times New Roman", serif;
+    font-size: 15px;
+    line-height: 1.6;
+  }
+  h1, h2, h3 { font-family: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif; color: #0f172a; }
+  h1 { font-size: 1.5rem; margin: 0 0 1rem; }
+  h2 { font-size: 1.15rem; margin: 1.5rem 0 0.5rem; }
+  p { margin: 0.5rem 0; }
+  ul, ol { padding-left: 1.5rem; }
+  strong { color: #0f172a; }
+  a { color: #2563eb; }
+  table { border-collapse: collapse; width: 100%; margin: 0.75rem 0; }
+  th, td { border: 1px solid #e5e7eb; padding: 0.5rem 0.75rem; text-align: left; }
+  th { background: #f9fafb; }
+</style>
+</head>
+<body>${body}</body>
+</html>`;
+}

package/dist/admin/booking-detail-host.d.ts

@@ -0,0 +1,103 @@
+import { type ReactNode } from "react";
+import { type BookingDetailPageSlots, type BookingDetailTabValue } from "../components/booking-detail-page.js";
+import type { BookingPaymentsSummaryRow } from "../components/booking-payments-summary.js";
+import { type BookingRecord } from "../index.js";
+import { bookingDetailFinanceEndSlot, bookingDetailFinanceStartSlot, bookingDetailInvoicesTabSlot } from "./slots.js";
+export { bookingDetailFinanceEndSlot, bookingDetailFinanceStartSlot, bookingDetailInvoicesTabSlot };
+/**
+ * Render context handed to the host's app-supplied slots AND to widget
+ * contributions targeting {@link bookingDetailInvoicesTabSlot}. Carries the
+ * booking plus the host-computed payment aggregates and the invoice-sheet
+ * opener so contributed cards can participate without re-deriving them.
+ */
+export interface BookingDetailHostSlotContext {
+    booking: BookingRecord;
+    /** Customer payments summed across non-credit-note, non-draft invoices. */
+    paidAmountCents: number | null;
+    /**
+     * Localized "Booking is fully paid" reason when nothing is left to pay,
+     * else `null`. The host already uses it for the Record payment / Add
+     * schedule buttons; payment-link slots reuse it for their own gating.
+     */
+    fullyPaidReason: string | null;
+    /** Open an invoice in the host's side sheet (stays on the booking page). */
+    openInvoiceSheet: (invoiceId: string) => void;
+    /**
+     * Opens the host app's "Generate payment link" flow (a dialog the app
+     * owns — `@voyant-travel/finance-react/checkout-ui` depends on this package, so the host
+     * cannot import it without a cycle). Forwarded from
+     * {@link BookingDetailHostProps.onGenerateLink}; `undefined` when the app
+     * didn't wire one, in which case payment-link widgets hide the button.
+     */
+    onGenerateLink: (() => void) | undefined;
+}
+export type BookingDetailHostSlot = (context: BookingDetailHostSlotContext) => ReactNode;
+/**
+ * App-supplied extension points. The host owns everything package-clean
+ * (the Documents tab, the action-ledger timeline merge, the finance-tab
+ * widget slots); these slots remain for app-local additions on top.
+ */
+export interface BookingDetailHostSlots {
+    /** Top of the Finance tab, rendered before any widget contributions. */
+    financeStart?: BookingDetailHostSlot;
+    /** Bottom of the Finance tab, rendered before any widget contributions. */
+    financeEnd?: BookingDetailHostSlot;
+    /** Mounts a dedicated Invoices tab between Payments and Suppliers. */
+    invoicesTab?: {
+        label?: string;
+        content: BookingDetailHostSlot;
+    };
+    /** Replaces the Documents tab content (default: {@link BookingDocumentsTable}). */
+    documents?: BookingDetailHostSlot;
+    /** Extra events merged into the Activity-tab timeline (the host already
+     *  merges the booking's central action-ledger entries). */
+    activityExtraEvents?: BookingDetailPageSlots["activityExtraEvents"];
+    /** Rendered below the activity timeline events, after the host's
+     *  action-ledger pager. */
+    activityTimelineFooter?: ReactNode;
+}
+export interface BookingDetailHostProps {
+    id: string;
+    /** Controlled tab value; the route file mirrors it into the URL. */
+    activeTab?: BookingDetailTabValue;
+    onTabChange?: (tab: BookingDetailTabValue) => void;
+    /**
+     * Opens the app's record-payment flow (a dialog owned by the host app —
+     * the payment dialogs live app-side because `@voyant-travel/finance-react/ui`
+     * depends on this package, so importing it here would be a cycle).
+     */
+    onRecordPayment?: () => void;
+    /** Opens the app's record-payment flow pre-filled with the row. */
+    onEditPayment?: (row: BookingPaymentsSummaryRow) => void;
+    /**
+     * Opens the app's "Generate payment link" flow (a dialog owned by the
+     * host app — `@voyant-travel/finance-react/checkout-ui` depends on this package, so
+     * importing it here would be a cycle). Forwarded to slot/widget
+     * contributions via {@link BookingDetailHostSlotContext.onGenerateLink}.
+     */
+    onGenerateLink?: () => void;
+    slots?: BookingDetailHostSlots;
+}
+/**
+ * Packaged admin host for the canonical `BookingDetailPage` (packaged-admin
+ * RFC Phase 3). Owns everything package-clean:
+ *
+ *   - Cross-route links resolve through semantic destinations (RFC §4.7):
+ *     `booking.list`, `person.detail`, `organization.detail`,
+ *     `product.detail`, `availabilitySlot.detail`, `payment.detail`,
+ *     `invoice.detail` — no host route tree import.
+ *   - Admin chrome breadcrumbs (`useAdminBreadcrumbs`).
+ *   - Admin widget extension points: the `booking.details.header` and
+ *     `booking.details.after-summary` slots render through the shared
+ *     `AdminWidgetSlotRenderer`, which reads the workspace shell's
+ *     `AdminExtensionsProvider` context.
+ *   - Paid-amount aggregation across the booking's invoices and the
+ *     derived fully-paid disabled reasons.
+ *   - Payment row delete (finance-react mutation) and the in-place
+ *     invoice sheet ({@link BookingInvoiceSheet}).
+ *
+ * App-local cards without package-level data access stay injectable via
+ * {@link BookingDetailHostSlots}.
+ */
+export declare function BookingDetailHost({ id, activeTab, onTabChange, onRecordPayment, onEditPayment, onGenerateLink, slots, }: BookingDetailHostProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=booking-detail-host.d.ts.map

package/dist/admin/booking-detail-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booking-detail-host.d.ts","sourceRoot":"","sources":["../../src/admin/booking-detail-host.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAA;AAChD,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAA;AAC7C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2CAA2C,CAAA;AAC1F,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,aAAa,CAAA;AAG5D,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,EAC7B,4BAA4B,EAC7B,MAAM,YAAY,CAAA;AAOnB,OAAO,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,4BAA4B,EAAE,CAAA;AAEnG;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B;IAC3C,OAAO,EAAE,aAAa,CAAA;IACtB,2EAA2E;IAC3E,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,4EAA4E;IAC5E,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C;;;;;;OAMG;IACH,cAAc,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAA;CACzC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,EAAE,4BAA4B,KAAK,SAAS,CAAA;AAExF;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,YAAY,CAAC,EAAE,qBAAqB,CAAA;IACpC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,sEAAsE;IACtE,WAAW,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,qBAAqB,CAAA;KAAE,CAAA;IAChE,mFAAmF;IACnF,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC;+DAC2D;IAC3D,mBAAmB,CAAC,EAAE,sBAAsB,CAAC,qBAAqB,CAAC,CAAA;IACnE;+BAC2B;IAC3B,sBAAsB,CAAC,EAAE,SAAS,CAAA;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAA;IACV,oEAAoE;IACpE,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAA;IAClD;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,mEAAmE;IACnE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,yBAAyB,KAAK,IAAI,CAAA;IACxD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,KAAK,CAAC,EAAE,sBAAsB,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,EAAE,EACF,SAAS,EACT,WAAW,EACX,eAAe,EACf,aAAa,EACb,cAAc,EACd,KAAK,GACN,EAAE,sBAAsB,2CA0KxB"}