hazo_ihelp 2.2.0 → 2.4.0

package/README.md

@@ -16,16 +16,16 @@ npm install hazo_ihelp
 | `react-dom` | ^18 or ^19 | Required |
 | `tailwindcss` | ^4.2.4 | Required for styling |
 | `@tailwindcss/typography` | >=0.5.0 | Required — `prose` classes for rich content rendering |
-| `hazo_core` | ^1.0.0 | Required — error classes, correlation IDs, config/logger |
-| `hazo_ui` | ^3.1.3 | Required — shared UI primitives + `cn()` |
+| `hazo_core` | ^1.2.0 | Required — error classes, correlation IDs, config/logger |
+| `hazo_ui` | ^4.4.0 | Required — shared UI primitives + `cn()` |
 | `next` | ^14 or ^16 | Optional — needed for API handlers |
-| `hazo_connect` | ^3.0.0 | Optional — needed for API handlers |
-| `hazo_config` | ^2.1.6 | Optional — INI config loading |
-| `hazo_logs` | ^2.0.2 | Optional — structured logging |
-| `hazo_auth` | ^10.0.0 | Optional — multi-tenant scoping |
+| `hazo_connect` | ^3.8.0 | Optional — needed for API handlers |
+| `hazo_config` | ^2.3.0 | Optional — INI config loading |
+| `hazo_logs` | ^2.1.1 | Optional — structured logging |
+| `hazo_auth` | ^10.4.1 | Optional — multi-tenant scoping |
 | `hazo_chat` | ^6.0.0 | Optional |
-| `hazo_files` | ^3.0.0 | Optional — image upload handling |
-| `hazo_llm_api` | ^2.0.0 | Optional |
+| `hazo_files` | ^3.1.0 | Optional — image upload handling |
+| `hazo_llm_api` | ^2.1.0 | Optional |
 | `hazo_notes` | ^2.0.0 | Optional |
 
 ## Tailwind v4 Setup (Required)
@@ -235,6 +235,7 @@ Full CRUD editor for managing help topics (tags and context mappings are embedde
 | Import path | Contents |
 |-------------|----------|
 | `hazo_ihelp` | Client components: `IhelpProvider`, `IhelpIcon`, `IhelpFieldHelp`, `IhelpSearchDialog`, `IhelpDetailPanel` |
+| `hazo_ihelp/runtime` | Lean runtime entry — help consumption surface (provider, icons, search dialog, detail panel, field help, hooks) **without** the Tiptap/dnd-kit editor. Use this in consumers that only need to *display* help, not author it. |
 | `hazo_ihelp/api` | Server handlers: `createIhelpHandler`, `createImageUploadHandler`, `createConfigHandler` |
 | `hazo_ihelp/hooks` | Hooks: `use_ihelp`, `use_ihelp_search`, `use_ihelp_editor`, `use_ihelp_config` |
 | `hazo_ihelp/components` | All components including `IhelpEditor` and UI primitives |

package/dist/components/editor/editor_collapsible_section.d.ts

@@ -6,6 +6,6 @@ interface CollapsibleSectionProps {
     defaultOpen?: boolean;
     children: React.ReactNode;
 }
-export declare function CollapsibleSection({ icon, label, badge, defaultOpen, children, }: CollapsibleSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function CollapsibleSection({ icon, label, badge, defaultOpen, children, }: CollapsibleSectionProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_collapsible_section.d.ts.map

package/dist/components/editor/editor_collapsible_section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_collapsible_section.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_collapsible_section.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,UAAU,uBAAuB;IAC/B,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,KAAK,EACL,KAAK,EACL,WAAmB,EACnB,QAAQ,GACT,EAAE,uBAAuB,2CAsCzB"}
+{"version":3,"file":"editor_collapsible_section.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_collapsible_section.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,UAAU,uBAAuB;IAC/B,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,KAAK,EACL,KAAK,EACL,WAAmB,EACnB,QAAQ,GACT,EAAE,uBAAuB,qBAsCzB"}

package/dist/components/editor/editor_context_keys_section.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { ContextKeyOption } from '../../types/index.js';
 interface EditorContextKeysSectionProps {
     context_keys: string[];
@@ -8,6 +9,6 @@ interface EditorContextKeysSectionProps {
     onRemove: (index: number) => void;
     onManageKeys?: (keys: ContextKeyOption[]) => void;
 }
-export declare function EditorContextKeysSection({ context_keys, available_keys, available_keys_loading, defaultOpen, onAdd, onRemove, onManageKeys, }: EditorContextKeysSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorContextKeysSection({ context_keys, available_keys, available_keys_loading, defaultOpen, onAdd, onRemove, onManageKeys, }: EditorContextKeysSectionProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_context_keys_section.d.ts.map

package/dist/components/editor/editor_context_keys_section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_context_keys_section.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_context_keys_section.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAU7D,UAAU,6BAA6B;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;CACnD;AAwMD,wBAAgB,wBAAwB,CAAC,EACvC,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,KAAK,EACL,QAAQ,EACR,YAAY,GACb,EAAE,6BAA6B,2CAwE/B"}
+{"version":3,"file":"editor_context_keys_section.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_context_keys_section.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAU7D,UAAU,6BAA6B;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,gBAAgB,EAAE,CAAC;IACnC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;CACnD;AAwMD,wBAAgB,wBAAwB,CAAC,EACvC,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,KAAK,EACL,QAAQ,EACR,YAAY,GACb,EAAE,6BAA6B,qBAwE/B"}

package/dist/components/editor/editor_form.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { IhelpTopic, IhelpTopicInput, IhelpTagInput, ContextKeyOption } from '../../types/index.js';
 interface EditorFormProps {
     form: IhelpTopicInput;
@@ -22,6 +23,6 @@ interface EditorFormProps {
     upload_url?: string;
     scope_id?: string | null;
 }
-export declare function EditorForm({ form, form_tags, form_context_keys, is_new, saving, save_error, selected_id, topics, categories, onUpdateField, onAddTag, onRemoveTag, onAddContextKey, onRemoveContextKey, available_context_keys, available_context_keys_loading, onManageContextKeys, onSave, onDelete, upload_url, scope_id, }: EditorFormProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorForm({ form, form_tags, form_context_keys, is_new, saving, save_error, selected_id, topics, categories, onUpdateField, onAddTag, onRemoveTag, onAddContextKey, onRemoveContextKey, available_context_keys, available_context_keys_loading, onManageContextKeys, onSave, onDelete, upload_url, scope_id, }: EditorFormProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_form.d.ts.map

package/dist/components/editor/editor_form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_form.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_form.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAazG,UAAU,eAAe;IACvB,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC5F,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;IAC3C,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IACzD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,UAAU,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,eAAe,2CAkNjB"}
+{"version":3,"file":"editor_form.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_form.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAazG,UAAU,eAAe;IACvB,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,CAAC,CAAC,SAAS,MAAM,eAAe,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IAC5F,QAAQ,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,sBAAsB,EAAE,gBAAgB,EAAE,CAAC;IAC3C,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,IAAI,CAAC;IACzD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,MAAM,EACN,UAAU,EACV,WAAW,EACX,MAAM,EACN,UAAU,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,8BAA8B,EAC9B,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,EAAE,eAAe,qBAkNjB"}

package/dist/components/editor/editor_import_export.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { IhelpTopic, IhelpTopicInput } from '../../types/index.js';
 export declare function use_export_topics(topics: IhelpTopic[]): () => void;
 interface ImportDialogProps {
@@ -6,11 +7,11 @@ interface ImportDialogProps {
     create_topic: (input: IhelpTopicInput) => Promise<IhelpTopic>;
     refetch: () => void;
 }
-export declare function ImportDialog({ open, onOpenChange, create_topic, refetch, }: ImportDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function ImportDialog({ open, onOpenChange, create_topic, refetch, }: ImportDialogProps): React.JSX.Element;
 interface ImportExportMenuProps {
     onExport: () => void;
     onImport: () => void;
 }
-export declare function ImportExportButtons({ onExport, onImport }: ImportExportMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function ImportExportButtons({ onExport, onImport }: ImportExportMenuProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_import_export.d.ts.map

package/dist/components/editor/editor_import_export.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_import_export.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_import_export.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAiB,MAAM,sBAAsB,CAAC;AAkCvF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,cAYrD;AAMD,UAAU,iBAAiB;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,EAAE,iBAAiB,2CAiJnB;AAMD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,2CAqBhF"}
+{"version":3,"file":"editor_import_export.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_import_export.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAiB,MAAM,sBAAsB,CAAC;AAkCvF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,cAYrD;AAMD,UAAU,iBAAiB;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC,YAAY,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,OAAO,GACR,EAAE,iBAAiB,qBAiJnB;AAMD,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,qBAAqB,qBAqBhF"}

package/dist/components/editor/editor_tags_section.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { IhelpTagInput } from '../../types/index.js';
 interface EditorTagsSectionProps {
     tags: IhelpTagInput[];
@@ -5,6 +6,6 @@ interface EditorTagsSectionProps {
     onAdd: (tag: IhelpTagInput) => void;
     onRemove: (index: number) => void;
 }
-export declare function EditorTagsSection({ tags, defaultOpen, onAdd, onRemove }: EditorTagsSectionProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorTagsSection({ tags, defaultOpen, onAdd, onRemove }: EditorTagsSectionProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_tags_section.d.ts.map

package/dist/components/editor/editor_tags_section.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_tags_section.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_tags_section.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,UAAU,sBAAsB;IAC9B,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,sBAAsB,2CAsF/F"}
+{"version":3,"file":"editor_tags_section.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_tags_section.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAO1D,UAAU,sBAAsB;IAC9B,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,sBAAsB,qBAsF/F"}

package/dist/components/editor/editor_topic_list.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { IhelpTopic } from '../../types/index.js';
 interface EditorTopicListProps {
     topics: IhelpTopic[];
@@ -11,6 +12,6 @@ interface EditorTopicListProps {
     onDeleteSelected: () => void;
     onDeleteAll: () => void;
 }
-export declare function EditorTopicList({ topics, loading, error, selected_id, onSelect, onNew, onExport, onImport, onDeleteSelected, onDeleteAll, }: EditorTopicListProps): import("react/jsx-runtime").JSX.Element;
+export declare function EditorTopicList({ topics, loading, error, selected_id, onSelect, onNew, onExport, onImport, onDeleteSelected, onDeleteAll, }: EditorTopicListProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_topic_list.d.ts.map

package/dist/components/editor/editor_topic_list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_topic_list.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_topic_list.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOvD,UAAU,oBAAoB;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,OAAO,EACP,KAAK,EACL,WAAW,EACX,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,WAAW,GACZ,EAAE,oBAAoB,2CA8JtB"}
+{"version":3,"file":"editor_topic_list.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_topic_list.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAOvD,UAAU,oBAAoB;IAC5B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,gBAAgB,EAAE,MAAM,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,OAAO,EACP,KAAK,EACL,WAAW,EACX,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,WAAW,GACZ,EAAE,oBAAoB,qBA8JtB"}

package/dist/components/editor/editor_topic_list_item.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { IhelpTopic } from '../../types/index.js';
 interface TopicListItemProps {
     topic: IhelpTopic;
@@ -5,6 +6,6 @@ interface TopicListItemProps {
     selected: boolean;
     onSelect: (id: string) => void;
 }
-export declare function TopicListItem({ topic, depth, selected, onSelect }: TopicListItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function TopicListItem({ topic, depth, selected, onSelect }: TopicListItemProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=editor_topic_list_item.d.ts.map

package/dist/components/editor/editor_topic_list_item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor_topic_list_item.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_topic_list_item.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,UAAU,kBAAkB;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB,2CAuBrF"}
+{"version":3,"file":"editor_topic_list_item.d.ts","sourceRoot":"","sources":["../../../src/components/editor/editor_topic_list_item.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,UAAU,kBAAkB;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC;AAED,wBAAgB,aAAa,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,kBAAkB,qBAuBrF"}

package/dist/components/hover_help_icon.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from "react";
+import React, { type ReactNode } from "react";
 export interface HoverHelpIconProps {
     /** Heading shown at the top of the hover card. Plain text. */
     title: string;
@@ -18,6 +18,15 @@ export interface HoverHelpIconProps {
     className?: string;
     /** Optional extra className for the hover card container. */
     content_className?: string;
+    /**
+     * Optional callback wired to a "More" link rendered at the foot of the
+     * hover card. Use it to escalate from the short inline blurb to fuller
+     * help — e.g. opening the `IhelpProvider` search dialog for a context key.
+     * When omitted, no "More" link is shown.
+     */
+    on_more?: () => void;
+    /** Label for the optional "More" link. Default "More". */
+    more_label?: string;
 }
 /**
  * Standalone "?" icon that opens a Radix HoverCard with a titled help body.
@@ -35,5 +44,5 @@ export interface HoverHelpIconProps {
  * For topic-store-backed help (full rich content, search, editor), keep
  * using `IhelpIcon` which delegates to the provider's `open_search`.
  */
-export declare function HoverHelpIcon({ title, body, aria_label, size, side, className, content_className, }: HoverHelpIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function HoverHelpIcon({ title, body, aria_label, size, side, className, content_className, on_more, more_label, }: HoverHelpIconProps): React.JSX.Element;
 //# sourceMappingURL=hover_help_icon.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"hover_help_icon.d.ts","sourceRoot":"","sources":["../../src/components/hover_help_icon.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKxD,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,UAAU,EACV,IAAS,EACT,IAAY,EACZ,SAAS,EACT,iBAAiB,GAClB,EAAE,kBAAkB,2CAkDpB"}
+{"version":3,"file":"hover_help_icon.d.ts","sourceRoot":"","sources":["../../src/components/hover_help_icon.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKxD,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,SAAS,CAAC;IAChB,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,UAAU,EACV,IAAS,EACT,IAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,UAAmB,GACpB,EAAE,kBAAkB,qBAmEpB"}

package/dist/components/hover_help_icon.js

@@ -2,7 +2,7 @@
 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 } from "lucide-react";
+import { HelpCircle, ArrowRight } from "lucide-react";
 import { cn } from 'hazo_ui';
 /**
  * Standalone "?" icon that opens a Radix HoverCard with a titled help body.
@@ -20,10 +20,13 @@ import { cn } from 'hazo_ui';
  * For topic-store-backed help (full rich content, search, editor), keep
  * using `IhelpIcon` which delegates to the provider's `open_search`.
  */
-export function HoverHelpIcon({ title, body, aria_label, size = 14, side = "top", className, content_className, }) {
+export function HoverHelpIcon({ title, body, aria_label, size = 14, side = "top", className, content_className, on_more, more_label = "More", }) {
     // HoverCard ignores touch events by design (Radix decision: hover semantics
     // are pointer-only). Pair it with a click toggle so taps still open it.
     const [tap_open, set_tap_open] = useState(false);
-    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", content_className), children: [_jsx("p", { className: "mb-2 text-sm font-semibold text-slate-900", children: title }), typeof body === "string" ? (_jsx("div", { className: "whitespace-pre-line", children: body })) : (body), _jsx(HoverCard.Arrow, { className: "fill-white" })] }) })] }));
+    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", content_className), children: [_jsx("p", { className: "mb-2 text-sm font-semibold text-slate-900", children: title }), typeof body === "string" ? (_jsx("div", { className: "whitespace-pre-line", children: body })) : (body), on_more && (_jsxs("button", { type: "button", onClick: () => {
+                                set_tap_open(false);
+                                on_more();
+                            }, 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: [more_label, _jsx(ArrowRight, { size: 12, "aria-hidden": true })] })), _jsx(HoverCard.Arrow, { className: "fill-white" })] }) })] }));
 }
 //# sourceMappingURL=hover_help_icon.js.map

package/dist/components/hover_help_icon.js.map

@@ -1 +1 @@
-{"version":3,"file":"hover_help_icon.js","sourceRoot":"","sources":["../../src/components/hover_help_icon.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAuB7B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,UAAU,EACV,IAAI,GAAG,EAAE,EACT,IAAI,GAAG,KAAK,EACZ,SAAS,EACT,iBAAiB,GACE;IACnB,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEjD,OAAO,CACL,MAAC,SAAS,CAAC,IAAI,IACb,SAAS,EAAE,GAAG,EACd,UAAU,EAAE,GAAG,EACf,IAAI,EAAE,QAAQ,IAAI,SAAS,EAC3B,YAAY,EAAE,YAAY,aAE1B,KAAC,SAAS,CAAC,OAAO,IAAC,OAAO,kBACxB,iBACE,IAAI,EAAC,QAAQ,gBACD,UAAU,EACtB,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EACtC,SAAS,EAAE,EAAE,CACX,oEAAoE,EACpE,yDAAyD,EACzD,yGAAyG,EACzG,SAAS,CACV,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,YAE5C,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,wBAAgB,GAC/B,GACS,EACpB,KAAC,SAAS,CAAC,MAAM,cACf,MAAC,SAAS,CAAC,OAAO,IAChB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,CAAC,EACb,KAAK,EAAC,QAAQ,EACd,SAAS,EAAE,EAAE,CACX,uEAAuE,EACvE,wCAAwC,EACxC,iBAAiB,CAClB,aAED,YAAG,SAAS,EAAC,2CAA2C,YAAE,KAAK,GAAK,EACnE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC1B,cAAK,SAAS,EAAC,qBAAqB,YAAE,IAAI,GAAO,CAClD,CAAC,CAAC,CAAC,CACF,IAAI,CACL,EACD,KAAC,SAAS,CAAC,KAAK,IAAC,SAAS,EAAC,YAAY,GAAG,IACxB,GACH,IACJ,CAClB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"hover_help_icon.js","sourceRoot":"","sources":["../../src/components/hover_help_icon.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAc,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAgC7B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,UAAU,EACV,IAAI,GAAG,EAAE,EACT,IAAI,GAAG,KAAK,EACZ,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,UAAU,GAAG,MAAM,GACA;IACnB,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEjD,OAAO,CACL,MAAC,SAAS,CAAC,IAAI,IACb,SAAS,EAAE,GAAG,EACd,UAAU,EAAE,GAAG,EACf,IAAI,EAAE,QAAQ,IAAI,SAAS,EAC3B,YAAY,EAAE,YAAY,aAE1B,KAAC,SAAS,CAAC,OAAO,IAAC,OAAO,kBACxB,iBACE,IAAI,EAAC,QAAQ,gBACD,UAAU,EACtB,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EACtC,SAAS,EAAE,EAAE,CACX,oEAAoE,EACpE,yDAAyD,EACzD,yGAAyG,EACzG,SAAS,CACV,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,CAAC,EAAE,YAE5C,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,wBAAgB,GAC/B,GACS,EACpB,KAAC,SAAS,CAAC,MAAM,cACf,MAAC,SAAS,CAAC,OAAO,IAChB,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,CAAC,EACb,KAAK,EAAC,QAAQ,EACd,SAAS,EAAE,EAAE,CACX,uEAAuE,EACvE,wCAAwC,EACxC,iBAAiB,CAClB,aAED,YAAG,SAAS,EAAC,2CAA2C,YAAE,KAAK,GAAK,EACnE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAC1B,cAAK,SAAS,EAAC,qBAAqB,YAAE,IAAI,GAAO,CAClD,CAAC,CAAC,CAAC,CACF,IAAI,CACL,EACA,OAAO,IAAI,CACV,kBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,GAAG,EAAE;gCACZ,YAAY,CAAC,KAAK,CAAC,CAAC;gCACpB,OAAO,EAAE,CAAC;4BACZ,CAAC,EACD,SAAS,EAAE,EAAE,CACX,yEAAyE,EACzE,qCAAqC,EACrC,iHAAiH,CAClH,aAEA,UAAU,EACX,KAAC,UAAU,IAAC,IAAI,EAAE,EAAE,wBAAgB,IAC7B,CACV,EACD,KAAC,SAAS,CAAC,KAAK,IAAC,SAAS,EAAC,YAAY,GAAG,IACxB,GACH,IACJ,CAClB,CAAC;AACJ,CAAC"}

package/dist/components/ihelp_detail_panel.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { IhelpDetailPanelProps, IhelpLabels } from '../types/index.js';
 /**
  * Rich detail view for a single help topic.
@@ -12,5 +13,5 @@ export declare function IhelpDetailPanel({ topic, onNavigate, className, asset_b
     asset_base_url?: string;
     provider_scope_id?: string | null;
     labels?: Partial<IhelpLabels>;
-}): import("react/jsx-runtime").JSX.Element;
+}): React.JSX.Element;
 //# sourceMappingURL=ihelp_detail_panel.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_detail_panel.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_detail_panel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAgCxF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,MAAM,GACP,EAAE,qBAAqB,GAAG;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B,2CAiFA"}
+{"version":3,"file":"ihelp_detail_panel.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_detail_panel.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAgCxF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,UAAU,EACV,SAAS,EACT,cAAc,EACd,iBAAiB,EACjB,MAAM,GACP,EAAE,qBAAqB,GAAG;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC/B,qBAiFA"}

package/dist/components/ihelp_editor.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 import type { IhelpEditorProps } from '../types/index.js';
-export declare function IhelpEditor({ scope_id, className, api_url, upload_url, config_api_url }: IhelpEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare function IhelpEditor({ scope_id, className, api_url, upload_url, config_api_url }: IhelpEditorProps): React.JSX.Element;
 //# sourceMappingURL=ihelp_editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_editor.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_editor.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAgE,MAAM,mBAAmB,CAAC;AAkDxH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,gBAAgB,2CA0OzG"}
+{"version":3,"file":"ihelp_editor.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_editor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,gBAAgB,EAAgE,MAAM,mBAAmB,CAAC;AAkDxH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,gBAAgB,qBA0OzG"}

package/dist/components/ihelp_field_help.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from "react";
+import React, { type ReactNode } from "react";
 export interface IhelpFieldHelpProps {
     /** Field name/label — used as the hover card title. */
     title: string;
@@ -10,6 +10,17 @@ export interface IhelpFieldHelpProps {
     side?: "top" | "right" | "bottom" | "left";
     /** Extra className for the trigger button. */
     className?: string;
+    /**
+     * When set, the hover card shows a "More" link that opens the
+     * `IhelpProvider` search dialog scoped to this context key — escalating
+     * from the short inline blurb to the full topic-store help.
+     *
+     * Requires an ancestor `<IhelpProvider>`; if none is present the "More"
+     * link is omitted (the hover blurb still renders).
+     */
+    more_context_key?: string;
+    /** Label for the "More" link. Default "More". */
+    more_label?: string;
 }
 /**
  * Inline help icon for form field labels.
@@ -17,11 +28,22 @@ export interface IhelpFieldHelpProps {
  * Thin wrapper over HoverHelpIcon with defaults tuned for the field-label
  * context: smaller icon, aria_label auto-derived from title.
  *
+ * Pass `more_context_key` to add a "More" link in the hover card that opens
+ * the provider's search dialog for richer, topic-store-backed help.
+ *
  * @example
  * <label className="flex items-center gap-1">
  *   Tax File Number
  *   <IhelpFieldHelp title="Tax File Number" body="Your 9-digit TFN issued by the ATO." />
  * </label>
+ *
+ * @example
+ * // Escalate to the full help dialog on "More"
+ * <IhelpFieldHelp
+ *   title="Sponsorship"
+ *   body="CHESS vs custodial in one line."
+ *   more_context_key="broker.sponsorship"
+ * />
  */
-export declare function IhelpFieldHelp({ title, body, size, side, className, }: IhelpFieldHelpProps): import("react/jsx-runtime").JSX.Element;
+export declare function IhelpFieldHelp({ title, body, size, side, className, more_context_key, more_label, }: IhelpFieldHelpProps): React.JSX.Element;
 //# sourceMappingURL=ihelp_field_help.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_field_help.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_field_help.tsx"],"names":[],"mappings":"AAEA,OAAc,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAG9C,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,EAAE,SAAS,CAAC;IAChB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,IAAS,EACT,IAAY,EACZ,SAAS,GACV,EAAE,mBAAmB,2CAWrB"}
+{"version":3,"file":"ihelp_field_help.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_field_help.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAI9C,MAAM,WAAW,mBAAmB;IAClC,uDAAuD;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,EAAE,SAAS,CAAC;IAChB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,IAAI,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC3C,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,IAAS,EACT,IAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,UAAU,GACX,EAAE,mBAAmB,qBAmBrB"}

package/dist/components/ihelp_field_help.js

@@ -1,19 +1,35 @@
 "use client";
 import { jsx as _jsx } from "react/jsx-runtime";
 import { HoverHelpIcon } from "./hover_help_icon.js";
+import { useIhelpContextOptional } from "./ihelp_provider.js";
 /**
  * Inline help icon for form field labels.
  *
  * Thin wrapper over HoverHelpIcon with defaults tuned for the field-label
  * context: smaller icon, aria_label auto-derived from title.
  *
+ * Pass `more_context_key` to add a "More" link in the hover card that opens
+ * the provider's search dialog for richer, topic-store-backed help.
+ *
  * @example
  * <label className="flex items-center gap-1">
  *   Tax File Number
  *   <IhelpFieldHelp title="Tax File Number" body="Your 9-digit TFN issued by the ATO." />
  * </label>
+ *
+ * @example
+ * // Escalate to the full help dialog on "More"
+ * <IhelpFieldHelp
+ *   title="Sponsorship"
+ *   body="CHESS vs custodial in one line."
+ *   more_context_key="broker.sponsorship"
+ * />
  */
-export function IhelpFieldHelp({ title, body, size = 13, side = "top", className, }) {
-    return (_jsx(HoverHelpIcon, { title: title, body: body, aria_label: `Help for ${title}`, size: size, side: side, className: className }));
+export function IhelpFieldHelp({ title, body, size = 13, side = "top", className, more_context_key, more_label, }) {
+    const ctx = useIhelpContextOptional();
+    const on_more = more_context_key && ctx
+        ? () => ctx.open_search(more_context_key)
+        : undefined;
+    return (_jsx(HoverHelpIcon, { title: title, body: body, aria_label: `Help for ${title}`, size: size, side: side, className: className, on_more: on_more, more_label: more_label }));
 }
 //# sourceMappingURL=ihelp_field_help.js.map

package/dist/components/ihelp_field_help.js.map

@@ -1 +1 @@
-{"version":3,"file":"ihelp_field_help.js","sourceRoot":"","sources":["../../src/components/ihelp_field_help.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAerD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,IAAI,GAAG,EAAE,EACT,IAAI,GAAG,KAAK,EACZ,SAAS,GACW;IACpB,OAAO,CACL,KAAC,aAAa,IACZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,YAAY,KAAK,EAAE,EAC/B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,GACpB,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ihelp_field_help.js","sourceRoot":"","sources":["../../src/components/ihelp_field_help.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AA0B9D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,IAAI,GAAG,EAAE,EACT,IAAI,GAAG,KAAK,EACZ,SAAS,EACT,gBAAgB,EAChB,UAAU,GACU;IACpB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;IACtC,MAAM,OAAO,GACX,gBAAgB,IAAI,GAAG;QACrB,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,gBAAgB,CAAC;QACzC,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,CACL,KAAC,aAAa,IACZ,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,YAAY,KAAK,EAAE,EAC/B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,GACtB,CACH,CAAC;AACJ,CAAC"}

package/dist/components/ihelp_icon.d.ts

@@ -1,7 +1,8 @@
+import React from 'react';
 import type { IhelpIconProps } from '../types/index.js';
 /**
  * Small blue "i" icon that opens the help search dialog scoped to the
  * given context_key.
  */
-export declare function IhelpIcon({ context_key, size, className }: IhelpIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IhelpIcon({ context_key, size, className }: IhelpIconProps): React.JSX.Element;
 //# sourceMappingURL=ihelp_icon.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_icon.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_icon.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,WAAW,EAAE,IAAS,EAAE,SAAS,EAAE,EAAE,cAAc,2CAmB9E"}
+{"version":3,"file":"ihelp_icon.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_icon.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EAAE,WAAW,EAAE,IAAS,EAAE,SAAS,EAAE,EAAE,cAAc,qBAmB9E"}

package/dist/components/ihelp_provider.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { IhelpProviderProps, IhelpTheme, IhelpLabels, UseIhelpSearchResult } from '../types/index.js';
 interface IhelpContextValue {
     api_base_url: string;
@@ -16,6 +17,15 @@ interface IhelpContextValue {
  * Hook to consume the ihelp context. Must be called inside <IhelpProvider>.
  */
 export declare function useIhelpContext(): IhelpContextValue;
-export declare function IhelpProvider({ children, api_base_url, scope_id, search_shortcut, enable_shortcuts, asset_base_url, theme, labels, }: IhelpProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Non-throwing variant of {@link useIhelpContext}. Returns `null` when called
+ * outside an `<IhelpProvider>` instead of throwing.
+ *
+ * Used by provider-optional components (e.g. `HoverHelpIcon` / `IhelpFieldHelp`)
+ * that want to wire a "More" affordance to the search dialog when a provider is
+ * present, while still rendering correctly when one is not.
+ */
+export declare function useIhelpContextOptional(): IhelpContextValue | null;
+export declare function IhelpProvider({ children, api_base_url, scope_id, search_shortcut, enable_shortcuts, asset_base_url, theme, labels, }: IhelpProviderProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=ihelp_provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_provider.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_provider.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAQ3G,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAID;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAUnD;AAMD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAA2B,EAC3B,QAAQ,EACR,eAAyB,EACzB,gBAAuB,EACvB,cAAc,EACd,KAAK,EACL,MAAM,GACP,EAAE,kBAAkB,2CAgFpB"}
+{"version":3,"file":"ihelp_provider.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAsE,MAAM,OAAO,CAAC;AAE3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAQ3G,UAAU,iBAAiB;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACpC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,uEAAuE;IACvE,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAID;;GAEG;AACH,wBAAgB,eAAe,IAAI,iBAAiB,CAUnD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,IAAI,CAElE;AAMD,wBAAgB,aAAa,CAAC,EAC5B,QAAQ,EACR,YAA2B,EAC3B,QAAQ,EACR,eAAyB,EACzB,gBAAuB,EACvB,cAAc,EACd,KAAK,EACL,MAAM,GACP,EAAE,kBAAkB,qBAgFpB"}

package/dist/components/ihelp_provider.js

@@ -19,6 +19,17 @@ export function useIhelpContext() {
     }
     return ctx;
 }
+/**
+ * Non-throwing variant of {@link useIhelpContext}. Returns `null` when called
+ * outside an `<IhelpProvider>` instead of throwing.
+ *
+ * Used by provider-optional components (e.g. `HoverHelpIcon` / `IhelpFieldHelp`)
+ * that want to wire a "More" affordance to the search dialog when a provider is
+ * present, while still rendering correctly when one is not.
+ */
+export function useIhelpContextOptional() {
+    return useContext(IhelpContext);
+}
 // ---------------------------------------------------------------------------
 // Provider
 // ---------------------------------------------------------------------------

package/dist/components/ihelp_provider.js.map

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

package/dist/components/ihelp_rich_editor.d.ts

@@ -1,3 +1,4 @@
+import * as React from 'react';
 interface IhelpRichEditorProps {
     /** HTML string to display / edit. */
     content: string;
@@ -10,6 +11,6 @@ interface IhelpRichEditorProps {
     /** Scope ID passed to upload endpoint for multi-tenant storage. */
     scope_id?: string;
 }
-export declare function IhelpRichEditor({ content, onChange, className, placeholder, upload_url, scope_id, }: IhelpRichEditorProps): import("react/jsx-runtime").JSX.Element;
+export declare function IhelpRichEditor({ content, onChange, className, placeholder, upload_url, scope_id, }: IhelpRichEditorProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=ihelp_rich_editor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_rich_editor.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_rich_editor.tsx"],"names":[],"mappings":"AAkBA,UAAU,oBAAoB;IAC5B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyMD,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAQ,GACT,EAAE,oBAAoB,2CAwItB"}
+{"version":3,"file":"ihelp_rich_editor.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_rich_editor.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAgB/B,UAAU,oBAAoB;IAC5B,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAyMD,wBAAgB,eAAe,CAAC,EAC9B,OAAO,EACP,QAAQ,EACR,SAAS,EACT,WAAW,EACX,UAAU,EACV,QAAQ,GACT,EAAE,oBAAoB,qBAwItB"}

package/dist/components/ihelp_search_dialog.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import type { IhelpSearchDialogProps } from '../types/index.js';
-export declare function IhelpSearchDialog({ open, onOpenChange, initial_context_key, className, }: IhelpSearchDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function IhelpSearchDialog({ open, onOpenChange, initial_context_key, className, }: IhelpSearchDialogProps): React.JSX.Element;
 //# sourceMappingURL=ihelp_search_dialog.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ihelp_search_dialog.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_search_dialog.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,sBAAsB,EAAsD,MAAM,mBAAmB,CAAC;AAgwBpH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,mBAAmB,EACnB,SAAS,GACV,EAAE,sBAAsB,2CAoKxB"}
+{"version":3,"file":"ihelp_search_dialog.d.ts","sourceRoot":"","sources":["../../src/components/ihelp_search_dialog.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAazE,OAAO,KAAK,EAAE,sBAAsB,EAAsD,MAAM,mBAAmB,CAAC;AAgwBpH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,EACZ,mBAAmB,EACnB,SAAS,GACV,EAAE,sBAAsB,qBAoKxB"}

package/dist/components/index.d.ts

@@ -1,4 +1,4 @@
-export { IhelpProvider, useIhelpContext } from './ihelp_provider.js';
+export { IhelpProvider, useIhelpContext, useIhelpContextOptional } from './ihelp_provider.js';
 export { IhelpIcon } from './ihelp_icon.js';
 export { HoverHelpIcon, type HoverHelpIconProps } from './hover_help_icon.js';
 export { IhelpDetailPanel } from './ihelp_detail_panel.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, 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,MAAM,qBAAqB,CAAC;AACrE,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

@@ -1,4 +1,4 @@
-export { IhelpProvider, useIhelpContext } from './ihelp_provider.js';
+export { IhelpProvider, useIhelpContext, useIhelpContextOptional } from './ihelp_provider.js';
 export { IhelpIcon } from './ihelp_icon.js';
 export { HoverHelpIcon } from './hover_help_icon.js';
 export { IhelpDetailPanel } from './ihelp_detail_panel.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,MAAM,qBAAqB,CAAC;AACrE,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/components/ui/dialog.d.ts

@@ -7,11 +7,11 @@ declare const DialogClose: React.ForwardRefExoticComponent<DialogPrimitive.Dialo
 declare const DialogOverlay: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const DialogContent: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
-    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
     displayName: string;
 };
 declare const DialogFooter: {
-    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
+    ({ className, ...props }: React.HTMLAttributes<HTMLDivElement>): React.JSX.Element;
     displayName: string;
 };
 declare const DialogTitle: React.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React.RefAttributes<HTMLHeadingElement>, "ref"> & React.RefAttributes<HTMLHeadingElement>>;

package/dist/index.runtime.d.ts

@@ -0,0 +1,24 @@
+/**
+ * hazo_ihelp — Lean runtime entry
+ *
+ * The browser-facing help *consumption* surface WITHOUT the authoring editor.
+ * Importing from here pulls in the provider, search dialog, detail panel, and
+ * the inline help icons — but NOT `IhelpEditor` / `IhelpRichEditor`, so the
+ * heavy Tiptap / dnd-kit editor graph never reaches a consumer that only needs
+ * to *show* help.
+ *
+ * Use the main `hazo_ihelp` entry instead when you need the editor.
+ *
+ * @packageDocumentation
+ */
+export { IhelpProvider, useIhelpContext, useIhelpContextOptional, } from './components/ihelp_provider.js';
+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';
+export type { IhelpTopic, IhelpTag, IhelpContext, IhelpTopicInput, IhelpApiResponse, IhelpProviderProps, IhelpIconProps, IhelpSearchDialogProps, IhelpDetailPanelProps, IhelpTheme, IhelpLabels, UseIhelpResult, UseIhelpSearchResult, } from './types/index.js';
+export { cn } from 'hazo_ui';
+//# sourceMappingURL=index.runtime.d.ts.map

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

@@ -0,0 +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,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

@@ -0,0 +1,25 @@
+/**
+ * hazo_ihelp — Lean runtime entry
+ *
+ * The browser-facing help *consumption* surface WITHOUT the authoring editor.
+ * Importing from here pulls in the provider, search dialog, detail panel, and
+ * the inline help icons — but NOT `IhelpEditor` / `IhelpRichEditor`, so the
+ * heavy Tiptap / dnd-kit editor graph never reaches a consumer that only needs
+ * to *show* help.
+ *
+ * Use the main `hazo_ihelp` entry instead when you need the editor.
+ *
+ * @packageDocumentation
+ */
+export { IhelpProvider, useIhelpContext, useIhelpContextOptional, } from './components/ihelp_provider.js';
+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)
+export * from './hooks/index.js';
+// Utils
+export { cn } from 'hazo_ui';
+//# sourceMappingURL=index.runtime.js.map

package/dist/index.runtime.js.map

@@ -0,0 +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,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.2.0",
+  "version": "2.4.0",
   "type": "module",
   "main": "./dist/index.client.js",
   "module": "./dist/index.client.js",
@@ -10,6 +10,10 @@
       "types": "./dist/index.client.d.ts",
       "import": "./dist/index.client.js"
     },
+    "./runtime": {
+      "types": "./dist/index.runtime.d.ts",
+      "import": "./dist/index.runtime.js"
+    },
     "./api": {
       "types": "./dist/api/index.d.ts",
       "import": "./dist/api/index.js"
@@ -80,16 +84,17 @@
     "zod": "^4.1.12"
   },
   "peerDependencies": {
-    "hazo_auth": "^10.2.0",
+    "hazo_auth": "^10.9.0",
     "hazo_chat": "^6.0.0",
-    "hazo_config": "^2.1.11",
-    "hazo_connect": "^3.7.0",
-    "hazo_core": "^1.2.0",
-    "hazo_files": "^3.1.0",
+    "hazo_config": "^2.4.1",
+    "hazo_connect": "^3.9.2",
+    "hazo_core": "^1.2.1",
+    "hazo_files": "^3.1.1",
     "hazo_llm_api": "^2.1.0",
-    "hazo_logs": "^2.0.3",
+    "hazo_logs": "^2.1.1",
     "hazo_notes": "^2.0.0",
-    "hazo_ui": "^4.0.0",
+    "hazo_theme": "^1.0.1",
+    "hazo_ui": "^6.1.0",
     "next": "^14.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
@@ -131,22 +136,25 @@
     },
     "sharp": {
       "optional": true
+    },
+    "hazo_theme": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@types/node": "^20.14.10",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
-    "hazo_auth": "^10.2.2",
+    "hazo_auth": "^10.9.0",
     "hazo_chat": "^6.0.0",
-    "hazo_config": "^2.1.11",
-    "hazo_connect": "^3.7.0",
-    "hazo_core": "^1.2.0",
-    "hazo_files": "^3.1.0",
+    "hazo_config": "^2.4.1",
+    "hazo_connect": "^3.9.2",
+    "hazo_core": "^1.2.1",
+    "hazo_files": "^3.1.1",
     "hazo_llm_api": "^2.1.0",
-    "hazo_logs": "^2.0.3",
+    "hazo_logs": "^2.1.1",
     "hazo_notes": "^2.0.0",
-    "hazo_ui": "^4.2.0",
+    "hazo_ui": "^6.1.0",
     "next": "^16.0.10",
     "typescript": "^5.7.2"
   },