gentiq 0.10.0 → 0.10.2

package/dist/src/admin/lib/recharge.d.ts

@@ -0,0 +1,10 @@
+import { RechargeIntervalUnit } from './api';
+/**
+ * The default first-renewal anchor when the admin leaves it blank.
+ *
+ * Snaps to the next round boundary of the interval unit in the admin's **local** time
+ * (an hourly policy at 15:32 → 16:00, a daily one → next local midnight, a monthly one →
+ * the 1st of next month). Computed in the browser rather than the backend so "00:00" means
+ * the admin's wall-clock midnight, not 00:00 UTC. Returned as a UTC ISO instant.
+ */
+export declare function nextRoundAnchor(unit: RechargeIntervalUnit, from?: Date): string;

package/dist/src/components/MessageList.d.ts

@@ -1,4 +1,4 @@
 import { MessageListProps } from '../types';
-export declare function MessageList({ messages, status, isLoadingHistory, error, conversationId, regen, onSuggestionClick, chat, className, readonly, }: MessageListProps & {
+export declare function MessageList({ messages, status, isLoadingHistory, error, conversationId, regen, chat, className, readonly, }: MessageListProps & {
     className?: string;
 }): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/PromptInputArea.d.ts

@@ -6,7 +6,9 @@ interface PromptInputAreaProps {
     stop: () => void;
     isErrorVisible: boolean;
     conversationId?: string;
+    /** When true, this is the centered new-chat composer (animated placeholder). */
+    newChat?: boolean;
     className?: string;
 }
-export declare function PromptInputArea({ onSend, status, isLastMessageFinished, stop, isErrorVisible, conversationId, className, }: PromptInputAreaProps): import("react/jsx-runtime").JSX.Element;
+export declare function PromptInputArea({ onSend, status, isLastMessageFinished, stop, isErrorVisible, conversationId, newChat, className, }: PromptInputAreaProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/components/WelcomeScreen.d.ts

@@ -1,7 +1,14 @@
 import { LucideIcon } from 'lucide-react';
 interface WelcomeScreenProps {
-    onSuggestionClick: (suggestion: string) => void;
+    /** Retained for API compatibility with custom WelcomeScreen overrides. */
+    onSuggestionClick?: (suggestion: string) => void;
     icons?: LucideIcon[];
 }
-export declare const WelcomeScreen: ({ onSuggestionClick, icons }: WelcomeScreenProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * The new-chat header: an optional brand icon, the (optionally personalized)
+ * title and an optional static subtitle. Rendered directly above the centered
+ * composer. The rotating typing-effect messages now live in the composer's
+ * placeholder rather than here.
+ */
+export declare const WelcomeScreen: (_props: WelcomeScreenProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/hooks/useTypewriter.d.ts

@@ -0,0 +1,20 @@
+export interface UseTypewriterOptions {
+    /** Milliseconds between typing each character. */
+    typingSpeed?: number;
+    /** Milliseconds between erasing each character. */
+    deletingSpeed?: number;
+    /** How long a fully typed message is held before erasing. */
+    pauseMs?: number;
+    /** Delay before the very first character is typed. */
+    startDelayMs?: number;
+}
+/**
+ * Drives a typewriter effect that loops through a list of messages:
+ * type → pause → erase → next, forever.
+ *
+ * Respects `prefers-reduced-motion` by swapping whole messages on an interval
+ * instead of animating character-by-character.
+ *
+ * @returns The text to render for the current frame.
+ */
+export declare function useTypewriter(messages: string[], options?: UseTypewriterOptions): string;

package/dist/src/hooks/useWelcomeContent.d.ts

@@ -0,0 +1,28 @@
+import { ReactNode } from 'react';
+import { LucideIcon } from 'lucide-react';
+export interface UseWelcomeContentOptions {
+    /**
+     * Set to false to skip resolving dynamic (user-conditioned) content, e.g. when
+     * the consumer only needs typing messages on the new-chat screen.
+     */
+    enabled?: boolean;
+}
+export interface WelcomeContent {
+    /** Resolved welcome title/greeting. */
+    title: string | null;
+    /** Resolved static subtitle, if configured. */
+    subtitle: string | null;
+    /** Translated rotating typewriter messages (empty when none configured). */
+    typingMessages: string[];
+    /** Whether the current language renders right-to-left. */
+    isRtl: boolean;
+    /** Optional welcome icon. */
+    icon: LucideIcon | ReactNode | undefined;
+}
+/**
+ * Resolves the welcome-screen configuration (greeting, subtitle, icon and the
+ * rotating typewriter messages) into ready-to-render values. Shared by the
+ * new-chat header and the composer's animated placeholder so the resolution
+ * logic lives in one place.
+ */
+export declare function useWelcomeContent({ enabled, }?: UseWelcomeContentOptions): WelcomeContent;

package/dist/src/index.d.ts

@@ -24,5 +24,6 @@ export { default as UserLoginPage } from './pages/UserLoginPage';
 export { default as SharedChatView } from './pages/SharedChatView';
 export { useGentiqChat } from './hooks/useGentiqChat';
 export { useGentiqUser, type UseGentiqUserOptions } from './hooks/useGentiqUser';
+export { useTypewriter, type UseTypewriterOptions } from './hooks/useTypewriter';
 export { useComponents } from './ComponentsContext';
 export { useTranslation, withTranslation, Translation, Trans } from 'react-i18next';

package/dist/src/parts/ChoiceQuestionPart.d.ts

@@ -2,4 +2,17 @@ import { ChoiceQuestion, ChoiceQuestionPartProps } from '../types';
 export type { ChoiceQuestionPartProps } from '../types';
 export declare function normalizeChoiceQuestion(data: unknown): ChoiceQuestion | null;
 export declare function extractChoiceQuestionFromText(text: string | undefined): ChoiceQuestion | null;
+export type ChoiceQuestionSegment = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'choice-question';
+    question: ChoiceQuestion;
+};
+/**
+ * Split a text part into an ordered sequence of prose and choice-question
+ * segments. Text appearing before, between, and after choice-question markers
+ * is preserved so nothing is dropped when a message interleaves prose and cards.
+ */
+export declare function splitChoiceQuestionSegments(text: string | undefined): ChoiceQuestionSegment[];
 export declare function ChoiceQuestionPart({ part, disabled, onAnswer }: ChoiceQuestionPartProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/src/types.d.ts

@@ -322,15 +322,6 @@ export interface HistoryConfig {
     /** Whether to show the pin action for threads. */
     showPin?: boolean;
 }
-/**
- * A suggested prompt to display on the welcome screen.
- */
-export interface WelcomeSuggestion {
-    /** The text of the suggestion. */
-    text: string;
-    /** Optional icon to display alongside the text. */
-    icon?: LucideIcon;
-}
 /**
  * Configuration for the welcome/empty-state screen.
  */
@@ -342,8 +333,13 @@ export interface WelcomeScreenConfig {
     greeting?: string | ((context: WelcomeGreetingContext) => string);
     /** Optional override for the welcome message subtitle. */
     subtitle?: string;
-    /** Optional override for the starter prompt suggestions. */
-    prompts?: (string | WelcomeSuggestion)[];
+    /**
+     * Dynamic rotating subtitle messages rendered with a typewriter effect.
+     * When set (and non-empty) this REPLACES the static `subtitle`. Accepts a
+     * static array or a function receiving the authenticated user, allowing the
+     * messages to be conditioned on user info.
+     */
+    typingPrompts?: string[] | ((context: WelcomeGreetingContext) => string[]);
     /** Optional override for the icon displayed on the welcome screen. Defaults to null. */
     icon?: LucideIcon | ReactNode;
 }
@@ -761,6 +757,8 @@ export interface PromptInputProps {
     isErrorVisible: boolean;
     /** The current conversation thread ID. */
     conversationId?: string;
+    /** Whether this is the centered new-chat composer (enables the animated placeholder). */
+    newChat?: boolean;
     /** Custom CSS class names. */
     className?: string;
 }

package/package.json

@@ -10,7 +10,7 @@
     "provenance": true
   },
   "description": "React UI library for the Gentiq AI framework.",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "type": "module",
   "files": [
     "dist"