hazo_ihelp 2.1.0 → 2.2.0

package/README.md

@@ -14,10 +14,19 @@ npm install hazo_ihelp
 |---------|----------|-------|
 | `react` | ^18 or ^19 | Required |
 | `react-dom` | ^18 or ^19 | Required |
-| `tailwindcss` | >=3.0.0 | Required for styling |
+| `tailwindcss` | ^4.2.4 | Required for styling |
 | `@tailwindcss/typography` | >=0.5.0 | Required — `prose` classes for rich content rendering |
-| `next` | >=14.0.0 | Optional — needed for API handlers |
-| `hazo_connect` | >=2.4.0 | Optional — needed for API handlers |
+| `hazo_core` | ^1.0.0 | Required — error classes, correlation IDs, config/logger |
+| `hazo_ui` | ^3.1.3 | 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_chat` | ^6.0.0 | Optional |
+| `hazo_files` | ^3.0.0 | Optional — image upload handling |
+| `hazo_llm_api` | ^2.0.0 | Optional |
+| `hazo_notes` | ^2.0.0 | Optional |
 
 ## Tailwind v4 Setup (Required)
 
@@ -60,15 +69,14 @@ Tailwind v4 auto-detects installed plugins. For Tailwind v3, add it to your `tai
 Execute the SQL migration to create the required tables:
 
 ```bash
-# The migration file is included in the package
-cat node_modules/hazo_ihelp/migrations/001_create_ihelp_tables.sql
+# The schema setup files are included in the package
+cat node_modules/hazo_ihelp/db_setup_postgres.sql   # PostgreSQL
+cat node_modules/hazo_ihelp/db_setup_sqlite.sql      # SQLite
 ```
 
-This creates two tables:
-- `hazo_ihelp_topics` — help topics with tags and context mappings stored as JSON columns
-- `hazo_config` — key-value configuration store (scoped)
+This creates the `hazo_ihelp_topics` table — help topics with tags and context mappings stored as JSON columns. (The shared `hazo_config` table is owned by `hazo_config` and is not created here.)
 
-The migration file documents both **SQLite** and **PostgreSQL** variants:
+The setup files document both **SQLite** and **PostgreSQL** variants:
 
 | Column | SQLite | PostgreSQL |
 |--------|--------|------------|
@@ -171,6 +179,24 @@ Context provider that supplies topics, search, and keyboard shortcuts to all chi
 </IhelpProvider>
 ```
 
+### IhelpFieldHelp
+
+Inline help icon designed for use inside form field labels. Thin wrapper over `HoverHelpIcon` with defaults tuned for the field-label context: smaller icon (13 px), `aria_label` auto-derived from `title`.
+
+```tsx
+import { IhelpFieldHelp } from 'hazo_ihelp';
+
+<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>
+```
+
+Props: `title` (string), `body` (string or ReactNode), `size` (default 13), `side` (`"top"` | `"right"` | `"bottom"` | `"left"`, default `"top"`), `className`.
+
 ### IhelpIcon
 
 Small trigger button that opens the Help dialog for a specific context key.
@@ -208,7 +234,7 @@ Full CRUD editor for managing help topics (tags and context mappings are embedde
 
 | Import path | Contents |
 |-------------|----------|
-| `hazo_ihelp` | Client components: `IhelpProvider`, `IhelpIcon`, `IhelpSearchDialog`, `IhelpDetailPanel` |
+| `hazo_ihelp` | Client components: `IhelpProvider`, `IhelpIcon`, `IhelpFieldHelp`, `IhelpSearchDialog`, `IhelpDetailPanel` |
 | `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/ihelp_field_help.d.ts

@@ -0,0 +1,27 @@
+import { type ReactNode } from "react";
+export interface IhelpFieldHelpProps {
+    /** Field name/label — used as the hover card title. */
+    title: string;
+    /** Help body. String (multi-line supported) or ReactNode for rich content. */
+    body: ReactNode;
+    /** Icon size in px. Default 13. */
+    size?: number;
+    /** Hover card side. Default "top". */
+    side?: "top" | "right" | "bottom" | "left";
+    /** Extra className for the trigger button. */
+    className?: string;
+}
+/**
+ * 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.
+ *
+ * @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>
+ */
+export declare function IhelpFieldHelp({ title, body, size, side, className, }: IhelpFieldHelpProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ihelp_field_help.d.ts.map

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

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

package/dist/components/ihelp_field_help.js

@@ -0,0 +1,19 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { HoverHelpIcon } from "./hover_help_icon.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.
+ *
+ * @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>
+ */
+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 }));
+}
+//# sourceMappingURL=ihelp_field_help.js.map

package/dist/components/ihelp_field_help.js.map

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

package/dist/components/index.d.ts

@@ -5,4 +5,5 @@ export { IhelpDetailPanel } from './ihelp_detail_panel.js';
 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';
 //# 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"}
+{"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"}

package/dist/components/index.js

@@ -5,4 +5,5 @@ export { IhelpDetailPanel } from './ihelp_detail_panel.js';
 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';
 //# 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"}
+{"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"}

package/dist/lib/config/hazo_ihelp_config.d.ts

@@ -19,20 +19,10 @@ declare const schema: z.ZodNullable<z.ZodObject<{
     general: z.ZodOptional<z.ZodObject<{
         env: z.ZodOptional<z.ZodString>;
         api_base_url: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        api_base_url?: string | undefined;
-        env?: string | undefined;
-    }, {
-        api_base_url?: string | undefined;
-        env?: string | undefined;
-    }>>;
+    }, z.core.$strip>>;
     log: z.ZodOptional<z.ZodObject<{
         overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, "strip", z.ZodTypeAny, {
-        overrides?: Record<string, string> | undefined;
-    }, {
-        overrides?: Record<string, string> | undefined;
-    }>>;
+    }, z.core.$strip>>;
     image_upload: z.ZodOptional<z.ZodObject<{
         max_file_size_mb: z.ZodOptional<z.ZodString>;
         allowed_types: z.ZodOptional<z.ZodString>;
@@ -42,62 +32,8 @@ declare const schema: z.ZodNullable<z.ZodObject<{
         resize_max_width: z.ZodOptional<z.ZodString>;
         resize_max_height: z.ZodOptional<z.ZodString>;
         resize_quality: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        max_file_size_mb?: string | undefined;
-        allowed_types?: string | undefined;
-        upload_dir?: string | undefined;
-        upload_url_prefix?: string | undefined;
-        resize_enabled?: string | undefined;
-        resize_max_width?: string | undefined;
-        resize_max_height?: string | undefined;
-        resize_quality?: string | undefined;
-    }, {
-        max_file_size_mb?: string | undefined;
-        allowed_types?: string | undefined;
-        upload_dir?: string | undefined;
-        upload_url_prefix?: string | undefined;
-        resize_enabled?: string | undefined;
-        resize_max_width?: string | undefined;
-        resize_max_height?: string | undefined;
-        resize_quality?: string | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    log?: {
-        overrides?: Record<string, string> | undefined;
-    } | undefined;
-    image_upload?: {
-        max_file_size_mb?: string | undefined;
-        allowed_types?: string | undefined;
-        upload_dir?: string | undefined;
-        upload_url_prefix?: string | undefined;
-        resize_enabled?: string | undefined;
-        resize_max_width?: string | undefined;
-        resize_max_height?: string | undefined;
-        resize_quality?: string | undefined;
-    } | undefined;
-    general?: {
-        api_base_url?: string | undefined;
-        env?: string | undefined;
-    } | undefined;
-}, {
-    log?: {
-        overrides?: Record<string, string> | undefined;
-    } | undefined;
-    image_upload?: {
-        max_file_size_mb?: string | undefined;
-        allowed_types?: string | undefined;
-        upload_dir?: string | undefined;
-        upload_url_prefix?: string | undefined;
-        resize_enabled?: string | undefined;
-        resize_max_width?: string | undefined;
-        resize_max_height?: string | undefined;
-        resize_quality?: string | undefined;
-    } | undefined;
-    general?: {
-        api_base_url?: string | undefined;
-        env?: string | undefined;
-    } | undefined;
-}>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
 export type IhelpStandardConfig = NonNullable<z.infer<typeof schema>>;
 export declare function getIhelpConfig(): IhelpStandardConfig;
 /** Reset the in-memory cache. Mainly for tests. */

package/dist/lib/config/hazo_ihelp_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hazo_ihelp_config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/hazo_ihelp_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BC,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AAItE,wBAAgB,cAAc,IAAI,mBAAmB,CAYpD;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}
+{"version":3,"file":"hazo_ihelp_config.d.ts","sourceRoot":"","sources":["../../../src/lib/config/hazo_ihelp_config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,MAAM;;;;;;;;;;;;;;;;;;kBA0BC,CAAC;AAEd,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,CAAC,CAAC;AAItE,wBAAgB,cAAc,IAAI,mBAAmB,CAYpD;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hazo_ihelp",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "main": "./dist/index.client.js",
   "module": "./dist/index.client.js",
@@ -77,19 +77,19 @@
     "react-resizable-panels": "^4.7.6",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.5.0",
-    "zod": "^3.23.8"
+    "zod": "^4.1.12"
   },
   "peerDependencies": {
-    "hazo_auth": "^9.0.0",
+    "hazo_auth": "^10.2.0",
     "hazo_chat": "^6.0.0",
-    "hazo_config": "^2.1.5",
-    "hazo_connect": "^3.0.0",
-    "hazo_core": "^1.0.0",
-    "hazo_files": "^3.0.0",
-    "hazo_llm_api": "^2.0.0",
-    "hazo_logs": "^2.0.0",
+    "hazo_config": "^2.1.11",
+    "hazo_connect": "^3.7.0",
+    "hazo_core": "^1.2.0",
+    "hazo_files": "^3.1.0",
+    "hazo_llm_api": "^2.1.0",
+    "hazo_logs": "^2.0.3",
     "hazo_notes": "^2.0.0",
-    "hazo_ui": "^3.1.0",
+    "hazo_ui": "^4.0.0",
     "next": "^14.0.0 || ^16.0.0",
     "react": "^18.0.0 || ^19.0.0",
     "react-dom": "^18.0.0 || ^19.0.0",
@@ -137,16 +137,16 @@
     "@types/node": "^20.14.10",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
-    "hazo_auth": "^9.0.0",
+    "hazo_auth": "^10.2.2",
     "hazo_chat": "^6.0.0",
-    "hazo_config": "^2.1.6",
-    "hazo_connect": "^3.0.0",
-    "hazo_core": "^1.0.0",
-    "hazo_files": "^3.0.0",
-    "hazo_llm_api": "^2.0.0",
-    "hazo_logs": "^2.0.1",
+    "hazo_config": "^2.1.11",
+    "hazo_connect": "^3.7.0",
+    "hazo_core": "^1.2.0",
+    "hazo_files": "^3.1.0",
+    "hazo_llm_api": "^2.1.0",
+    "hazo_logs": "^2.0.3",
     "hazo_notes": "^2.0.0",
-    "hazo_ui": "^3.1.0",
+    "hazo_ui": "^4.2.0",
     "next": "^16.0.10",
     "typescript": "^5.7.2"
   },