hazo_ihelp 2.3.0 → 2.5.0

package/dist/components/index.d.ts

@@ -6,4 +6,5 @@ export { IhelpSearchDialog } from './ihelp_search_dialog.js';
 export { IhelpRichEditor } from './ihelp_rich_editor.js';
 export { IhelpEditor } from './ihelp_editor.js';
 export { IhelpFieldHelp, type IhelpFieldHelpProps } from './ihelp_field_help.js';
+export { TopicHoverIcon, resolveTopicForContext, type TopicHoverIconProps } from './topic_hover_icon.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/components/index.js

@@ -6,4 +6,5 @@ export { IhelpSearchDialog } from './ihelp_search_dialog.js';
 export { IhelpRichEditor } from './ihelp_rich_editor.js';
 export { IhelpEditor } from './ihelp_editor.js';
 export { IhelpFieldHelp } from './ihelp_field_help.js';
+export { TopicHoverIcon, resolveTopicForContext } from './topic_hover_icon.js';
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAA2B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA4B,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAA2B,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA4B,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAA4B,MAAM,uBAAuB,CAAC"}

package/dist/components/topic_hover_icon.d.ts

@@ -0,0 +1,92 @@
+import React from "react";
+import type { IhelpTopic } from "../types/index.js";
+/**
+ * Resolve the best topic for a context key: the topic whose `contexts` array
+ * contains an entry with `key === context_key`. When multiple topics match,
+ * the one with the **lowest** matching `contexts[].priority` wins. Returns
+ * `undefined` when no topic matches.
+ *
+ * Tie-break rule: if two topics share the same lowest matching priority, the
+ * one that appears **earlier** in the `topics` array wins (stable sort).
+ *
+ * Defensive: topics whose `contexts` property is missing or empty are silently
+ * skipped, so partial seed coverage never throws or produces broken icons.
+ *
+ * @param topics - Full list of `IhelpTopic` objects (e.g. from `search.all_topics`).
+ * @param context_key - The dot-notation context key to look up
+ *   (e.g. `"deductions.work_from_home"`).
+ * @returns The best-matching `IhelpTopic`, or `undefined` if none matched.
+ *
+ * @example
+ * ```ts
+ * const topic = resolveTopicForContext(search.all_topics, "income.salary");
+ * if (topic) { ... }
+ * ```
+ */
+export declare function resolveTopicForContext(topics: IhelpTopic[], context_key: string): IhelpTopic | undefined;
+/**
+ * Props for {@link TopicHoverIcon}.
+ *
+ * The component is intentionally thin: callers supply only a `context_key`
+ * and the icon resolves the matching topic from the `IhelpProvider` store on
+ * its own.
+ */
+export interface TopicHoverIconProps {
+    /**
+     * Dot-notation key that identifies a location in the host application
+     * (e.g. `"deductions.work_from_home"`).
+     *
+     * The component calls {@link resolveTopicForContext} against the provider's
+     * `search.all_topics` list to find the best matching topic. If no topic is
+     * found, the component renders `null` (graceful no-op).
+     */
+    context_key: string;
+    /**
+     * Icon pixel size passed to the Lucide `HelpCircle` icon.
+     * The trigger button is sized to `size + 8` pixels square.
+     * @defaultValue 14
+     */
+    size?: number;
+    /**
+     * Which side of the trigger the hover card opens on.
+     * @defaultValue "top"
+     */
+    side?: "top" | "right" | "bottom" | "left";
+    /**
+     * Optional extra CSS class names applied to the trigger button.
+     */
+    className?: string;
+}
+/**
+ * A small circular `?` icon that shows a Radix HoverCard with the title and
+ * description of the help topic mapped to `context_key`.
+ *
+ * **How topics are resolved** — The component looks up the `IhelpProvider`
+ * context (via {@link useIhelpContextOptional}) and calls
+ * {@link resolveTopicForContext} against `search.all_topics`. The topic
+ * whose `contexts` array contains `{ key: context_key }` with the lowest
+ * `priority` value is selected.
+ *
+ * **No-op cases** — the component renders `null` (nothing) when:
+ * - it is rendered outside an `<IhelpProvider>` (provider absent),
+ * - the provider is still loading topics (`search.loading === true`),
+ * - no topic is mapped to `context_key` (partial seed coverage is safe).
+ *
+ * **Escalation** — The hover card footer contains a "Learn more →" button that
+ * closes the card and calls `open_search(context_key)` to open the full
+ * `IhelpSearchDialog` seeded to that context — giving users access to the
+ * topic's rich `content` without embedding it inline.
+ *
+ * **Touch / keyboard** — Like `HoverHelpIcon`, opens on hover on desktop and
+ * on tap / Enter for touch / keyboard users (controlled `open` state overlay).
+ *
+ * @example
+ * ```tsx
+ * // Renders nothing if no topic is mapped to this key
+ * <label>
+ *   Work from home <TopicHoverIcon context_key="deductions.work_from_home" />
+ * </label>
+ * ```
+ */
+export declare function TopicHoverIcon({ context_key, size, side, className, }: TopicHoverIconProps): React.JSX.Element | null;
+//# sourceMappingURL=topic_hover_icon.d.ts.map

package/dist/components/topic_hover_icon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic_hover_icon.d.ts","sourceRoot":"","sources":["../../src/components/topic_hover_icon.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAIxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAAE,EACpB,WAAW,EAAE,MAAM,GAClB,UAAU,GAAG,SAAS,CAuBxB;AAMD;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;;;OAOG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAE3C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAAC,EAC7B,WAAW,EACX,IAAS,EACT,IAAY,EACZ,SAAS,GACV,EAAE,mBAAmB,4BA6ErB"}

package/dist/components/topic_hover_icon.js

@@ -0,0 +1,107 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import * as HoverCard from "@radix-ui/react-hover-card";
+import { HelpCircle, ArrowRight } from "lucide-react";
+import { cn } from "hazo_ui";
+import { useIhelpContextOptional } from "./ihelp_provider.js";
+// =============================================================================
+// Pure resolver
+// =============================================================================
+/**
+ * Resolve the best topic for a context key: the topic whose `contexts` array
+ * contains an entry with `key === context_key`. When multiple topics match,
+ * the one with the **lowest** matching `contexts[].priority` wins. Returns
+ * `undefined` when no topic matches.
+ *
+ * Tie-break rule: if two topics share the same lowest matching priority, the
+ * one that appears **earlier** in the `topics` array wins (stable sort).
+ *
+ * Defensive: topics whose `contexts` property is missing or empty are silently
+ * skipped, so partial seed coverage never throws or produces broken icons.
+ *
+ * @param topics - Full list of `IhelpTopic` objects (e.g. from `search.all_topics`).
+ * @param context_key - The dot-notation context key to look up
+ *   (e.g. `"deductions.work_from_home"`).
+ * @returns The best-matching `IhelpTopic`, or `undefined` if none matched.
+ *
+ * @example
+ * ```ts
+ * const topic = resolveTopicForContext(search.all_topics, "income.salary");
+ * if (topic) { ... }
+ * ```
+ */
+export function resolveTopicForContext(topics, context_key) {
+    let best_topic;
+    let best_priority = Infinity;
+    for (const topic of topics) {
+        if (!Array.isArray(topic.contexts) || topic.contexts.length === 0) {
+            continue;
+        }
+        for (const ctx of topic.contexts) {
+            if (ctx.key === context_key) {
+                // Lower priority value wins; ties go to the earlier topic in the array
+                // (best_priority is still Infinity on the first match, so any priority
+                // wins initially).
+                if (ctx.priority < best_priority) {
+                    best_topic = topic;
+                    best_priority = ctx.priority;
+                }
+                break; // only count the first matching context entry per topic
+            }
+        }
+    }
+    return best_topic;
+}
+/**
+ * A small circular `?` icon that shows a Radix HoverCard with the title and
+ * description of the help topic mapped to `context_key`.
+ *
+ * **How topics are resolved** — The component looks up the `IhelpProvider`
+ * context (via {@link useIhelpContextOptional}) and calls
+ * {@link resolveTopicForContext} against `search.all_topics`. The topic
+ * whose `contexts` array contains `{ key: context_key }` with the lowest
+ * `priority` value is selected.
+ *
+ * **No-op cases** — the component renders `null` (nothing) when:
+ * - it is rendered outside an `<IhelpProvider>` (provider absent),
+ * - the provider is still loading topics (`search.loading === true`),
+ * - no topic is mapped to `context_key` (partial seed coverage is safe).
+ *
+ * **Escalation** — The hover card footer contains a "Learn more →" button that
+ * closes the card and calls `open_search(context_key)` to open the full
+ * `IhelpSearchDialog` seeded to that context — giving users access to the
+ * topic's rich `content` without embedding it inline.
+ *
+ * **Touch / keyboard** — Like `HoverHelpIcon`, opens on hover on desktop and
+ * on tap / Enter for touch / keyboard users (controlled `open` state overlay).
+ *
+ * @example
+ * ```tsx
+ * // Renders nothing if no topic is mapped to this key
+ * <label>
+ *   Work from home <TopicHoverIcon context_key="deductions.work_from_home" />
+ * </label>
+ * ```
+ */
+export function TopicHoverIcon({ context_key, size = 14, side = "top", className, }) {
+    const ctx = useIhelpContextOptional();
+    const [tap_open, set_tap_open] = useState(false);
+    // No-op: outside a provider
+    if (!ctx)
+        return null;
+    const { search, open_search } = ctx;
+    // No-op: still loading
+    if (search.loading)
+        return null;
+    // No-op: no matching topic
+    const topic = resolveTopicForContext(search.all_topics, context_key);
+    if (!topic)
+        return null;
+    const aria_label = `Help: ${topic.title}`;
+    return (_jsxs(HoverCard.Root, { openDelay: 120, closeDelay: 120, open: tap_open || undefined, onOpenChange: set_tap_open, children: [_jsx(HoverCard.Trigger, { asChild: true, children: _jsx("button", { type: "button", "aria-label": aria_label, onClick: () => set_tap_open((v) => !v), className: cn("inline-flex items-center justify-center rounded-full text-blue-600", "hover:bg-blue-100 hover:text-blue-800 transition-colors", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-400 focus-visible:ring-offset-1", className), style: { width: size + 8, height: size + 8 }, children: _jsx(HelpCircle, { size: size, "aria-hidden": true }) }) }), _jsx(HoverCard.Portal, { children: _jsxs(HoverCard.Content, { side: side, sideOffset: 8, align: "center", className: cn("z-50 max-w-sm rounded-lg border border-black/5 bg-white p-4 shadow-lg", "text-xs leading-relaxed text-slate-700"), children: [_jsx("p", { className: "mb-2 text-sm font-semibold text-slate-900", children: topic.title }), topic.description != null && (_jsx("div", { className: "whitespace-pre-line", children: topic.description })), _jsxs("button", { type: "button", onClick: () => {
+                                set_tap_open(false);
+                                open_search(context_key);
+                            }, className: cn("mt-3 inline-flex items-center gap-1 text-xs font-semibold text-blue-600", "hover:text-blue-800 hover:underline", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-400 focus-visible:ring-offset-1 rounded"), children: ["Learn more", _jsx(ArrowRight, { size: 12, "aria-hidden": true })] }), _jsx(HoverCard.Arrow, { className: "fill-white" })] }) })] }));
+}
+//# sourceMappingURL=topic_hover_icon.js.map

package/dist/components/topic_hover_icon.js.map

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

package/dist/index.runtime.d.ts

@@ -15,6 +15,7 @@ export { IhelpProvider, useIhelpContext, useIhelpContextOptional, } from './comp
 export { IhelpIcon } from './components/ihelp_icon.js';
 export { HoverHelpIcon, type HoverHelpIconProps } from './components/hover_help_icon.js';
 export { IhelpFieldHelp, type IhelpFieldHelpProps } from './components/ihelp_field_help.js';
+export { TopicHoverIcon, resolveTopicForContext, type TopicHoverIconProps } from './components/topic_hover_icon.js';
 export { IhelpSearchDialog } from './components/ihelp_search_dialog.js';
 export { IhelpDetailPanel } from './components/ihelp_detail_panel.js';
 export * from './hooks/index.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.runtime.d.ts","sourceRoot":"","sources":["../src/index.runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.runtime.d.ts","sourceRoot":"","sources":["../src/index.runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACpH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAGtE,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EACV,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,WAAW,EACX,cAAc,EACd,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.runtime.js

@@ -15,6 +15,7 @@ export { IhelpProvider, useIhelpContext, useIhelpContextOptional, } from './comp
 export { IhelpIcon } from './components/ihelp_icon.js';
 export { HoverHelpIcon } from './components/hover_help_icon.js';
 export { IhelpFieldHelp } from './components/ihelp_field_help.js';
+export { TopicHoverIcon, resolveTopicForContext } from './components/topic_hover_icon.js';
 export { IhelpSearchDialog } from './components/ihelp_search_dialog.js';
 export { IhelpDetailPanel } from './components/ihelp_detail_panel.js';
 // Hooks (client-safe, REST-backed)

package/dist/index.runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.runtime.js","sourceRoot":"","sources":["../src/index.runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,aAAa,EAA2B,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,cAAc,EAA4B,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,mCAAmC;AACnC,cAAc,kBAAkB,CAAC;AAmBjC,QAAQ;AACR,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.runtime.js","sourceRoot":"","sources":["../src/index.runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,aAAa,EACb,eAAe,EACf,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,aAAa,EAA2B,MAAM,iCAAiC,CAAC;AACzF,OAAO,EAAE,cAAc,EAA4B,MAAM,kCAAkC,CAAC;AAC5F,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAA4B,MAAM,kCAAkC,CAAC;AACpH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAEtE,mCAAmC;AACnC,cAAc,kBAAkB,CAAC;AAmBjC,QAAQ;AACR,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_ihelp",
-  "version": "2.3.0",
+  "version": "2.5.0",
   "type": "module",
   "main": "./dist/index.client.js",
   "module": "./dist/index.client.js",
@@ -84,16 +84,17 @@
     "zod": "^4.1.12"
   },
   "peerDependencies": {
-    "hazo_auth": "^10.4.1",
-    "hazo_chat": "^6.0.0",
-    "hazo_config": "^2.3.0",
-    "hazo_connect": "^3.8.0",
-    "hazo_core": "^1.2.0",
-    "hazo_files": "^3.1.0",
-    "hazo_llm_api": "^2.1.0",
-    "hazo_logs": "^2.1.1",
+    "hazo_auth": "^10.15.0",
+    "hazo_chat": "^6.2.0",
+    "hazo_config": "^2.4.2",
+    "hazo_connect": "^4.0.0",
+    "hazo_core": "^2.0.0",
+    "hazo_files": "^3.2.0",
+    "hazo_llm_api": "^2.3.0",
+    "hazo_logs": "^2.2.0",
     "hazo_notes": "^2.0.0",
-    "hazo_ui": "^4.4.0",
+    "hazo_theme": "^1.3.0",
+    "hazo_ui": "^6.8.0",
     "next": "^14.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
@@ -130,10 +131,10 @@
     "hazo_ui": {
       "optional": false
     },
-    "next": {
+    "sharp": {
       "optional": true
     },
-    "sharp": {
+    "hazo_theme": {
       "optional": true
     }
   },
@@ -141,16 +142,16 @@
     "@types/node": "^20.14.10",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
-    "hazo_auth": "^10.4.1",
-    "hazo_chat": "^6.0.0",
-    "hazo_config": "^2.3.0",
-    "hazo_connect": "^3.8.0",
-    "hazo_core": "^1.2.0",
-    "hazo_files": "^3.1.0",
-    "hazo_llm_api": "^2.1.0",
-    "hazo_logs": "^2.1.1",
+    "hazo_auth": "^10.15.0",
+    "hazo_chat": "^6.2.0",
+    "hazo_config": "^2.4.2",
+    "hazo_connect": "^4.0.0",
+    "hazo_core": "^2.0.0",
+    "hazo_files": "^3.2.0",
+    "hazo_llm_api": "^2.3.0",
+    "hazo_logs": "^2.2.0",
     "hazo_notes": "^2.0.0",
-    "hazo_ui": "^4.4.0",
+    "hazo_ui": "^6.8.0",
     "next": "^16.0.10",
     "typescript": "^5.7.2"
   },