@envive-ai/react-widgets-v3 0.3.14 → 0.3.15-beta.1

package/dist/packages/hooks/dist/contexts/typesV3.d.ts

@@ -0,0 +1,239 @@
+import { CustomerServiceType } from "../types/customerService.js";
+import { SearchConfig } from "./types.js";
+import { Theme } from "@envive-ai/react-toolkit-v3/Tokens";
+import { AnimationSpeed, PromptCarouselRows } from "@envive-ai/react-toolkit-v3/PromptCarousel";
+import { FloatingButtonLocation } from "@envive-ai/react-toolkit-v3/FloatingButton";
+import { DynamicLayout, WidgetKind } from "@envive-ai/react-toolkit-v3/SocialProof";
+import { WidgetWrapperVariant } from "@envive-ai/react-toolkit-v3/WidgetWrapper";
+import { ImageGalleryImage, ImageGalleryLayout } from "@envive-ai/react-toolkit-v3/ImageGallery";
+import { PromptButtonVariant } from "@envive-ai/react-toolkit-v3/PromptButton";
+import { SparkleIconColor } from "@envive-ai/react-toolkit-v3/WelcomeMessage";
+
+//#region ../hooks/dist/contexts/typesV3.d.ts
+
+type ImageAspectRatio = '1/1' | '3/4';
+type ButtonColors = {
+  lightButtonBackgroundColor: string;
+  lightButtonIconColor: string;
+  darkButtonBackgroundColor: string;
+  darkButtonIconColor: string;
+};
+type Typography = {
+  titleFontFamily: string;
+  headerFontFamily: string;
+  bodyFontFamily: string;
+  fontSize?: {
+    t1: string;
+    t2: string;
+    t3: string;
+    h1: string;
+    h2: string;
+    h3: string;
+    b1: string;
+    b2: string;
+    b3: string;
+    b4: string;
+    b5: string;
+    l1: string;
+    l2: string;
+  };
+  fontWeight?: {
+    rg: string;
+    md: string;
+    sb: string;
+  };
+  letterSpacing?: {
+    '0': string;
+    'wide-1': string;
+  };
+  lineHeight?: {
+    '124': number;
+    '120': number;
+    '118': number;
+    '116': number;
+    '114': number;
+    '148': number;
+    '140': number;
+    '128': number;
+    '130': number;
+    '133': number;
+  };
+};
+type LookAndFeelConfig = {
+  theme: Theme;
+  agentName: string;
+  chatHeaderLogoDarkSrc: string;
+  chatHeaderLogoLightSrc: string;
+  widgetLogoSrc: string;
+  hideWidgetLogo: boolean;
+  elementRadius: number;
+  imageAspectRatio: ImageAspectRatio;
+  buttonColors: ButtonColors;
+  typography: Typography;
+};
+declare enum ConfigVersionEnum {
+  V3 = "v3",
+  Deprecated = "deprecated",
+}
+type ConfigVersion = ConfigVersionEnum.V3 | ConfigVersionEnum.Deprecated | undefined;
+type Mode = 'dark' | 'light';
+type ShowOptions = 'always' | 'postInteraction' | 'none';
+type Style = 'attached' | 'detached';
+type FloatingButtonConfig = {
+  position: FloatingButtonLocation;
+  backgroundColor?: string;
+  mode: Mode;
+  showOption: ShowOptions;
+  iconSVGSrc?: string;
+  style: Style;
+};
+type ReferrerPopupTrigger = {
+  type: 'referrer';
+  referrers: string[];
+};
+type AutomaticPopupTrigger = {
+  type: 'automatic';
+};
+type PopupTrigger = ReferrerPopupTrigger | AutomaticPopupTrigger;
+type AutoPopupTrigger = {
+  delay: number;
+  trigger: PopupTrigger;
+};
+interface AutoPopupConfig {
+  triggers: AutoPopupTrigger[];
+}
+type PartialViewConfig = {
+  /**
+   * When true, only full-screen mode is supported (no partial/draggable middle state).
+   * Useful when partial view causes usability issues on mobile.
+   * Default: false (undefined and false = partial view enabled).
+   */
+  disabled?: boolean;
+};
+type FloatingChatConfig = {
+  headerBackgroundColor?: string;
+  headerMode: Mode;
+  welcomeMessageIconColor: SparkleIconColor;
+  showVerifiedBuyer: boolean;
+  userQueryInputEnabled: boolean;
+  showEnviveLogo: boolean;
+  ignoreFirstModelResponse?: boolean;
+  neverShowSingleProductCards?: boolean;
+  welcomeMessageTitle: string;
+  welcomeMessageText: string;
+  chatFooterTextFieldPlaceholderText: string;
+  autoPopupConfig?: AutoPopupConfig;
+  partialViewConfig?: PartialViewConfig;
+};
+type CustomerServiceIntegration = {
+  enabled: boolean;
+  provider: CustomerServiceType;
+  suppressMerchantButton?: boolean;
+};
+type SPASettings = {
+  enabled: boolean;
+  refreshInterval?: number;
+};
+type OrgUIConfigV3 = {
+  id?: string;
+  version: ConfigVersion;
+  shortName: string;
+  lookAndFeel: LookAndFeelConfig;
+  floatingButton: FloatingButtonConfig;
+  floatingChat: FloatingChatConfig;
+  merchantOverrideCss?: string;
+  customerServiceIntegration?: CustomerServiceIntegration;
+  singlePageApplicationSettings?: SPASettings;
+  searchConfig?: SearchConfig;
+};
+declare enum WidgetTypeV3 {
+  PromptCarouselV3 = "PromptCarouselV3",
+  TitledPromptCarouselV3 = "TitledPromptCarouselV3",
+  SocialProofV3 = "SocialProofV3",
+  TypingAnimationV3 = "TypingAnimationV3",
+  ChatPreviewV3 = "ChatPreviewV3",
+  ChatPreviewComparisonV3 = "ChatPreviewComparisonV3",
+  ChatPreviewLoadingV3 = "ChatPreviewLoadingV3",
+  ImagePromptCardV3 = "ImagePromptCardV3",
+  PromptButtonCarouselWithImageV3 = "PromptButtonCarouselWithImageV3",
+  ImageBannerV3 = "ImageBannerV3",
+  SingleImagePromptV3 = "SingleImagePromptV3",
+  FloatingChatV3 = "FloatingChatV3",
+  FloatingButtonV3 = "FloatingButtonV3",
+  ProductCardV3 = "ProductCardV3",
+  FullPageSalesAgentV3 = "FullPageSalesAgentV3",
+}
+interface BaseWidgetConfig<T extends WidgetTypeV3> {
+  widgetConfigId: string;
+  type: T;
+  contentId?: string;
+}
+interface PromptCarouselWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.PromptCarouselV3> {
+  promptButtonType?: PromptButtonVariant;
+  boldFirstButton?: boolean;
+  promptCarouselRows?: PromptCarouselRows;
+  animationSpeed?: AnimationSpeed;
+}
+interface TitledPromptCarouselWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.TitledPromptCarouselV3> {
+  promptButtonType?: PromptButtonVariant;
+  boldFirstButton?: boolean;
+  promptCarouselRows?: PromptCarouselRows;
+  animationSpeed?: AnimationSpeed;
+}
+interface SocialProofWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.SocialProofV3> {
+  kind: WidgetKind;
+  variant: WidgetWrapperVariant;
+  hexCardColor?: string;
+  promptCarouselRows: PromptCarouselRows;
+  hideImage?: boolean;
+  imageGalleryLayout: Exclude<ImageGalleryLayout, 'TWO_SIDE'>;
+  hideTextField?: boolean;
+  primaryButtonVariant: Exclude<PromptButtonVariant, 'suggestedResponse' | 'ghost'>;
+  secondaryButtonVariant: Exclude<PromptButtonVariant, 'suggestedResponse' | 'ghost'>;
+  dynamicLayout?: DynamicLayout;
+  images?: ImageGalleryImage[];
+}
+interface TypingAnimationWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.TypingAnimationV3> {
+  widgetVariant?: WidgetWrapperVariant;
+  cardColor?: string;
+  promptButtonType?: PromptButtonVariant;
+  promptCarouselRows?: PromptCarouselRows;
+  showTextField?: boolean;
+}
+interface ChatPreviewComparisonWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.ChatPreviewComparisonV3> {
+  variant: WidgetWrapperVariant;
+  hexCardColor?: string;
+  hideImage?: boolean;
+  hideTextField?: boolean;
+}
+interface ChatPreviewLoadingWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.ChatPreviewLoadingV3> {
+  variant: WidgetWrapperVariant;
+  hexCardColor?: string;
+  hideTextField?: boolean;
+}
+interface ChatPreviewWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.ChatPreviewV3> {
+  variant: WidgetWrapperVariant;
+  hexCardColor?: string;
+  hideTextField?: boolean;
+}
+interface PromptButtonCarouselWithImageWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.PromptButtonCarouselWithImageV3> {
+  promptButtonType?: PromptButtonVariant;
+  image?: ImageGalleryImage;
+  hideTextField?: boolean;
+  isDynamic?: boolean;
+}
+interface FloatingChatWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.FloatingChatV3> {}
+interface ProductCardWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.ProductCardV3> {
+  promptButtonType?: PromptButtonVariant;
+  italicizeHeadline?: boolean;
+  fallbackColor?: string;
+  imageSrc?: string;
+}
+interface FullPageSalesAgentWidgetV3Config extends BaseWidgetConfig<WidgetTypeV3.FullPageSalesAgentV3> {
+  headerContainer?: string;
+  autoHeight?: boolean;
+}
+type WidgetConfigV3 = PromptCarouselWidgetV3Config | SocialProofWidgetV3Config | TitledPromptCarouselWidgetV3Config | ChatPreviewComparisonWidgetV3Config | ChatPreviewLoadingWidgetV3Config | TypingAnimationWidgetV3Config | ChatPreviewWidgetV3Config | PromptButtonCarouselWithImageWidgetV3Config | FloatingChatWidgetV3Config | ProductCardWidgetV3Config | FullPageSalesAgentWidgetV3Config;
+//#endregion
+//#endregion
+export { type OrgUIConfigV3, type WidgetConfigV3, WidgetTypeV3 };

package/dist/packages/hooks/dist/services/amplitudeService/amplitudeService.d.ts

@@ -0,0 +1 @@
+import "../../contexts/featureFlagServiceContext/featureFlagServiceContext.js";

package/dist/packages/hooks/dist/services/amplitudeService/eventNames.d.ts

@@ -0,0 +1,43 @@
+//#region ../hooks/dist/services/amplitudeService/eventNames.d.ts
+//#region src/services/amplitudeService/eventNames.d.ts
+/**
+ * Event name enums for Amplitude tracking.
+ *
+ * NOTE: This file exists separately to avoid circular dependency issues.
+ * The amplitudeService imports from ga4ProjectionService, which needs these enums.
+ * By keeping the enums in a separate file, ga4ProjectionService can import them
+ * without creating a circular dependency with amplitudeService.
+ */
+declare enum SpiffyMetricsEventName {
+  BundleLoaded = "Bundle Loaded",
+  EnvironmentInitialized = "Environment Initialized",
+  ChatLiveAgentBtnClick = "Chat Live Agent Btn Click",
+  ChatFloatingButtonVisible = "Chat Floating Button Visible",
+  ChatComponentVisible = "Chat Component Visible",
+  ChatComponentExpanded = "Chat Component Expanded",
+  ChatComponentCollapsed = "Chat Component Collapsed",
+  ChatUserMessageInput = "Chat User Message Input",
+  ChatSuggestionClicked = "Chat Suggestion Clicked",
+  ChatAssistantResponse = "Chat Assistant Response",
+  ProductCardClicked = "Product Card Clicked",
+  ProductReviewCardClicked = "Product Review Card Clicked",
+  AddToCartClicked = "Add To Cart Clicked",
+  PromptCardClicked = "Prompt Card Clicked",
+  SupportedEvent = "Supported Event",
+  SearchBackToResponseClicked = "Search Back to Response Clicked",
+  PerformanceMetrics = "Performance Metrics",
+  SearchBarClicked = "Search Bar Clicked",
+  OrderLookupStarted = "Order Lookup Started",
+  OrderLookupFormSubmitted = "Order Lookup Form Submitted",
+  SearchComponentVisible = "Search Component Visible",
+  SearchZeroStateSuggestionClicked = "Search Zero State Suggestion Clicked",
+  SearchInputStarted = "Search Input Started",
+  SearchQuerySubmitted = "Search Query Submitted",
+  SearchResultsViewed = "Search Results Viewed",
+  SearchTimeToFirstClick = "Search Time to First Click",
+  SearchZeroResultsRate = "Search Zero Results Rate",
+  SearchFilterClicked = "Search Filter Clicked",
+  SearchSortClicked = "Search Sort Clicked",
+}
+//#endregion
+export { SpiffyMetricsEventName };

package/dist/packages/hooks/dist/types/customerService.d.ts

@@ -0,0 +1,21 @@
+//#region ../hooks/dist/types/customerService.d.ts
+
+//#region src/types/customerService.d.ts
+declare enum CustomerServiceType {
+  shopify = "shopify",
+  gorgias = "gorgias",
+  kustomer = "kustomer",
+  groove = "groove",
+  tidio = "tidio",
+  zowie = "zowie",
+  redo = "redo",
+  gladly = "gladly",
+  richpanel = "richpanel",
+  zendesk = "zendesk",
+  helpscout = "helpscout",
+  talkdesk = "talkdesk",
+  eightByEight = "8x8",
+  unsupported = "unsupported",
+}
+//#endregion
+export { CustomerServiceType };

package/dist/packages/widgets/dist/SearchResults/SearchResults.d.ts

@@ -1,13 +1,14 @@
+import { SearchResultsHocProps } from "../packages/hooks/dist/hooks/Search/useSearch.js";
 import { SearchResultsEntryPointWidgetConfig } from "./types.js";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
-import { SearchResultsHocProps } from "@envive-ai/react-hooks/hooks/Search";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region ../widgets/dist/SearchResults/SearchResults.d.ts
+
 //#region src/SearchResults/SearchResults.d.ts
 interface SearchResultsProps extends SearchResultsHocProps {
   widgetConfig: SearchResultsEntryPointWidgetConfig;
 }
-declare const SearchResults: (props: Omit<SearchResultsProps, string | number | symbol>) => react_jsx_runtime1.JSX.Element;
+declare const SearchResults: (props: Omit<SearchResultsProps, keyof SearchResultsHocProps>) => react_jsx_runtime0.JSX.Element;
 //#endregion
 
 //#endregion

package/dist/packages/widgets/dist/SearchResults/SearchResultsWidget.d.ts

@@ -1,8 +1,8 @@
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 
 //#region ../widgets/dist/SearchResults/SearchResultsWidget.d.ts
 //#region src/SearchResults/SearchResultsWidget.d.ts
-declare const SearchResultsWidget: () => react_jsx_runtime3.JSX.Element;
+declare const SearchResultsWidget: () => react_jsx_runtime2.JSX.Element;
 //#endregion
 
 //#endregion

package/dist/packages/widgets/dist/SearchZeroState/index.d.ts

@@ -1,3 +1,4 @@
-import { SearchEntryPointWidgetConfig, SearchInputVariant, SearchZeroStateProps } from "./types.js";
+import { SearchEntryPointWidgetConfig, SearchInputVariant } from "../packages/hooks/dist/contexts/types.js";
+import { SearchZeroStateProps } from "./types.js";
 import { SearchZeroState } from "./SearchZeroState.js";
 import { SearchZeroStateWidget } from "./SearchZeroStateWidget.js";

package/dist/packages/widgets/dist/SearchZeroState/types.d.ts

@@ -1,4 +1,4 @@
-import { SearchEntryPointWidgetConfig, SearchInputVariant } from "@envive-ai/react-hooks/contexts/types";
+import { SearchEntryPointWidgetConfig } from "../packages/hooks/dist/contexts/types.js";
 
 //#region ../widgets/dist/SearchZeroState/types.d.ts
 //#region src/SearchZeroState/types.d.ts
@@ -10,4 +10,4 @@ interface SearchZeroStateProps {
 //#endregion
 
 //#endregion
-export { type SearchEntryPointWidgetConfig, type SearchInputVariant, SearchZeroStateProps };
+export { SearchZeroStateProps };

package/dist/packages/widgets/dist/SuggestionBar/SuggestionBar.d.ts

@@ -1,6 +1,6 @@
+import { SuggestionButtonVariant } from "../packages/hooks/dist/contexts/types.js";
 import { SuggestionBarLocationForMetrics } from "./types.js";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { SuggestionButtonVariant } from "@envive-ai/react-hooks/contexts/types";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 import { Message } from "postcss";
 
 //#region ../widgets/dist/SuggestionBar/SuggestionBar.d.ts
@@ -30,7 +30,7 @@ declare function SuggestionBar({
   buttonBorderRadius,
   handleReply,
   dataTestId
-}: Readonly<SuggestionBarProps>): react_jsx_runtime0.JSX.Element;
+}: Readonly<SuggestionBarProps>): react_jsx_runtime3.JSX.Element;
 //#endregion
 //#endregion
 export { SuggestionBar };

package/dist/packages/widgets/dist/SuggestionButtonContainer/index.d.ts

@@ -0,0 +1,2 @@
+import { SuggestionButtonContainerProps } from "./types.js";
+import { SuggestionButtonContainer } from "./SuggestionButtonContainer.js";

package/dist/packages/widgets/dist/SuggestionButtonContainer/types.d.ts

@@ -1,5 +1,6 @@
-import { SuggestionButtonVariant } from "@envive-ai/react-hooks/contexts/types";
-import { TestProps } from "@envive-ai/react-hooks/types";
+import { TestProps } from "../packages/hooks/dist/types/test-types.js";
+import { SuggestionButtonVariant } from "../packages/hooks/dist/contexts/types.js";
+import "../packages/hooks/dist/types/index.js";
 
 //#region ../widgets/dist/SuggestionButtonContainer/types.d.ts
 //#region src/SuggestionButtonContainer/types.d.ts

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/api/response.d.ts

@@ -0,0 +1,14 @@
+import { CamelCasedPropertiesDeep } from "../utilityTypes/camelCasedPropertiesDeep.js";
+import { ResponseCategory, SearchResponseProduct } from "@spiffy-ai/commerce-api-client";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/api/response.d.ts
+
+//#region ../hooks/dist/application/models/api/response.d.ts
+interface SearchResponseProductAttributes {
+  category: ResponseCategory.Product;
+  attributes: CamelCasedPropertiesDeep<SearchResponseProduct>;
+}
+//#endregion
+
+//#endregion
+export { SearchResponseProductAttributes };

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/api/search.d.ts

@@ -0,0 +1,15 @@
+import { SearchResponseProduct } from "@spiffy-ai/commerce-api-client";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/api/search.d.ts
+
+//#region ../hooks/dist/application/models/api/search.d.ts
+interface SearchResult {
+  products: SearchResponseProduct[];
+  filters: string[];
+  generatedQuery?: string;
+  totalProductCount: number;
+  searchResponseId: string;
+}
+//#endregion
+//#endregion
+export { SearchResult };

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/utilityTypes/camelCase.d.ts

@@ -0,0 +1,73 @@
+import { SplitWords } from "./splitWords.js";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/utilityTypes/camelCase.d.ts
+
+//#region ../hooks/dist/application/models/utilityTypes/camelCase.d.ts
+//#region src/application/models/utilityTypes/camelCase.d.ts
+/**
+ * CamelCase options.
+ *
+ * @see {@link CamelCase}
+ */
+type CamelCaseOptions = {
+  /**
+   * Whether to preserved consecutive uppercase letter.
+   *
+   * @default true
+   */
+  preserveConsecutiveUppercase?: boolean;
+};
+/**
+ * Convert an array of words to camel-case.
+ */
+type CamelCaseFromArray<Words extends string[], Options extends CamelCaseOptions, OutputString extends string = ''> = Words extends [infer FirstWord extends string, ...infer RemainingWords extends string[]] ? Options['preserveConsecutiveUppercase'] extends true ? `${Capitalize<FirstWord>}${CamelCaseFromArray<RemainingWords, Options>}` : `${Capitalize<Lowercase<FirstWord>>}${CamelCaseFromArray<RemainingWords, Options>}` : OutputString;
+/**
+ * Convert a string literal to camel-case.
+ *
+ * This can be useful when, for example, converting some kebab-cased command-line flags or a snake-cased database result.
+ *
+ * By default, consecutive uppercase letter are preserved. See {@link CamelCaseOptions.preserveConsecutiveUppercase preserveConsecutiveUppercase} option to change this behaviour.
+ *
+ * @example
+ * ```
+ * import type {CamelCase} from 'type-fest';
+ *
+ * // Simple
+ *
+ * const someVariable: CamelCase<'foo-bar'> = 'fooBar';
+ *
+ * // Advanced
+ *
+ * type CamelCasedProperties<T> = {
+ * 	[K in keyof T as CamelCase<K>]: T[K]
+ * };
+ *
+ * interface RawOptions {
+ * 	'dry-run': boolean;
+ * 	'full_family_name': string;
+ * 	foo: number;
+ * 	BAR: string;
+ * 	QUZ_QUX: number;
+ * 	'OTHER-FIELD': boolean;
+ * }
+ *
+ * const dbResult: CamelCasedProperties<RawOptions> = {
+ * 	dryRun: true,
+ * 	fullFamilyName: 'bar.js',
+ * 	foo: 123,
+ * 	bar: 'foo',
+ * 	quzQux: 6,
+ * 	otherField: false
+ * };
+ * ```
+ *
+ * @category Change case
+ * @category Template literal
+ */
+type CamelCase<Type, Options extends CamelCaseOptions = {
+  preserveConsecutiveUppercase: true;
+}> = Type extends string ? string extends Type ? Type : Uncapitalize<CamelCaseFromArray<SplitWords<Type extends Uppercase<Type> ? Lowercase<Type> : Type>, Options>> : Type;
+//#endregion
+//#endregion
+//#endregion
+export { CamelCase, CamelCaseOptions };

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/utilityTypes/camelCasedPropertiesDeep.d.ts

@@ -0,0 +1,61 @@
+import { CamelCase, CamelCaseOptions } from "./camelCase.js";
+import { UnknownArray } from "./unknownArray.js";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/utilityTypes/camelCasedPropertiesDeep.d.ts
+
+//#region ../hooks/dist/application/models/utilityTypes/camelCasedPropertiesDeep.d.ts
+//#region src/application/models/utilityTypes/camelCasedPropertiesDeep.d.ts
+/**
+ * Convert object properties to camel case recursively.
+ *
+ * This can be useful when, for example, converting some API types from a different style.
+ *
+ * @see CamelCasedProperties
+ * @see CamelCase
+ *
+ * @example
+ * ```
+ * import type {CamelCasedPropertiesDeep} from 'type-fest';
+ *
+ * interface User {
+ * 	UserId: number;
+ * 	UserName: string;
+ * }
+ *
+ * interface UserWithFriends {
+ * 	UserInfo: User;
+ * 	UserFriends: User[];
+ * }
+ *
+ * const result: CamelCasedPropertiesDeep<UserWithFriends> = {
+ * 	userInfo: {
+ * 		userId: 1,
+ * 		userName: 'Tom',
+ * 	},
+ * 	userFriends: [
+ * 		{
+ * 			userId: 2,
+ * 			userName: 'Jerry',
+ * 		},
+ * 		{
+ * 			userId: 3,
+ * 			userName: 'Spike',
+ * 		},
+ * 	],
+ * };
+ * ```
+ *
+ * @category Change case
+ * @category Template literal
+ * @category Object
+ */
+type CamelCasedPropertiesDeep<Value, Options extends CamelCaseOptions = {
+  preserveConsecutiveUppercase: true;
+}> = Value extends Function ? Value : Value extends UnknownArray ? CamelCasedPropertiesArrayDeep<Value> : Value extends Set<infer U> ? Set<CamelCasedPropertiesDeep<U, Options>> : { [K in keyof Value as CamelCase<K, Options>]: CamelCasedPropertiesDeep<Value[K], Options> };
+type CamelCasedPropertiesArrayDeep<Value extends UnknownArray> = Value extends [] ? [] : Value extends [infer U, ...infer V] ? [CamelCasedPropertiesDeep<U>, ...CamelCasedPropertiesDeep<V>] : Value extends readonly [infer U, ...infer V] ? readonly [CamelCasedPropertiesDeep<U>, ...CamelCasedPropertiesDeep<V>] : Value extends readonly [...infer U, infer V] ? [...CamelCasedPropertiesDeep<U>, CamelCasedPropertiesDeep<V>] : Value extends readonly [...infer U, infer V] ? readonly [...CamelCasedPropertiesDeep<U>, CamelCasedPropertiesDeep<V>] : Value extends Array<infer U> ? Array<CamelCasedPropertiesDeep<U>> : Value extends ReadonlyArray<infer U> ? ReadonlyArray<CamelCasedPropertiesDeep<U>> : never;
+//#endregion
+
+//#endregion
+
+//#endregion
+export { CamelCasedPropertiesDeep };

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/utilityTypes/internal.d.ts

@@ -0,0 +1,25 @@
+import { Trim } from "./trim.js";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/utilityTypes/internal.d.ts
+
+//#region ../hooks/dist/application/models/utilityTypes/internal.d.ts
+/**
+ * Returns a boolean for whether the string is numeric.
+ *
+ * This type is a workaround for [Microsoft/TypeScript#46109](https://github.com/microsoft/TypeScript/issues/46109#issuecomment-930307987).
+ */
+type IsNumeric<T extends string> = T extends `${number}` ? Trim<T> extends T ? true : false : false;
+/**
+ * Returns a boolean for whether the string is lowercased.
+ */
+type IsLowerCase<T extends string> = T extends Lowercase<T> ? true : false;
+/**
+ * Returns a boolean for whether the string is upper-cased.
+ */
+type IsUpperCase<T extends string> = T extends Uppercase<T> ? true : false;
+type WordSeparators = '-' | '_' | Whitespace;
+type Whitespace = '\u{9}' | '\u{A}' | '\u{B}' | '\u{C}' | '\u{D}' | '\u{20}' | '\u{85}' | '\u{A0}' | '\u{1680}' | '\u{2000}' | '\u{2001}' | '\u{2002}' | '\u{2003}' | '\u{2004}' | '\u{2005}' | '\u{2006}' | '\u{2007}' | '\u{2008}' | '\u{2009}' | '\u{200A}' | '\u{2028}' | '\u{2029}' | '\u{202F}' | '\u{205F}' | '\u{3000}' | '\u{FEFF}';
+//#endregion
+
+//#endregion
+export { IsLowerCase, IsNumeric, IsUpperCase, Whitespace, WordSeparators };

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/utilityTypes/splitWords.d.ts

@@ -0,0 +1,35 @@
+import { IsLowerCase, IsNumeric, IsUpperCase, WordSeparators } from "./internal.js";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/utilityTypes/splitWords.d.ts
+
+//#region ../hooks/dist/application/models/utilityTypes/splitWords.d.ts
+//#region src/application/models/utilityTypes/splitWords.d.ts
+type SkipEmptyWord<Word extends string> = Word extends '' ? [] : [Word];
+type RemoveLastCharacter<Sentence extends string, Character extends string> = Sentence extends `${infer LeftSide}${Character}` ? SkipEmptyWord<LeftSide> : never;
+/**
+ * Split a string (almost) like Lodash's `_.words()` function.
+ *
+ * - Split on each word that begins with a capital letter.
+ * - Split on each {@link WordSeparators}.
+ * - Split on numeric sequence.
+ *
+ * @example
+ * ```
+ * type Words0 = SplitWords<'helloWorld'>; // ['hello', 'World']
+ * type Words1 = SplitWords<'helloWORLD'>; // ['hello', 'WORLD']
+ * type Words2 = SplitWords<'hello-world'>; // ['hello', 'world']
+ * type Words3 = SplitWords<'--hello the_world'>; // ['hello', 'the', 'world']
+ * type Words4 = SplitWords<'lifeIs42'>; // ['life', 'Is', '42']
+ * ```
+ *
+ * @internal
+ * @category Change case
+ * @category Template literal
+ */
+type SplitWords<Sentence extends string, LastCharacter extends string = '', CurrentWord extends string = ''> = Sentence extends `${infer FirstCharacter}${infer RemainingCharacters}` ? FirstCharacter extends WordSeparators ? [...SkipEmptyWord<CurrentWord>, ...SplitWords<RemainingCharacters>] : LastCharacter extends '' ? SplitWords<RemainingCharacters, FirstCharacter, FirstCharacter> : [false, true] extends [IsNumeric<LastCharacter>, IsNumeric<FirstCharacter>] ? [...SkipEmptyWord<CurrentWord>, ...SplitWords<RemainingCharacters, FirstCharacter, FirstCharacter>] : [true, false] extends [IsNumeric<LastCharacter>, IsNumeric<FirstCharacter>] ? [...SkipEmptyWord<CurrentWord>, ...SplitWords<RemainingCharacters, FirstCharacter, FirstCharacter>] : [true, true] extends [IsNumeric<LastCharacter>, IsNumeric<FirstCharacter>] ? SplitWords<RemainingCharacters, FirstCharacter, `${CurrentWord}${FirstCharacter}`> : [true, true] extends [IsLowerCase<LastCharacter>, IsUpperCase<FirstCharacter>] ? [...SkipEmptyWord<CurrentWord>, ...SplitWords<RemainingCharacters, FirstCharacter, FirstCharacter>] : [true, true] extends [IsUpperCase<LastCharacter>, IsLowerCase<FirstCharacter>] ? [...RemoveLastCharacter<CurrentWord, LastCharacter>, ...SplitWords<RemainingCharacters, FirstCharacter, `${LastCharacter}${FirstCharacter}`>] : SplitWords<RemainingCharacters, FirstCharacter, `${CurrentWord}${FirstCharacter}`> : [...SkipEmptyWord<CurrentWord>];
+//#endregion
+
+//#endregion
+
+//#endregion
+export { SplitWords };

package/dist/packages/widgets/dist/packages/hooks/dist/application/models/utilityTypes/trim.d.ts

@@ -0,0 +1,32 @@
+import { Whitespace } from "./internal.js";
+
+//#region ../widgets/dist/packages/hooks/dist/application/models/utilityTypes/trim.d.ts
+
+//#region ../hooks/dist/application/models/utilityTypes/trim.d.ts
+//#region src/application/models/utilityTypes/trim.d.ts
+/**
+ * Remove spaces from the left side.
+ */
+type TrimLeft<V extends string> = V extends `${Whitespace}${infer R}` ? TrimLeft<R> : V;
+/**
+ * Remove spaces from the right side.
+ */
+type TrimRight<V extends string> = V extends `${infer R}${Whitespace}` ? TrimRight<R> : V;
+/**
+ * Remove leading and trailing spaces from a string.
+ * @example
+ * ```
+ * import type {Trim} from 'type-fest';
+ *
+ * Trim<' foo '>
+ * //=> 'foo'
+ * ```
+ *
+ * @category String
+ * @category Template literal
+ */
+type Trim<V extends string> = TrimLeft<TrimRight<V>>;
+//#endregion
+//#endregion
+//#endregion
+export { Trim };