@hanzo/ui 8.27.25 → 8.27.31

package/dist/onboarding/frame.cjs

@@ -0,0 +1,38 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Page = Page;
+exports.Panel = Panel;
+exports.IntervalToggle = IntervalToggle;
+exports.Line = Line;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const shell_1 = require("@hanzogui/shell");
+const lucide_icons_2_1 = require("@hanzogui/lucide-icons-2");
+const button_1 = require("../backends/gui/button.cjs");
+const card_1 = require("../backends/gui/card.cjs");
+const layout_1 = require("../backends/gui/layout.cjs");
+const spinner_1 = require("../backends/gui/spinner.cjs");
+const toggle_group_1 = require("../backends/gui/toggle-group.cjs");
+const plans_1 = require("./plans.cjs");
+/**
+ * One page of onboarding: the product's mark, a title, a line under it, and the
+ * screen. No progress bar and no step counter. `width` sets how much room the
+ * screen has: a column for a form, the full row for three plans.
+ */
+function Page({ site, title, lede, back, children, center, width = 480, start, busy, }) {
+    return ((0, jsx_runtime_1.jsxs)(layout_1.YStack, { render: "main", "aria-busy": busy || undefined, bg: "$background", minH: "100vh", items: "center", justify: center ? 'center' : 'flex-start', gap: "$4", pt: center ? 96 : 28, pb: 96, px: "$4", children: [back ? ((0, jsx_runtime_1.jsx)(button_1.Button, { type: "button", variant: "ghost", size: "icon-lg", "aria-label": "Back", position: "absolute", t: 20, l: 20, rounded: "$10", onClick: back, children: (0, jsx_runtime_1.jsx)(lucide_icons_2_1.ArrowLeft, { size: 18 }) })) : null, (0, jsx_runtime_1.jsxs)(layout_1.XStack, { items: "center", gap: "$2.5", mb: "$5", children: [(0, jsx_runtime_1.jsx)(shell_1.HanzoMark, { size: 20 }), (0, jsx_runtime_1.jsx)(layout_1.SizableText, { size: "$5", fontWeight: "500", color: "$ink", children: site })] }), title || lede ? ((0, jsx_runtime_1.jsxs)(layout_1.YStack, { width: "100%", maxW: start ? width : 720, items: start ? 'flex-start' : 'center', gap: "$3", children: [title ? ((0, jsx_runtime_1.jsx)(layout_1.Heading, { render: "h1", size: "$9", fontWeight: "500", color: "$ink", text: start ? 'left' : 'center', m: 0, children: title })) : null, lede ? ((0, jsx_runtime_1.jsx)(layout_1.Paragraph, { size: "$3", color: "$quiet", text: start ? 'left' : 'center', maxW: 520, m: 0, children: lede })) : null] })) : null, busy ? (0, jsx_runtime_1.jsx)(spinner_1.Spinner, { size: 20 }) : null, children ? ((0, jsx_runtime_1.jsx)(layout_1.YStack, { width: "100%", maxW: width, items: "stretch", gap: "$4", mt: "$2", children: children })) : null] }));
+}
+/** A bordered panel with room inside, the surface for an order, a notice or a plan. */
+function Panel({ children, label }) {
+    return ((0, jsx_runtime_1.jsx)(card_1.Card, { "aria-label": label, bg: "$panel", width: "100%", children: (0, jsx_runtime_1.jsx)(card_1.CardContent, { gap: "$3", children: children }) }));
+}
+/** Monthly or Yearly, with what a year saves. `name` says which plan it changes, for screen readers. */
+function IntervalToggle({ interval, onChange, name }) {
+    return ((0, jsx_runtime_1.jsxs)(toggle_group_1.ToggleGroup, { type: "single", size: "sm", value: interval, disableDeactivation: true, "aria-label": `Billing interval for ${name}`, onValueChange: (v) => onChange(v), children: [(0, jsx_runtime_1.jsx)(toggle_group_1.ToggleGroupItem, { value: "monthly", children: "Monthly" }), (0, jsx_runtime_1.jsx)(toggle_group_1.ToggleGroupItem, { value: "annual", children: `Yearly · Save ${plans_1.saving}%` })] }));
+}
+/** A line of an order: what, and how much. `muted` for the lines that are not the total. */
+function Line({ label, note, value, muted, strong }) {
+    const color = muted ? '$quiet' : '$ink';
+    const weight = strong ? '600' : '400';
+    return ((0, jsx_runtime_1.jsxs)(layout_1.XStack, { justify: "space-between", gap: "$4", items: "flex-start", children: [(0, jsx_runtime_1.jsxs)(layout_1.YStack, { flex: 1, minW: 0, children: [(0, jsx_runtime_1.jsx)(layout_1.SizableText, { size: "$2", color: color, fontWeight: weight, children: label }), note ? ((0, jsx_runtime_1.jsx)(layout_1.SizableText, { size: "$1", color: "$quiet", children: note })) : null] }), (0, jsx_runtime_1.jsx)(layout_1.SizableText, { size: "$2", color: color, fontWeight: weight, children: value })] }));
+}

package/dist/onboarding/frame.d.ts

@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react';
+import { type Interval } from './plans.js';
+/**
+ * One page of onboarding: the product's mark, a title, a line under it, and the
+ * screen. No progress bar and no step counter. `width` sets how much room the
+ * screen has: a column for a form, the full row for three plans.
+ */
+export declare function Page({ site, title, lede, back, children, center, width, start, busy, }: {
+    site: string;
+    title: string;
+    lede?: string;
+    back?: () => void;
+    children?: ReactNode;
+    center?: boolean;
+    width?: number;
+    /** Left-align the title and the line under it with the column, as a form does. */
+    start?: boolean;
+    busy?: boolean;
+}): import("react").JSX.Element;
+/** A bordered panel with room inside, the surface for an order, a notice or a plan. */
+export declare function Panel({ children, label }: {
+    children: ReactNode;
+    label?: string;
+}): import("react").JSX.Element;
+/** Monthly or Yearly, with what a year saves. `name` says which plan it changes, for screen readers. */
+export declare function IntervalToggle({ interval, onChange, name }: {
+    interval: Interval;
+    onChange: (i: Interval) => void;
+    name: string;
+}): import("react").JSX.Element;
+/** A line of an order: what, and how much. `muted` for the lines that are not the total. */
+export declare function Line({ label, note, value, muted, strong }: {
+    label: ReactNode;
+    note?: ReactNode;
+    value: ReactNode;
+    muted?: boolean;
+    strong?: boolean;
+}): import("react").JSX.Element;
+//# sourceMappingURL=frame.d.ts.map

package/dist/onboarding/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/onboarding/frame.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQtC,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,EACnB,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,KAAW,EACX,KAAK,EACL,IAAI,GACL,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,IAAI,CAAA;IACjB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kFAAkF;IAClF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;CACf,+BAoCA;AAED,uFAAuF;AACvF,wBAAgB,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,+BAMjF;AAED,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,QAAQ,KAAK,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,+BAOjI;AAED,4FAA4F;AAC5F,wBAAgB,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,+BAoBtJ"}

package/dist/onboarding/frame.js

@@ -0,0 +1,33 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { HanzoMark } from '@hanzogui/shell';
+import { ArrowLeft } from '@hanzogui/lucide-icons-2';
+import { Button } from '../backends/gui/button.js';
+import { Card, CardContent } from '../backends/gui/card.js';
+import { Heading, Paragraph, SizableText, XStack, YStack } from '../backends/gui/layout.js';
+import { Spinner } from '../backends/gui/spinner.js';
+import { ToggleGroup, ToggleGroupItem } from '../backends/gui/toggle-group.js';
+import { saving } from './plans.js';
+/**
+ * One page of onboarding: the product's mark, a title, a line under it, and the
+ * screen. No progress bar and no step counter. `width` sets how much room the
+ * screen has: a column for a form, the full row for three plans.
+ */
+export function Page({ site, title, lede, back, children, center, width = 480, start, busy, }) {
+    return (_jsxs(YStack, { render: "main", "aria-busy": busy || undefined, bg: "$background", minH: "100vh", items: "center", justify: center ? 'center' : 'flex-start', gap: "$4", pt: center ? 96 : 28, pb: 96, px: "$4", children: [back ? (_jsx(Button, { type: "button", variant: "ghost", size: "icon-lg", "aria-label": "Back", position: "absolute", t: 20, l: 20, rounded: "$10", onClick: back, children: _jsx(ArrowLeft, { size: 18 }) })) : null, _jsxs(XStack, { items: "center", gap: "$2.5", mb: "$5", children: [_jsx(HanzoMark, { size: 20 }), _jsx(SizableText, { size: "$5", fontWeight: "500", color: "$ink", children: site })] }), title || lede ? (_jsxs(YStack, { width: "100%", maxW: start ? width : 720, items: start ? 'flex-start' : 'center', gap: "$3", children: [title ? (_jsx(Heading, { render: "h1", size: "$9", fontWeight: "500", color: "$ink", text: start ? 'left' : 'center', m: 0, children: title })) : null, lede ? (_jsx(Paragraph, { size: "$3", color: "$quiet", text: start ? 'left' : 'center', maxW: 520, m: 0, children: lede })) : null] })) : null, busy ? _jsx(Spinner, { size: 20 }) : null, children ? (_jsx(YStack, { width: "100%", maxW: width, items: "stretch", gap: "$4", mt: "$2", children: children })) : null] }));
+}
+/** A bordered panel with room inside, the surface for an order, a notice or a plan. */
+export function Panel({ children, label }) {
+    return (_jsx(Card, { "aria-label": label, bg: "$panel", width: "100%", children: _jsx(CardContent, { gap: "$3", children: children }) }));
+}
+/** Monthly or Yearly, with what a year saves. `name` says which plan it changes, for screen readers. */
+export function IntervalToggle({ interval, onChange, name }) {
+    return (_jsxs(ToggleGroup, { type: "single", size: "sm", value: interval, disableDeactivation: true, "aria-label": `Billing interval for ${name}`, onValueChange: (v) => onChange(v), children: [_jsx(ToggleGroupItem, { value: "monthly", children: "Monthly" }), _jsx(ToggleGroupItem, { value: "annual", children: `Yearly · Save ${saving}%` })] }));
+}
+/** A line of an order: what, and how much. `muted` for the lines that are not the total. */
+export function Line({ label, note, value, muted, strong }) {
+    const color = muted ? '$quiet' : '$ink';
+    const weight = strong ? '600' : '400';
+    return (_jsxs(XStack, { justify: "space-between", gap: "$4", items: "flex-start", children: [_jsxs(YStack, { flex: 1, minW: 0, children: [_jsx(SizableText, { size: "$2", color: color, fontWeight: weight, children: label }), note ? (_jsx(SizableText, { size: "$1", color: "$quiet", children: note })) : null] }), _jsx(SizableText, { size: "$2", color: color, fontWeight: weight, children: value })] }));
+}
+//# sourceMappingURL=frame.js.map

package/dist/onboarding/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/onboarding/frame.tsx"],"names":[],"mappings":"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"}

package/dist/onboarding/hooks.cjs

@@ -0,0 +1,70 @@
+'use client';"use strict";
+'use client';
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSession = useSession;
+exports.useOnboarded = useOnboarded;
+const react_1 = require("react");
+const api_1 = require("./api.cjs");
+const state_1 = require("./state.cjs");
+/**
+ * The person's onboarding, read from IAM once and written through as each step
+ * finishes. A failed read leaves the flow at the start rather than blocking it.
+ */
+function useSession(api = api_1.API) {
+    const [loading, setLoading] = (0, react_1.useState)(true);
+    const [stored, setStored] = (0, react_1.useState)({});
+    const [name, setNameState] = (0, react_1.useState)('');
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        let live = true;
+        Promise.all([(0, api_1.preferences)(api).catch(() => ({})), (0, api_1.account)(api).catch(() => null)]).then(([prefs, me]) => {
+            if (!live)
+                return;
+            setStored(prefs ?? {});
+            const a = me;
+            setNameState(a?.displayName?.trim() ?? '');
+            setLoading(false);
+        });
+        return () => {
+            live = false;
+        };
+    }, [api]);
+    const save = (0, react_1.useCallback)(async (patch) => {
+        setStored((s) => ({ ...s, onboarding: { ...(s.onboarding ?? {}), ...patch } }));
+        try {
+            await (0, api_1.saveProgress)(api, patch);
+            setError(null);
+        }
+        catch (e) {
+            setError(e instanceof Error ? e.message : 'Could not save. Try again.');
+        }
+    }, [api]);
+    const setName = (0, react_1.useCallback)(async (n) => {
+        await (0, api_1.rename)(api, n);
+        setNameState(n);
+        await save({ named: true });
+    }, [api, save]);
+    const setTrain = (0, react_1.useCallback)(async (on) => {
+        setStored((s) => ({ ...s, train_opt_in: on }));
+        await (0, api_1.preferences)(api, { train_opt_in: on });
+    }, [api]);
+    return { loading, progress: stored.onboarding ?? {}, trainOptIn: stored.train_opt_in, name, save, setName, setTrain, error };
+}
+/**
+ * Whether this person still has an onboarding step to do: `null` while IAM has
+ * not answered, so a gate never flashes the wrong screen. A failed read answers
+ * `false` (nothing to do), because a broken read must not lock anyone out.
+ */
+function useOnboarded(api = api_1.API) {
+    const [state, setState] = (0, react_1.useState)({ pending: null, plan: undefined });
+    (0, react_1.useEffect)(() => {
+        let live = true;
+        (0, api_1.preferences)(api)
+            .then((s) => live && setState({ pending: (0, state_1.step)(s?.onboarding ?? {}) !== 'done', plan: s?.onboarding?.plan }))
+            .catch(() => live && setState({ pending: false, plan: undefined }));
+        return () => {
+            live = false;
+        };
+    }, [api]);
+    return state;
+}

package/dist/onboarding/hooks.d.ts

@@ -0,0 +1,30 @@
+import { type Progress } from './state.js';
+export type Track = (name: string, props?: Record<string, unknown>) => void;
+export interface Session {
+    /** Nothing has answered yet. */
+    loading: boolean;
+    progress: Progress;
+    trainOptIn: boolean | undefined;
+    /** The display name IAM holds, if any. */
+    name: string;
+    /** Merge a step into the stored progress (and the screen). */
+    save: (patch: Progress) => Promise<void>;
+    setName: (name: string) => Promise<void>;
+    setTrain: (on: boolean) => Promise<void>;
+    error: string | null;
+}
+/**
+ * The person's onboarding, read from IAM once and written through as each step
+ * finishes. A failed read leaves the flow at the start rather than blocking it.
+ */
+export declare function useSession(api?: string): Session;
+/**
+ * Whether this person still has an onboarding step to do: `null` while IAM has
+ * not answered, so a gate never flashes the wrong screen. A failed read answers
+ * `false` (nothing to do), because a broken read must not lock anyone out.
+ */
+export declare function useOnboarded(api?: string): {
+    pending: boolean | null;
+    plan: string | undefined;
+};
+//# sourceMappingURL=hooks.d.ts.map

package/dist/onboarding/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/onboarding/hooks.ts"],"names":[],"mappings":"AAIA,OAAO,EAAQ,KAAK,QAAQ,EAAe,MAAM,SAAS,CAAA;AAE1D,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;AAE3E,MAAM,WAAW,OAAO;IACtB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,QAAQ,CAAA;IAClB,UAAU,EAAE,OAAO,GAAG,SAAS,CAAA;IAC/B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,8DAA8D;IAC9D,IAAI,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,QAAQ,EAAE,CAAC,EAAE,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACxC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAY,GAAG,OAAO,CAmDrD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAY,GAAG;IAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAYrG"}

package/dist/onboarding/hooks.js

@@ -0,0 +1,67 @@
+'use client';
+import { useCallback, useEffect, useState } from 'react';
+import { account, API, preferences, rename, saveProgress } from './api.js';
+import { step } from './state.js';
+/**
+ * The person's onboarding, read from IAM once and written through as each step
+ * finishes. A failed read leaves the flow at the start rather than blocking it.
+ */
+export function useSession(api = API) {
+    const [loading, setLoading] = useState(true);
+    const [stored, setStored] = useState({});
+    const [name, setNameState] = useState('');
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        let live = true;
+        Promise.all([preferences(api).catch(() => ({})), account(api).catch(() => null)]).then(([prefs, me]) => {
+            if (!live)
+                return;
+            setStored(prefs ?? {});
+            const a = me;
+            setNameState(a?.displayName?.trim() ?? '');
+            setLoading(false);
+        });
+        return () => {
+            live = false;
+        };
+    }, [api]);
+    const save = useCallback(async (patch) => {
+        setStored((s) => ({ ...s, onboarding: { ...(s.onboarding ?? {}), ...patch } }));
+        try {
+            await saveProgress(api, patch);
+            setError(null);
+        }
+        catch (e) {
+            setError(e instanceof Error ? e.message : 'Could not save. Try again.');
+        }
+    }, [api]);
+    const setName = useCallback(async (n) => {
+        await rename(api, n);
+        setNameState(n);
+        await save({ named: true });
+    }, [api, save]);
+    const setTrain = useCallback(async (on) => {
+        setStored((s) => ({ ...s, train_opt_in: on }));
+        await preferences(api, { train_opt_in: on });
+    }, [api]);
+    return { loading, progress: stored.onboarding ?? {}, trainOptIn: stored.train_opt_in, name, save, setName, setTrain, error };
+}
+/**
+ * Whether this person still has an onboarding step to do: `null` while IAM has
+ * not answered, so a gate never flashes the wrong screen. A failed read answers
+ * `false` (nothing to do), because a broken read must not lock anyone out.
+ */
+export function useOnboarded(api = API) {
+    const [state, setState] = useState({ pending: null, plan: undefined });
+    useEffect(() => {
+        let live = true;
+        preferences(api)
+            .then((s) => live && setState({ pending: step(s?.onboarding ?? {}) !== 'done', plan: s?.onboarding?.plan }))
+            .catch(() => live && setState({ pending: false, plan: undefined }));
+        return () => {
+            live = false;
+        };
+    }, [api]);
+    return state;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/onboarding/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/onboarding/hooks.ts"],"names":[],"mappings":"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"}

package/dist/onboarding/index.cjs

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preferences = exports.API = exports.ROLES = exports.OWN_TOPIC = exports.unit = exports.SLUG = exports.saving = exports.SEAT_ADDON = exports.period = exports.OFFERS = exports.MIN_SEATS = exports.MAX_SEATS = exports.lines = exports.item = exports.ENTERPRISE_FROM = exports.ANNUAL = exports.step = exports.chatStep = exports.useSession = exports.useOnboarded = exports.Checkout = exports.ChatOnboarding = exports.Onboarding = void 0;
+/**
+ * The onboarding every Hanzo surface shares. IAM holds each person's progress
+ * (POST /v1/iam/preferences), commerce takes the payment (/v1/billing), and
+
+ *
+ *   <Onboarding/>      how you will use Hanzo → plans | team → seats → checkout
+ *   <ChatOnboarding/>  before your first chat → name → role and starter prompts
+ *   <Checkout/>        the one checkout, also behind every Upgrade entry
+ */
+var Onboarding_1 = require("./Onboarding.cjs");
+Object.defineProperty(exports, "Onboarding", { enumerable: true, get: function () { return Onboarding_1.Onboarding; } });
+var ChatOnboarding_1 = require("./ChatOnboarding.cjs");
+Object.defineProperty(exports, "ChatOnboarding", { enumerable: true, get: function () { return ChatOnboarding_1.ChatOnboarding; } });
+var Checkout_1 = require("./Checkout.cjs");
+Object.defineProperty(exports, "Checkout", { enumerable: true, get: function () { return Checkout_1.Checkout; } });
+var hooks_1 = require("./hooks.cjs");
+Object.defineProperty(exports, "useOnboarded", { enumerable: true, get: function () { return hooks_1.useOnboarded; } });
+Object.defineProperty(exports, "useSession", { enumerable: true, get: function () { return hooks_1.useSession; } });
+var state_1 = require("./state.cjs");
+Object.defineProperty(exports, "chatStep", { enumerable: true, get: function () { return state_1.chatStep; } });
+Object.defineProperty(exports, "step", { enumerable: true, get: function () { return state_1.step; } });
+var plans_1 = require("./plans.cjs");
+Object.defineProperty(exports, "ANNUAL", { enumerable: true, get: function () { return plans_1.ANNUAL; } });
+Object.defineProperty(exports, "ENTERPRISE_FROM", { enumerable: true, get: function () { return plans_1.ENTERPRISE_FROM; } });
+Object.defineProperty(exports, "item", { enumerable: true, get: function () { return plans_1.item; } });
+Object.defineProperty(exports, "lines", { enumerable: true, get: function () { return plans_1.lines; } });
+Object.defineProperty(exports, "MAX_SEATS", { enumerable: true, get: function () { return plans_1.MAX_SEATS; } });
+Object.defineProperty(exports, "MIN_SEATS", { enumerable: true, get: function () { return plans_1.MIN_SEATS; } });
+Object.defineProperty(exports, "OFFERS", { enumerable: true, get: function () { return plans_1.OFFERS; } });
+Object.defineProperty(exports, "period", { enumerable: true, get: function () { return plans_1.period; } });
+Object.defineProperty(exports, "SEAT_ADDON", { enumerable: true, get: function () { return plans_1.SEAT_ADDON; } });
+Object.defineProperty(exports, "saving", { enumerable: true, get: function () { return plans_1.saving; } });
+Object.defineProperty(exports, "SLUG", { enumerable: true, get: function () { return plans_1.SLUG; } });
+Object.defineProperty(exports, "unit", { enumerable: true, get: function () { return plans_1.unit; } });
+var roles_1 = require("./roles.cjs");
+Object.defineProperty(exports, "OWN_TOPIC", { enumerable: true, get: function () { return roles_1.OWN_TOPIC; } });
+Object.defineProperty(exports, "ROLES", { enumerable: true, get: function () { return roles_1.ROLES; } });
+var api_1 = require("./api.cjs");
+Object.defineProperty(exports, "API", { enumerable: true, get: function () { return api_1.API; } });
+Object.defineProperty(exports, "preferences", { enumerable: true, get: function () { return api_1.preferences; } });

package/dist/onboarding/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The onboarding every Hanzo surface shares. IAM holds each person's progress
+ * (POST /v1/iam/preferences), commerce takes the payment (/v1/billing), and
+
+ *
+ *   <Onboarding/>      how you will use Hanzo → plans | team → seats → checkout
+ *   <ChatOnboarding/>  before your first chat → name → role and starter prompts
+ *   <Checkout/>        the one checkout, also behind every Upgrade entry
+ */
+export { Onboarding, type OnboardingProps } from './Onboarding.js';
+export { ChatOnboarding, type ChatOnboardingProps } from './ChatOnboarding.js';
+export { Checkout, type CheckoutProps } from './Checkout.js';
+export { useOnboarded, useSession, type Session, type Track } from './hooks.js';
+export { chatStep, step, type ChatStep, type Progress, type Step, type Use } from './state.js';
+export { ANNUAL, ENTERPRISE_FROM, item, lines, MAX_SEATS, MIN_SEATS, OFFERS, period, SEAT_ADDON, saving, SLUG, unit, type Interval, type Lines, type Offer, type PlanId } from './plans.js';
+export { OWN_TOPIC, ROLES, type Role, type Starter } from './roles.js';
+export { API, preferences } from './api.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/onboarding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,GAAG,EAAE,MAAM,SAAS,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,KAAK,KAAK,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAA;AACxL,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,KAAK,OAAO,EAAE,MAAM,SAAS,CAAA;AACnE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA"}

package/dist/onboarding/index.js

@@ -0,0 +1,18 @@
+/**
+ * The onboarding every Hanzo surface shares. IAM holds each person's progress
+ * (POST /v1/iam/preferences), commerce takes the payment (/v1/billing), and
+
+ *
+ *   <Onboarding/>      how you will use Hanzo → plans | team → seats → checkout
+ *   <ChatOnboarding/>  before your first chat → name → role and starter prompts
+ *   <Checkout/>        the one checkout, also behind every Upgrade entry
+ */
+export { Onboarding } from './Onboarding.js';
+export { ChatOnboarding } from './ChatOnboarding.js';
+export { Checkout } from './Checkout.js';
+export { useOnboarded, useSession } from './hooks.js';
+export { chatStep, step } from './state.js';
+export { ANNUAL, ENTERPRISE_FROM, item, lines, MAX_SEATS, MIN_SEATS, OFFERS, period, SEAT_ADDON, saving, SLUG, unit } from './plans.js';
+export { OWN_TOPIC, ROLES } from './roles.js';
+export { API, preferences } from './api.js';
+//# sourceMappingURL=index.js.map

package/dist/onboarding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/onboarding/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAA;AAC/D,OAAO,EAAE,cAAc,EAA4B,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAqD,MAAM,SAAS,CAAA;AAC3F,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAsD,MAAM,SAAS,CAAA;AACxL,OAAO,EAAE,SAAS,EAAE,KAAK,EAA2B,MAAM,SAAS,CAAA;AACnE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA"}

package/dist/onboarding/plans.cjs

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLUG = exports.money = exports.usd = exports.saving = exports.period = exports.unit = exports.OFFERS = exports.ENTERPRISE_FROM = exports.MAX_SEATS = exports.MIN_SEATS = exports.SEAT_ADDON = exports.ANNUAL = void 0;
+exports.lines = lines;
+exports.item = item;
+const plans_1 = require("@hanzo/plans");
+/** Annual price is the monthly price times this. */
+exports.ANNUAL = 0.82;
+/** What a team seat adds to the personal plan it is built on, per month. */
+exports.SEAT_ADDON = 5;
+exports.MIN_SEATS = 2;
+exports.MAX_SEATS = 150;
+/** From 20 people the team plan becomes a conversation. */
+exports.ENTERPRISE_FROM = 20;
+const monthlyOf = (slug) => {
+    const p = plans_1.subscriptionPlans.find((x) => x.id === slug);
+    if (!p || p.priceMonthly == null)
+        throw new Error(`@hanzo/plans has no monthly price for ${slug}`);
+    return p.priceMonthly;
+};
+const cents = (n) => Math.round(n * 100) / 100;
+exports.OFFERS = {
+    free: {
+        id: 'free',
+        name: 'Free',
+        category: 'individual',
+        monthly: 0,
+        blurb: 'Meet Hanzo',
+        features: ['Chat on web, iOS, Android and desktop', 'The free Zen models, with a daily allowance', 'Built-in web search', 'Add credit at any time for the paid models'],
+    },
+    dev: {
+        id: 'dev',
+        name: 'Dev',
+        category: 'individual',
+        monthly: monthlyOf('dev'),
+        blurb: 'Research, code, and organize',
+        features: ['Everything in Free and:', 'Hanzo Dev in your own repository', 'Every room in the Hanzo app', 'Higher usage limits', 'MCP, the SDK and the CLI included'],
+    },
+    max: {
+        id: 'max',
+        name: 'Max',
+        category: 'individual',
+        monthly: monthlyOf('max'),
+        blurb: 'Higher limits, priority access',
+        features: ['Everything in Dev, plus:', 'Enso orchestration across models', 'Unlimited managed agents', 'Higher output limits for all tasks', 'Priority access at high traffic times'],
+    },
+    team_standard: {
+        id: 'team_standard',
+        name: 'Standard seat',
+        category: 'team',
+        monthly: monthlyOf('dev') + exports.SEAT_ADDON,
+        blurb: 'A Dev seat for each teammate',
+        features: ['Everything in Dev, per person', 'Org workspaces with shared history and projects', 'SSO through Hanzo IAM', 'One bill for everyone'],
+    },
+    team_premium: {
+        id: 'team_premium',
+        name: 'Premium seat',
+        category: 'team',
+        monthly: monthlyOf('max') + exports.SEAT_ADDON,
+        blurb: 'A Max seat for heavy users',
+        features: ['Everything in Max, per person', 'Org workspaces with shared history and projects', 'SSO through Hanzo IAM', 'One bill for everyone'],
+    },
+};
+/** One unit's price per month at this interval (a year, spread over its twelve months). */
+const unit = (id, interval) => cents(interval === 'annual' ? exports.OFFERS[id].monthly * exports.ANNUAL : exports.OFFERS[id].monthly);
+exports.unit = unit;
+/** What one unit costs per billing period: the month, or the year at once. */
+const period = (id, interval) => (interval === 'annual' ? cents((0, exports.unit)(id, 'annual') * 12) : (0, exports.unit)(id, 'monthly'));
+exports.period = period;
+/** What a year saves over twelve months, as a whole percent. */
+exports.saving = Math.round((1 - exports.ANNUAL) * 100);
+function lines(id, interval, seats = 1) {
+    const n = exports.OFFERS[id].category === 'team' ? Math.max(exports.MIN_SEATS, Math.min(exports.MAX_SEATS, Math.floor(seats))) : 1;
+    return { seats: n, subtotal: cents((0, exports.period)(id, interval) * n), perMonth: cents((0, exports.unit)(id, interval) * n) };
+}
+/** GA4-shaped item for a commerce event: price is per unit, quantity is seats. */
+function item(id, interval, seats = 1) {
+    const o = exports.OFFERS[id];
+    return { item_id: id, item_name: o.name, item_category: o.category, item_variant: interval, price: (0, exports.period)(id, interval), quantity: lines(id, interval, seats).seats };
+}
+const usd = (n) => `$${n.toFixed(2)}`;
+exports.usd = usd;
+/** `$19` when whole, `$15.58` when not. */
+const money = (n) => (Number.isInteger(n) ? `$${n}` : (0, exports.usd)(n));
+exports.money = money;
+/** The commerce catalog's slug for a plan, and the quantity it is bought at. */
+exports.SLUG = { free: 'free', dev: 'dev', max: 'max', team_standard: 'team-standard', team_premium: 'team-premium' };

package/dist/onboarding/plans.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What Hanzo sells, priced from @hanzo/plans and nothing else.
+ *
+ *   free            chat only; offered on the personal path alone
+ *   dev, max        the personal plans, at the catalog's monthly price
+ *   team_standard   a Dev seat + the team add-on
+ *   team_premium    a Max seat + the team add-on, two seats at least
+ *
+ * A year is the month times 0.82, paid at once.
+ */
+export type PlanId = 'free' | 'dev' | 'max' | 'team_standard' | 'team_premium';
+export type Interval = 'monthly' | 'annual';
+export type Category = 'individual' | 'team';
+/** Annual price is the monthly price times this. */
+export declare const ANNUAL = 0.82;
+/** What a team seat adds to the personal plan it is built on, per month. */
+export declare const SEAT_ADDON = 5;
+export declare const MIN_SEATS = 2;
+export declare const MAX_SEATS = 150;
+/** From 20 people the team plan becomes a conversation. */
+export declare const ENTERPRISE_FROM = 20;
+export interface Offer {
+    id: PlanId;
+    name: string;
+    category: Category;
+    /** GA4 item_id / item_category / item_name come from here. */
+    monthly: number;
+    blurb: string;
+    features: string[];
+}
+export declare const OFFERS: Record<PlanId, Offer>;
+/** One unit's price per month at this interval (a year, spread over its twelve months). */
+export declare const unit: (id: PlanId, interval: Interval) => number;
+/** What one unit costs per billing period: the month, or the year at once. */
+export declare const period: (id: PlanId, interval: Interval) => number;
+/** What a year saves over twelve months, as a whole percent. */
+export declare const saving: number;
+export interface Lines {
+    seats: number;
+    /** What is charged today (before tax): the period's price times the seats. */
+    subtotal: number;
+    /** What that comes to per month. */
+    perMonth: number;
+}
+export declare function lines(id: PlanId, interval: Interval, seats?: number): Lines;
+/** GA4-shaped item for a commerce event: price is per unit, quantity is seats. */
+export declare function item(id: PlanId, interval: Interval, seats?: number): {
+    item_id: PlanId;
+    item_name: string;
+    item_category: Category;
+    item_variant: Interval;
+    price: number;
+    quantity: number;
+};
+export declare const usd: (n: number) => string;
+/** `$19` when whole, `$15.58` when not. */
+export declare const money: (n: number) => string;
+/** The commerce catalog's slug for a plan, and the quantity it is bought at. */
+export declare const SLUG: Record<PlanId, string>;
+//# sourceMappingURL=plans.d.ts.map

package/dist/onboarding/plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plans.d.ts","sourceRoot":"","sources":["../../src/onboarding/plans.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,eAAe,GAAG,cAAc,CAAA;AAC9E,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAC3C,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAA;AAE5C,oDAAoD;AACpD,eAAO,MAAM,MAAM,OAAO,CAAA;AAC1B,4EAA4E;AAC5E,eAAO,MAAM,UAAU,IAAI,CAAA;AAC3B,eAAO,MAAM,SAAS,IAAI,CAAA;AAC1B,eAAO,MAAM,SAAS,MAAM,CAAA;AAC5B,2DAA2D;AAC3D,eAAO,MAAM,eAAe,KAAK,CAAA;AAUjC,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAyCxC,CAAA;AAED,2FAA2F;AAC3F,eAAO,MAAM,IAAI,OAAQ,MAAM,YAAY,QAAQ,KAAG,MAAyF,CAAA;AAE/I,8EAA8E;AAC9E,eAAO,MAAM,MAAM,OAAQ,MAAM,YAAY,QAAQ,KAAG,MAAwF,CAAA;AAEhJ,gEAAgE;AAChE,eAAO,MAAM,MAAM,QAAiC,CAAA;AAEpD,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,SAAI,GAAG,KAAK,CAGtE;AAED,kFAAkF;AAClF,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,SAAI;IAEnD,OAAO;IAAM,SAAS;IAAU,aAAa;IAAc,YAAY;IAAY,KAAK;IAAwB,QAAQ;EAClI;AAED,eAAO,MAAM,GAAG,MAAO,MAAM,KAAG,MAA4B,CAAA;AAC5D,2CAA2C;AAC3C,eAAO,MAAM,KAAK,MAAO,MAAM,KAAG,MAAkD,CAAA;AAEpF,gFAAgF;AAChF,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAA0G,CAAA"}