@alfadocs/ui-kit-debug 1.40.0 → 1.41.1

package/dist/patterns/help-me-write-templates/help-me-write-templates.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Help me write templates (HTP-6383) — practice-shared AI templates inside the
+ * RichTextEditor's "Help me write".
+ *
+ * Runtime pattern: real consuming apps mount this in production (surfaced via
+ * `src/patterns/index.ts` and the `./patterns/help-me-write-templates`
+ * subpath). It plugs into the editor through `renderHelpMeWrite`, so the kit
+ * editor keeps its own AI pill, the patient AI-consent gate and the
+ * resume-after-grant; this pattern supplies the bar that opens from it.
+ *
+ * Parts, usable on their own or wired together by `useHelpMeWriteTemplates`:
+ *  - `HelpMeWriteTemplatesBar` — the docked bar: free prompt with an optional
+ *    mic, a Templates menu, a side-by-side compare, Replace / Insert below.
+ *  - `AiTemplateManager` — the dialog to list, create, edit and delete
+ *    templates and pick the default.
+ *  - `AiCreditsExhaustedNotice` — the out-of-credits state the bar shows when
+ *    `onGenerate` rejects with `AiCreditsExhaustedError`.
+ *  - `HelpMeWriteUndoNotice` — the success notice with Undo after a template
+ *    rewrote the note.
+ *
+ * The host owns the templates (list + persistence) and the AI call. The kit
+ * never talks to a backend.
+ */
+import { type ReactNode } from 'react';
+import type { HelpMeWriteRenderContext } from '../../components/rich-text-editor';
+/** A practice-shared AI template. */
+export interface AiTemplate {
+    id: string;
+    /** Up to 100 characters, unique within the practice. */
+    name: string;
+    /** One line under the name in the Templates menu. */
+    description?: string;
+    /** The instructions sent to the AI, up to 4000 characters. */
+    prompt: string;
+    /** At most one per practice; listed first with a Default badge. */
+    isDefault: boolean;
+}
+/** What the manager hands `onSaveTemplate`: `id` is absent for a new one. */
+export type AiTemplateDraft = Omit<AiTemplate, 'id'> & {
+    id?: string;
+};
+/** One Help-me-write request. `template` is absent for a free prompt. */
+export interface HelpMeWriteRequest {
+    template?: AiTemplate;
+    /** The free prompt, or extra instructions for a template. May be ''. */
+    prompt: string;
+    /** Plain text the template rewrites: the selection, else the whole note. */
+    sourceText: string;
+    signal: AbortSignal;
+}
+/**
+ * Throw (or reject with) this from `onGenerate` when the practice is out of
+ * AI credits (the platform endpoint's 402), and the bar shows the
+ * out-of-credits notice instead of a generic error.
+ */
+export declare class AiCreditsExhaustedError extends Error {
+    constructor(message?: string);
+}
+/** The practice's allowance, for the out-of-credits notice. All optional. */
+export interface AiCreditsInfo {
+    remaining?: number;
+    limit?: number;
+    /** When the monthly allowance returns. */
+    resetsOn?: Date;
+    /**
+     * Shows a "Buy AI credits" button and "add credits" wording. Omit while
+     * credits cannot be bought: the notice then only says when AI returns.
+     */
+    onBuyCredits?: () => void;
+    /** Shows a "See what each action costs" link. */
+    onSeeCosts?: () => void;
+}
+export type HelpMeWriteApplyMode = 'replace' | 'below' | 'insert';
+/** Fired after a draft lands in the editor. */
+export interface HelpMeWriteApplied {
+    mode: HelpMeWriteApplyMode;
+    template?: AiTemplate;
+    /** The editor's HTML before the change. */
+    previousHtml: string;
+    /** Puts `previousHtml` back in the editor (what Undo does). */
+    undo: () => void;
+}
+export interface AiCreditsExhaustedNoticeProps {
+    credits?: AiCreditsInfo;
+    /** Shows a Back button (the bar uses it to return to the prompt). */
+    onBack?: () => void;
+}
+/** The out-of-credits state: what happened, the allowance, and the ways on. */
+export declare function AiCreditsExhaustedNotice({ credits, onBack, }: AiCreditsExhaustedNoticeProps): React.JSX.Element;
+export interface HelpMeWriteTemplatesBarProps {
+    /** What `RichTextEditor`'s `renderHelpMeWrite` hands its host. */
+    context: HelpMeWriteRenderContext;
+    templates: AiTemplate[];
+    /** The AI call. Reject with `AiCreditsExhaustedError` when out of credits. */
+    onGenerate: (request: HelpMeWriteRequest) => Promise<string>;
+    /**
+     * Opens the template manager. Omit to hide "Manage templates" and
+     * "Create your first template" (e.g. for readers who may not manage).
+     */
+    onManageTemplates?: (mode: 'list' | 'create') => void;
+    /** After a draft lands; the hook uses it for Undo. */
+    onApplied?: (applied: HelpMeWriteApplied) => void;
+    /** Shown in the out-of-credits notice. */
+    credits?: AiCreditsInfo;
+    /** Show the mic in the prompt when the editor has `onDictate`. Default true. */
+    enableDictation?: boolean;
+    /** Ignore Escape (e.g. while the manager dialog above it is open). */
+    suspendClose?: boolean;
+}
+/** The Help-me-write bar with templates, docked in the editor's AI slot. */
+export declare function HelpMeWriteTemplatesBar({ context, templates, onGenerate, onManageTemplates, onApplied, credits, enableDictation, suspendClose, }: HelpMeWriteTemplatesBarProps): React.JSX.Element;
+export interface AiTemplateManagerProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Open on the list (default) or straight on a new-template form. */
+    initialMode?: 'list' | 'create';
+    templates: AiTemplate[];
+    /** Persist a new (no `id`) or edited template. A rejection keeps the form open. */
+    onSaveTemplate: (draft: AiTemplateDraft) => void | Promise<void>;
+    /** Omit to hide Delete. */
+    onDeleteTemplate?: (id: string) => void | Promise<void>;
+}
+/** List, create, edit and delete the practice's templates. */
+export declare function AiTemplateManager({ open, onOpenChange, initialMode, templates, onSaveTemplate, onDeleteTemplate, }: AiTemplateManagerProps): React.JSX.Element;
+export interface HelpMeWriteUndoNoticeProps {
+    /** The change to offer Undo for; `null` hides the notice. */
+    applied: HelpMeWriteApplied | null;
+    onUndo: () => void;
+    onDismiss: () => void;
+}
+/** "Note rewritten with …" plus Undo; takes focus when it appears. */
+export declare function HelpMeWriteUndoNotice({ applied, onUndo, onDismiss, }: HelpMeWriteUndoNoticeProps): React.JSX.Element | null;
+export interface UseHelpMeWriteTemplatesOptions {
+    templates: AiTemplate[];
+    onGenerate: HelpMeWriteTemplatesBarProps['onGenerate'];
+    /** Enables the manager (create / edit). Omit for read-only template users. */
+    onSaveTemplate?: AiTemplateManagerProps['onSaveTemplate'];
+    /** Enables Delete in the manager. */
+    onDeleteTemplate?: AiTemplateManagerProps['onDeleteTemplate'];
+    credits?: AiCreditsInfo;
+    /** Mic in the bar's prompt when the editor has `onDictate`. Default true. */
+    enableDictation?: boolean;
+    /** Also told about every applied draft (e.g. for analytics). */
+    onApplied?: (applied: HelpMeWriteApplied) => void;
+}
+export interface UseHelpMeWriteTemplatesResult {
+    /** Pass to `RichTextEditor`'s `renderHelpMeWrite`. */
+    renderHelpMeWrite: (context: HelpMeWriteRenderContext) => ReactNode;
+    /** Mount once, anywhere (a portalled dialog); `null` without `onSaveTemplate`. */
+    manager: ReactNode;
+    /** Place where the Undo notice should show, e.g. above the editor. */
+    undoNotice: ReactNode;
+    openManager: (mode?: 'list' | 'create') => void;
+}
+/**
+ * Wires the bar, the manager and Undo together. Usage:
+ *
+ *   const hmw = useHelpMeWriteTemplates({ templates, onGenerate, onSaveTemplate });
+ *   {hmw.undoNotice}
+ *   <RichTextEditor renderHelpMeWrite={hmw.renderHelpMeWrite} … />
+ *   {hmw.manager}
+ */
+export declare function useHelpMeWriteTemplates({ templates, onGenerate, onSaveTemplate, onDeleteTemplate, credits, enableDictation, onApplied, }: UseHelpMeWriteTemplatesOptions): UseHelpMeWriteTemplatesResult;
+//# sourceMappingURL=help-me-write-templates.d.ts.map

package/dist/patterns/help-me-write-templates/help-me-write-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-me-write-templates.d.ts","sourceRoot":"","sources":["../../../src/patterns/help-me-write-templates/help-me-write-templates.tsx"],"names":[],"mappings":"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"}

package/dist/patterns/help-me-write-templates/index.d.ts

@@ -0,0 +1,3 @@
+export { AiCreditsExhaustedError, AiCreditsExhaustedNotice, AiTemplateManager, HelpMeWriteTemplatesBar, HelpMeWriteUndoNotice, useHelpMeWriteTemplates, } from './help-me-write-templates';
+export type { AiCreditsExhaustedNoticeProps, AiCreditsInfo, AiTemplate, AiTemplateDraft, AiTemplateManagerProps, HelpMeWriteApplied, HelpMeWriteApplyMode, HelpMeWriteRequest, HelpMeWriteTemplatesBarProps, HelpMeWriteUndoNoticeProps, UseHelpMeWriteTemplatesOptions, UseHelpMeWriteTemplatesResult, } from './help-me-write-templates';
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/help-me-write-templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/patterns/help-me-write-templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,6BAA6B,EAC7B,aAAa,EACb,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,0BAA0B,EAC1B,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,2BAA2B,CAAC"}

package/dist/patterns/help-me-write-templates/index.js

@@ -0,0 +1,10 @@
+import { A as s, a as t, b as r, H as i, c as p, u as l } from "../../_chunks/help-me-write-templates-B-m7zgJa.js";
+export {
+  s as AiCreditsExhaustedError,
+  t as AiCreditsExhaustedNotice,
+  r as AiTemplateManager,
+  i as HelpMeWriteTemplatesBar,
+  p as HelpMeWriteUndoNotice,
+  l as useHelpMeWriteTemplates
+};
+//# sourceMappingURL=index.js.map

package/dist/patterns/help-me-write-templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/patterns/marketplace-app-shell/index.js

@@ -1,4 +1,4 @@
-import { C as l, M as o } from "../../_chunks/marketplace-app-shell-d2EtcUbe.js";
+import { C as l, M as o } from "../../_chunks/marketplace-app-shell-D_g9BaDI.js";
 export {
   l as ConnectWithAlfadocs,
   o as MarketplaceAppShell