@fluid-app/portal-sdk 0.1.127 → 0.1.129

package/dist/index.d.cts

@@ -1951,1880 +1951,1882 @@ declare function AppShell({
   children
 }: AppShellProps): React.JSX.Element;
 //#endregion
-//#region src/entry/create-portal.d.ts
+//#region ../core/src/registries/property-schema-types.d.ts
 /**
-* Configuration for `createPortal()`.
-*
-* Provides a single-call entry point that sets up the full provider hierarchy
-* (auth, SDK, shell) with sensible defaults. Every field is optional.
-*
-* For full control, skip `createPortal()` and compose providers manually:
-* ```tsx
-* import { FluidAuthProvider, FluidProvider, RequireAuth, AppShell } from "@fluid-app/portal-sdk";
-* ```
+* Tab configuration for organizing properties
 */
-interface PortalConfig {
-  /** Custom page components keyed by navigation slug */
-  customPages?: Record<string, ComponentType<{
-    slug?: string;
-    params?: string;
-  }>>;
-  /** API client config overrides (merged with defaults) */
-  fluid?: Partial<FluidSDKConfig>;
-  /** Auth config overrides (merged with defaults) */
-  auth?: Partial<FluidAuthConfig>;
-  /** Root element ID. @default "root" */
-  rootId?: string;
-  /** AppShell props passthrough (basePath, sidebarHeader, etc.) */
-  shell?: Omit<AppShellProps, "customPages">;
-  /** Wrap AppShell with additional providers (inserted inside RequireAuth, below FluidProvider) */
-  providers?: ComponentType<{
-    children: ReactNode;
-  }>;
-  /** Disable StrictMode. @default false */
-  disableStrictMode?: boolean;
+interface TabConfig {
+  /** Unique identifier for the tab */
+  id: string;
+  /** Display label for the tab */
+  label: string;
 }
 /**
-* Bootstrap a Fluid portal with a single function call.
-*
-* Sets up the full provider hierarchy (FluidAuthProvider → FluidProvider → RequireAuth → AppShell)
-* and renders into the DOM.
-*
-* @example Minimal usage
-* ```ts
-* import { createPortal } from "@fluid-app/portal-sdk";
-* import "./index.css";
-*
-* createPortal();
-* ```
-*
-* @example With custom pages
-* ```ts
-* import { createPortal } from "@fluid-app/portal-sdk";
-* import { customPages } from "./portal.config";
-* import "./index.css";
-*
-* createPortal({ customPages });
-* ```
-*
-* @example With overrides
-* ```ts
-* createPortal({
-*   customPages,
-*   fluid: { baseUrl: "https://my-api.example.com" },
-*   auth: { onAuthFailure: () => console.log("auth failed") },
-*   shell: { basePath: "/portal" },
-* });
-* ```
+* Property field type constant - single source of truth for field types.
+* Use PROPERTY_FIELD_TYPES.text instead of "text" for type-safe comparisons.
 */
-declare function createPortal(config?: PortalConfig): void;
-//#endregion
-//#region src/config/defaults.d.ts
+declare const PROPERTY_FIELD_TYPES: {
+  readonly text: "text";
+  readonly textarea: "textarea";
+  readonly number: "number";
+  readonly boolean: "boolean";
+  readonly select: "select";
+  readonly color: "color";
+  readonly range: "range";
+  readonly dataSource: "dataSource";
+  readonly resource: "resource";
+  readonly image: "image";
+  readonly alignment: "alignment";
+  readonly slider: "slider";
+  readonly colorPicker: "colorPicker";
+  readonly sectionHeader: "sectionHeader";
+  readonly separator: "separator";
+  readonly buttonGroup: "buttonGroup";
+  readonly colorSelect: "colorSelect";
+  readonly sectionLayoutSelect: "sectionLayoutSelect";
+  readonly background: "background";
+  readonly contentPosition: "contentPosition";
+  readonly textSizeSelect: "textSizeSelect";
+  readonly cssUnit: "cssUnit";
+  readonly fontPicker: "fontPicker";
+  readonly stringArray: "stringArray";
+  readonly borderRadius: "borderRadius";
+  readonly screenPicker: "screenPicker";
+};
 /**
-* Creates a FluidSDKConfig with sensible defaults.
-*
-* Default behavior:
-* - baseUrl: reads from `VITE_API_URL` env var, falls back to `""` (same-origin relative)
-* - Auth: relies on session cookies sent via `credentials: 'include'`
-*
-* Pass overrides to customize any field:
-* ```ts
-* const config = createDefaultFluidConfig({ baseUrl: "https://my-api.example.com" });
-* ```
+* Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.
+* @see deriving-typeof-for-object-keys pattern
 */
-declare function createDefaultFluidConfig(overrides?: Partial<FluidSDKConfig>): FluidSDKConfig;
+type PropertyFieldType = (typeof PROPERTY_FIELD_TYPES)[keyof typeof PROPERTY_FIELD_TYPES];
 /**
-* Creates a FluidAuthConfig with sensible defaults.
-*
-* The SDK's FluidAuthProvider already applies defaults for all fields,
-* so an empty config works out of the box. Use overrides to customize:
-* ```ts
-* const config = createDefaultAuthConfig({ onAuthFailure: () => navigate("/login") });
-* ```
+* Runtime validation for property field types.
+* @param value - The value to check
+* @returns true if value is a valid PropertyFieldType
 */
-declare function createDefaultAuthConfig(overrides?: Partial<FluidAuthConfig>): FluidAuthConfig;
-//#endregion
-//#region src/hooks/use-fluid-api.d.ts
+declare function isPropertyFieldType(value: string): value is PropertyFieldType;
 /**
-* Hook to access the Fluid API client
-*
-* @example
-* ```tsx
-* function UserInfo() {
-*   const api = useFluidApi();
-*
-*   const { data: user } = useQuery({
-*     queryKey: ["me"],
-*     queryFn: () => api.users.me(),
-*   });
-*
-*   return <p>Hello, {user?.name}</p>;
-* }
-* ```
+* Base schema for a property field
 */
-declare function useFluidApi(): FluidClient;
-//#endregion
-//#region src/hooks/use-fluid-profile.d.ts
+interface PropertyFieldSchema {
+  /** Property key in the widget props */
+  key: string;
+  /** Display label for the field */
+  label: string;
+  /** Field type determines the input control */
+  type: PropertyFieldType;
+  /** Optional description/help text */
+  description?: string;
+  /** Optional default value */
+  defaultValue?: unknown;
+  /** Optional tab ID (must match a TabConfig id if widget has tabsConfig) */
+  tab?: string;
+  /** Optional group for organizing fields within a tab */
+  group?: string;
+  /**
+  * @deprecated Use requiresKeyValue instead
+  */
+  requiresKeyToBeTrue?: string;
+  /** Optional requires a specific key to have a specific value. Supports single condition or array (AND logic). */
+  requiresKeyValue?: {
+    key: string;
+    value: unknown;
+  } | Array<{
+    key: string;
+    value: unknown;
+  }>;
+}
 /**
-* Base query key for profile data.
-* Kept for backwards compatibility — the runtime key used by the hook
-* includes a company prefix via {@link useCompanyScopedQueryKey}.
-*
-* @deprecated Use {@link APP_DATA_QUERY_KEY} with `useFluidApp` instead.
+* Text field schema
 */
-declare const PROFILE_QUERY_KEY: readonly ["fluid", "profile"];
+interface TextFieldSchema extends PropertyFieldSchema {
+  type: "text";
+  placeholder?: string;
+  maxLength?: number;
+}
 /**
-* Hook to fetch the portal profile (themes, navigation, screens).
-*
-* Internally fetches from the fluidos API (same data source as
-* {@link useFluidApp}) and selects the `profile` slice, so no
-* legacy `/api/rep_app/manifest` call is made.
-*
-* @deprecated Use `useFluidApp()` instead — it returns the full
-* `RepAppData` including `profile`, `screens`, and more.
-*
-* @example
-* ```tsx
-* function Navigation() {
-*   const { data: profile, isLoading } = useFluidProfile();
-*
-*   if (isLoading) return <Spinner />;
-*
-*   return (
-*     <nav>
-*       {profile?.navigation.navigation_items.map(item => (
-*         <NavItem key={item.id} item={item} />
-*       ))}
-*     </nav>
-*   );
-* }
-* ```
+* Textarea field schema
 */
-declare function useFluidProfile(): UseQueryResult<Profile>;
-//#endregion
-//#region src/hooks/use-fluid-app.d.ts
+interface TextareaFieldSchema extends PropertyFieldSchema {
+  type: "textarea";
+  placeholder?: string;
+  rows?: number;
+  maxLength?: number;
+}
 /**
-* Base query key for full app data (fluidos endpoint).
-* Kept for backwards compatibility — the runtime key used by the hook
-* includes a company prefix via {@link useCompanyScopedQueryKey}.
+* Number field schema
 */
-declare const APP_DATA_QUERY_KEY: readonly ["fluid", "app"];
+interface NumberFieldSchema extends PropertyFieldSchema {
+  type: "number";
+  min?: number;
+  max?: number;
+  step?: number;
+}
 /**
-* Hook to fetch the full portal app data from the fluidos API.
-*
-* Returns a `RepAppData` object containing:
-* - `screens` — all screen definitions with normalized component trees
-* - `profile.themes` — fully-transformed ThemeDefinition[] (handles legacy + new formats)
-* - `profile.activeThemeId` — the currently active theme ID
-* - `profile.navigation.navigation_items` — sorted, recursive navigation tree
-*
-* Uses IndexedDB persistence so subsequent page loads hydrate instantly
-* from cache while revalidating in the background. The raw API response
-* (plain JSON) is cached; Color objects are recreated from cache via
-* `select` on every restore — this is fast (CPU only, no network).
-*
-* @example
-* ```tsx
-* function App() {
-*   const { data: appData, isLoading } = useFluidApp();
-*
-*   if (isLoading) return <Spinner />;
-*
-*   return (
-*     <AppShell
-*       appData={appData}
-*       navigation={appData.profile.navigation.navigation_items}
-*     />
-*   );
-* }
-* ```
+* Boolean field schema
 */
-declare function useFluidApp(options?: {
-  enabled?: boolean;
-}): UseQueryResult<RepAppData>;
-//#endregion
-//#region src/hooks/use-fluid-permissions.d.ts
+interface BooleanFieldSchema extends PropertyFieldSchema {
+  type: "boolean";
+}
 /**
-* Base query key for permissions data.
-* Kept for backwards compatibility — the runtime key used by the hook
-* includes a company prefix via {@link useCompanyScopedQueryKey}.
+* Select field schema with type-safe option values.
+* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
 */
-declare const PERMISSIONS_QUERY_KEY: readonly ["fluid", "permissions"];
+interface SelectFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
+  type: "select";
+  options: Array<{
+    label: string;
+    value: T;
+  }>;
+  defaultValue?: T;
+}
 /**
-* Result of useFluidPermissions hook
+* Color field schema
 */
-interface UseFluidPermissionsResult {
-  /** Raw permissions query result */
-  query: UseQueryResult<UserPermissions>;
-  /** Permissions data (alias for query.data) */
-  permissions: UserPermissions | undefined;
-  /** Check if user has a specific permission */
-  can: (resource: string, action?: PermissionAction) => boolean;
-  /** Check if user is a super admin */
-  isSuperAdmin: boolean;
+interface ColorFieldSchema extends PropertyFieldSchema {
+  type: "color";
 }
 /**
-* Hook to fetch and check user permissions
-*
-* @example
-* ```tsx
-* function TeamSettings() {
-*   const { can, isSuperAdmin } = useFluidPermissions();
-*
-*   if (!can("team", "manage")) {
-*     return <AccessDenied />;
-*   }
-*
-*   return <TeamSettingsForm canDelete={can("team", "delete")} />;
-* }
-* ```
+* Range slider field schema
 */
-declare function useFluidPermissions(): UseFluidPermissionsResult;
-//#endregion
-//#region src/hooks/use-fluid-theme.d.ts
+interface RangeFieldSchema extends PropertyFieldSchema {
+  type: "range";
+  min: number;
+  max: number;
+  step?: number;
+}
 /**
-* Result of useFluidTheme hook
+* Data source field schema for configuring widget data sources
 */
-interface UseFluidThemeResult {
-  /** Currently active theme */
-  currentTheme: ThemeDefinition | null;
-  /** Switch to a different theme */
-  setTheme: (theme: ThemeDefinition) => void;
-  /** Switch between light and dark mode */
-  setThemeMode: (mode: "light" | "dark") => void;
-  /** Current theme mode (convenience accessor) */
-  mode: "light" | "dark" | undefined;
+interface DataSourceFieldSchema extends PropertyFieldSchema {
+  type: "dataSource";
 }
 /**
-* Hook to access and control theme settings
-*
-* @example
-* ```tsx
-* function ThemeSwitcher({ themes }: { themes: ThemeDefinition[] }) {
-*   const { currentTheme, setTheme, setThemeMode, mode } = useFluidTheme();
-*
-*   return (
-*     <div>
-*       <select
-*         value={currentTheme?.name}
-*         onChange={(e) => {
-*           const theme = themes.find(t => t.name === e.target.value);
-*           if (theme) setTheme(theme);
-*         }}
-*       >
-*         {themes.map(theme => (
-*           <option key={theme.name} value={theme.name}>
-*             {theme.name}
-*           </option>
-*         ))}
-*       </select>
-*
-*       <button onClick={() => setThemeMode(mode === "dark" ? "light" : "dark")}>
-*         Toggle {mode === "dark" ? "Light" : "Dark"} Mode
-*       </button>
-*     </div>
-*   );
-* }
-* ```
+* Resource field schema for selecting a single resource from the selection modal
 */
-declare function useFluidTheme(): UseFluidThemeResult;
-//#endregion
-//#region src/hooks/use-current-rep.d.ts
+interface ResourceFieldSchema extends PropertyFieldSchema {
+  type: "resource";
+  /** Optional filter to specific shareable types */
+  allowedTypes?: string[];
+}
 /**
-* Base query key for current rep data.
-* Kept for backwards compatibility — the runtime key used by the hook
-* includes a company prefix via {@link useCompanyScopedQueryKey}.
+* Image field schema for selecting a single image from the image picker
 */
-declare const CURRENT_REP_QUERY_KEY: readonly ["fluid", "currentRep"];
+interface ImageFieldSchema extends PropertyFieldSchema {
+  type: "image";
+}
 /**
-* Hook to fetch the currently authenticated rep's profile
-*
-* @example
-* ```tsx
-* function RepHeader() {
-*   const { data: rep, isLoading } = useCurrentRep();
-*
-*   if (isLoading) return <Skeleton />;
-*
-*   return (
-*     <div>
-*       <Avatar src={rep?.avatar_url} />
-*       <span>{rep?.first_name} {rep?.last_name}</span>
-*     </div>
-*   );
-* }
-* ```
+* Alignment field schema
 */
-declare function useCurrentRep(): UseQueryResult<Rep>;
-//#endregion
-//#region src/hooks/use-current-user.d.ts
+interface AlignmentFieldSchema extends PropertyFieldSchema {
+  type: "alignment";
+  options: {
+    verticalEnabled: boolean;
+    horizontalEnabled: boolean;
+  };
+  defaultValue?: AlignOptions;
+}
 /**
-* Base query key for current user data.
-* Kept for backwards compatibility — the runtime key used by the hook
-* includes a company prefix via {@link useCompanyScopedQueryKey}.
+* Slider field schema with optional unit suffix (e.g., "rem", "px")
 */
-declare const CURRENT_USER_QUERY_KEY: readonly ["fluid", "currentUser"];
+interface SliderFieldSchema extends PropertyFieldSchema {
+  type: "slider";
+  min: number;
+  max: number;
+  step?: number;
+  unit?: string;
+}
 /**
-* Hook to fetch the currently authenticated user's full profile.
-* Returns company, country, and other fields from GET /api/me.
-*
-* @example
-* ```tsx
-* function ShopPage() {
-*   const { data: user, isLoading } = useCurrentUser();
-*   const subdomain = user?.company?.subdomain;
-*   const countryIso = user?.country?.iso ?? "US";
-*   // ...
-* }
-* ```
+* Color picker field schema with optional swatches
 */
-declare function useCurrentUser(): UseQueryResult<UserMe>;
-//#endregion
-//#region src/hooks/use-fluid-auth.d.ts
+interface ColorPickerFieldSchema extends PropertyFieldSchema {
+  type: "colorPicker";
+  swatches?: string[];
+}
 /**
-* Hook to access authentication state and utilities.
-*
-* Must be used within a `FluidAuthProvider`.
-*
-* @returns Authentication context with user info, loading state, and utilities
-* @throws Error if used outside FluidAuthProvider
-*
-* @example
-* ```tsx
-* function UserProfile() {
-*   const { isAuthenticated, isLoading, user, clearAuth } = useFluidAuth();
-*
-*   if (isLoading) {
-*     return <Spinner />;
-*   }
-*
-*   if (!isAuthenticated) {
-*     return <p>Please log in</p>;
-*   }
-*
-*   return (
-*     <div>
-*       <p>Welcome, {user.full_name}!</p>
-*       <button onClick={clearAuth}>Log out</button>
-*     </div>
-*   );
-* }
-* ```
+* Section header field schema for visual grouping
 */
-declare function useFluidAuth(): FluidAuthContextValue;
-//#endregion
-//#region src/hooks/use-user-type.d.ts
-interface UseUserTypeResult {
-  userType: UserType | null;
-  isCustomer: boolean;
-  isRep: boolean;
-  isAdmin: boolean;
+interface SectionHeaderFieldSchema extends PropertyFieldSchema {
+  type: "sectionHeader";
+  subtitle?: string;
 }
 /**
-* Convenience hook for user-type checks in the portal SDK.
+* Separator field schema for visual separation
 */
-declare function useUserType(): UseUserTypeResult;
-//#endregion
-//#region src/hooks/query-keys.d.ts
+interface SeparatorFieldSchema extends PropertyFieldSchema {
+  type: "separator";
+}
 /**
-* Create a company-scoped query key by prepending ["company", companyId].
-*
-* @param companyId - The company ID from the JWT payload
-* @param baseKey - The base query key segments (e.g. ["fluid", "profile"])
-* @returns A tuple like ["company", 42, "fluid", "profile"]
-*
-* @example
-* ```ts
-* const key = createCompanyQueryKey(42, "fluid", "profile");
-* // => ["company", 42, "fluid", "profile"]
-* ```
+* Button group field schema.
+* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
 */
-declare function createCompanyQueryKey(companyId: number, ...baseKey: readonly string[]): readonly ["company", number, ...string[]];
-/**
-* Hook that returns a `scopeKey` function bound to the current company ID
-* from the auth context. If the user is not authenticated or has no
-* company_id, the base key is returned unscoped (graceful degradation).
-*
-* @example
-* ```tsx
-* function MyComponent() {
-*   const { scopeKey } = useCompanyScopedQueryKey();
-*   const queryKey = scopeKey(PROFILE_QUERY_KEY);
-*   // => ["company", 42, "fluid", "profile"]  (when authenticated)
-*   // => ["fluid", "profile"]                  (fallback)
-* }
-* ```
-*/
-declare function useCompanyScopedQueryKey(): {
-  readonly companyId: number | undefined;
-  readonly scopeKey: <T extends readonly string[]>(baseKey: T) => readonly (string | number)[];
-};
-//#endregion
-//#region src/hooks/use-logout.d.ts
-interface UseLogoutOptions {
-  /** URL to redirect to after logout. Triggers a full page navigation. */
-  redirectUrl?: string;
-  /** Callback invoked after all state is cleared. Ignored when `redirectUrl` is set. */
-  onLogout?: () => void;
+interface ButtonGroupFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
+  type: "buttonGroup";
+  options: Array<{
+    label?: string;
+    icon?: LucideIcon;
+    value: T;
+  }>;
+  defaultValue?: T;
 }
 /**
-* Hook that returns a `logout` function which clears the server session
-* via `DELETE /logout` and all cached/persisted client state.
-*
-* @example
-* ```tsx
-* const logout = useLogout({ redirectUrl: "/login" });
-* <button onClick={logout}>Log out</button>
-* ```
-*
-* @example
-* ```tsx
-* const logout = useLogout({
-*   onLogout: () => navigate("/signed-out"),
-* });
-* ```
+* Color select field schema
 */
-declare function useLogout({
-  redirectUrl,
-  onLogout
-}?: UseLogoutOptions): () => Promise<void>;
-//#endregion
-//#region src/hooks/use-company-switch.d.ts
-interface UseCompanySwitchOptions {}
+interface ColorSelectFieldSchema extends PropertyFieldSchema {
+  type: "colorSelect";
+  defaultValue?: ColorOptions;
+  excludeColors?: ColorOptions[];
+}
 /**
-* Hook that handles company switching for the portal.
-*
-* Calls PUT /api/authentication/company/{id}/switch, clears the TanStack
-* Query cache and IndexedDB persisted cache, then reloads the page so all
-* queries re-fetch with the new company context.
-*
-* The server updates the session cookie automatically via the switch
-* endpoint response; no client-side token storage is needed.
+* Section layout select field schema for visual masonry layout selector
 */
-declare function useCompanySwitch(_options?: UseCompanySwitchOptions): {
-  switchCompany: (companyId: number) => void;
-  isPending: boolean;
-  isError: boolean;
-  error: Error | null;
-};
-//#endregion
-//#region src/hooks/hook-types.d.ts
+interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {
+  type: "sectionLayoutSelect";
+  defaultValue?: SectionLayoutType;
+}
 /**
-* Hook type utilities and type predicates.
-*
-* This module provides:
-* - Generic hook result types with default type parameters
-* - Type predicates for query state narrowing
-* - Reusable patterns for type-safe property access in hooks
-*
-* Following generics best practices:
-* - generics-default-type-parameters: Default E to Error for common case
-* - generics-type-predicates: Type predicates for result state narrowing
-* - generics-constrain-type-parameters: K extends keyof T for property access
+* Background field combines resource selection and color properties.
+* Uses StrictOmit to exclude conflicting "type" discriminant from parents.
 */
+interface BackgroundFieldSchema extends StrictOmit<ResourceFieldSchema, "type">, StrictOmit<ColorFieldSchema, "type"> {
+  type: "background";
+}
 /**
-* Base result type for query hooks with default error type.
-* Uses default type parameter for E (generics-default-type-parameters rule).
-*
-* @typeParam T - The data type
-* @typeParam E - The error type (defaults to Error)
-*
-* @example
-* // Error type defaults to Error
-* type UsersResult = QueryResult<User[]>;
-*
-* // Can override when needed
-* type CustomResult = QueryResult<User[], ApiError>;
+* Content position field schema for 3x3 grid position picker
 */
-interface QueryResult<T, E = Error> {
-  readonly data: T;
-  readonly isLoading: boolean;
-  readonly isError: boolean;
-  readonly error?: E | undefined;
+interface ContentPositionFieldSchema extends PropertyFieldSchema {
+  type: "contentPosition";
+  defaultValue?: string;
 }
 /**
-* Result type for hooks that may not have data yet.
-* Extends QueryResult with nullable data.
-*
-* @typeParam T - The data type
-* @typeParam E - The error type (defaults to Error)
+* Text size select field schema for visual font size selector
 */
-interface QueryResultNullable<T, E = Error> {
-  readonly data: T | null | undefined;
-  readonly isLoading: boolean;
-  readonly isError: boolean;
-  readonly error?: E | undefined;
+interface TextSizeSelectFieldSchema extends PropertyFieldSchema {
+  type: "textSizeSelect";
+  defaultValue?: FontSizeOptions;
 }
 /**
-* Result type for list/collection hooks with aggregates.
-*
-* @typeParam T - The item type in the array
-* @typeParam E - The error type (defaults to Error)
+* CSS unit type for height/width fields
 */
-interface ListQueryResult<T, E = Error> extends QueryResult<T[], E> {
-  readonly totalCount: number;
-}
+type CssUnit = "px" | "rem" | "vh" | "%";
 /**
-* Result type for list hooks with value aggregation (e.g., deals with total value).
-*
-* @typeParam T - The item type in the array
-* @typeParam E - The error type (defaults to Error)
+* CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
 */
-interface ValueListQueryResult<T, E = Error> extends ListQueryResult<T, E> {
-  readonly totalValue: number;
+interface CssUnitFieldSchema extends PropertyFieldSchema {
+  type: "cssUnit";
+  minByUnit?: Partial<Record<CssUnit, number>>;
+  maxByUnit?: Partial<Record<CssUnit, number>>;
+  stepByUnit?: Partial<Record<CssUnit, number>>;
+  allowedUnits?: CssUnit[];
+  defaultUnit?: CssUnit;
 }
 /**
-* Type predicate to check if a query result has successfully loaded data.
-* Narrows the data type from T | null | undefined to T.
-*
-* @example
-* const result = useContact(id);
-* if (hasData(result)) {
-*   // TypeScript knows result.data is Contact, not Contact | null
-*   console.log(result.data.name);
-* }
+* Font picker field schema for Google Fonts selection
 */
-declare function hasData<T, E = Error>(result: QueryResultNullable<T, E>): result is QueryResultNullable<T, E> & {
-  readonly data: T;
-};
+interface FontPickerFieldSchema extends PropertyFieldSchema {
+  type: "fontPicker";
+  placeholder?: string;
+}
 /**
-* Type predicate to check if a query result is in loading state.
-* Useful for conditional rendering.
-*
-* @example
-* if (isLoading(result)) {
-*   return <Spinner />;
-* }
+* String array field schema for managing lists of text items
 */
-declare function isLoading<T, E = Error>(result: QueryResult<T, E> | QueryResultNullable<T, E>): boolean;
+interface StringArrayFieldSchema extends PropertyFieldSchema {
+  type: "stringArray";
+  placeholder?: string;
+  defaultValue?: string[];
+}
 /**
-* Type predicate to check if a query result has an error.
-* Narrows to include the error property.
-*
-* @example
-* if (isErrorResult(result)) {
-*   console.error(result.error); // error is E, not undefined
-* }
+* Border radius composite field schema for controlling 4 corners with a single field.
+* Maps to 4 individual widget prop keys (topLeft, topRight, bottomLeft, bottomRight).
 */
-declare function isErrorResult<T, E = Error>(result: QueryResult<T, E> | QueryResultNullable<T, E>): result is (QueryResult<T, E> | QueryResultNullable<T, E>) & {
-  readonly isError: true;
-  readonly error: E;
-};
+interface BorderRadiusFieldSchema extends PropertyFieldSchema {
+  type: "borderRadius";
+  keys: {
+    topLeft: string;
+    topRight: string;
+    bottomLeft: string;
+    bottomRight: string;
+  };
+  defaultValue?: BorderRadiusOptions;
+}
 /**
-* Type predicate to check if a query result is in idle state (not loading, no error, has data).
-*
-* @example
-* if (isIdle(result)) {
-*   // Safe to access and render data
-* }
+* Screen picker field schema for selecting a portal screen (navigation, system, or available)
 */
-declare function isIdle<T, E = Error>(result: QueryResult<T, E> | QueryResultNullable<T, E>): boolean;
+interface ScreenPickerFieldSchema extends PropertyFieldSchema {
+  type: "screenPicker";
+  /** Whether to include system navigation items in the picker */
+  includeSystemItems?: boolean;
+}
 /**
-* Type-safe property selector for hook results.
-* Uses K extends keyof T constraint (generics-function-constraints rule).
-*
-* @typeParam T - The data object type
-* @typeParam K - Key of T (constrained to actual keys)
-*
-* @example
-* const users = [{ name: "Alice", age: 30 }];
-* const names = selectProperty(users, "name"); // string[]
-* const ages = selectProperty(users, "age");   // number[]
-* selectProperty(users, "invalid"); // Error: "invalid" not in "name" | "age"
+* Union of all field schema types
 */
-declare function selectProperty<T, K extends keyof T>(items: readonly T[], key: K): T[K][];
+type PropertyField = TextFieldSchema | TextareaFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema<string | number> | ColorFieldSchema | RangeFieldSchema | DataSourceFieldSchema | ResourceFieldSchema | ImageFieldSchema | AlignmentFieldSchema | SliderFieldSchema | ColorPickerFieldSchema | SectionHeaderFieldSchema | SeparatorFieldSchema | ButtonGroupFieldSchema<string | number> | ColorSelectFieldSchema | SectionLayoutSelectFieldSchema | BackgroundFieldSchema | ContentPositionFieldSchema | TextSizeSelectFieldSchema | CssUnitFieldSchema | FontPickerFieldSchema | StringArrayFieldSchema | BorderRadiusFieldSchema | ScreenPickerFieldSchema;
 /**
-* Type-safe property getter for a single item.
-* Returns undefined if item is null/undefined.
-*
-* @typeParam T - The data object type
-* @typeParam K - Key of T (constrained to actual keys)
+* Schema for per-item configuration in custom data sources.
+* Widgets can define this to allow users to configure widget-specific
+* settings for each selected item (e.g., title, description, button).
 */
-declare function getProperty<T, K extends keyof T>(item: T | null | undefined, key: K): T[K] | undefined;
+interface ItemConfigSchema {
+  /** Fields available for per-item configuration */
+  fields: PropertyField[];
+  /** Optional description shown at top of item config panel */
+  description?: string;
+}
 /**
-* Generic type for hooks that fetch a single resource by ID.
-* Useful for creating consistent API across different resource types.
-*
-* @typeParam T - The resource type
-* @typeParam E - The error type (defaults to Error)
+* Schema for a widget's editable properties
 */
-type UseSingleResourceHook<T, E = Error> = (id: string) => QueryResultNullable<T, E>;
-/**
-* Generic type for hooks that fetch a list of resources with optional params.
-* Uses generics-default-type-parameters for the params type.
-*
-* @typeParam T - The item type
-* @typeParam P - The params type (defaults to empty object)
-* @typeParam E - The error type (defaults to Error)
-*/
-type UseListResourceHook<T, P extends Record<string, unknown> = Record<string, never>, E = Error> = (params?: P) => ListQueryResult<T, E>;
-/**
-* Transforms a nullable result to a non-nullable one if data exists.
-* Useful when you've already checked hasData().
-*/
-type WithData<R extends QueryResultNullable<unknown>> = R extends QueryResultNullable<infer T, infer E> ? QueryResultNullable<T, E> & {
-  readonly data: T;
-} : never;
-/**
-* Activity slug constants as a const object.
-* Derive the ActivitySlug type from this single source of truth.
-*/
-declare const ACTIVITY_SLUGS: {
-  readonly abandonedCart: "abandoned_cart";
-  readonly announcements: "announcements";
-  readonly cartItemsAdded: "cart_items_added";
-  readonly commentReply: "comment_reply";
-  readonly directMessage: "direct_message";
-  readonly fantasyPoint: "fantasy_point";
-  readonly newLead: "new_lead";
-  readonly orderPlaced: "order_placed";
-  readonly pageViews: "page_views";
-  readonly pageViewsContact: "page_views_contact";
-  readonly tasks: "tasks";
-  readonly upcomingEvent: "upcoming_event";
-  readonly video: "video";
-  readonly videoComplete: "video_complete";
-  readonly videoCompleteContact: "video_complete_contact";
-  readonly videoContact: "video_contact";
-  readonly messageReceived: "message_received";
-  readonly messageSent: "message_sent";
-  readonly newCartItemsAdded: "new_cart_items_added";
-  readonly smartLinkClicked: "smart_link_clicked";
-  readonly reviewLeft: "review_left";
-};
-/** Activity slug union type derived from ACTIVITY_SLUGS constant. */
-type ActivitySlug = (typeof ACTIVITY_SLUGS)[keyof typeof ACTIVITY_SLUGS];
-/** Type predicate to check if a string is a valid ActivitySlug. */
-declare function isActivitySlug(value: string): value is ActivitySlug;
-/** Transformed activity for display. */
-interface Activity {
-  readonly id: number;
-  readonly userName: string;
-  readonly avatarUrl: string | null;
-  readonly activityType: string;
-  readonly targetName: string;
-  readonly timestamp: string;
-  readonly slug: ActivitySlug;
-}
-/** Description/rich text metadata for a calendar event. */
-interface CalendarEventDescription {
-  readonly id?: number | null;
-  readonly name?: string | null;
-  readonly body?: string | null;
-  readonly record_type?: string | null;
-  readonly record_id?: number | null;
-  readonly created_at?: string | null;
-  readonly updated_at?: string | null;
-  readonly locale?: string | null;
-}
-/** Calendar event data from the API. */
-interface CalendarEvent {
-  readonly id: number;
-  readonly title: string;
-  readonly description?: CalendarEventDescription | null;
-  readonly color?: string | null;
-  readonly url?: string | null;
-  readonly start: string;
-  readonly end: string;
-  readonly active?: boolean | null;
-  readonly time_zone?: string | null;
-  readonly status?: string | null;
-  readonly image_url?: string | null;
-  readonly images?: readonly unknown[] | null;
-  readonly venue?: string | null;
-  readonly countries?: readonly string[] | null;
-  readonly hasTomorrow?: boolean | null;
-  readonly hasYesterday?: boolean | null;
-  readonly isAllDay?: boolean;
-}
-/** Catch up suggestion data from the API. */
-interface CatchUp {
-  readonly id: number;
-  readonly suggestion_title: string;
-}
-/** MySite data returned by the hook. */
-interface MySiteData {
-  readonly url: string | null;
-  readonly views: number;
-  readonly leads: number;
-  readonly userName: string;
-}
-/** Transformed todo for display. */
-interface Todo {
-  readonly id: number;
-  readonly body: string;
-  readonly dueAt: string | null;
-  readonly completedAt: string | null;
-  readonly createdAt: string;
-  readonly contactName: string | null;
+interface WidgetPropertySchema {
+  /** Widget type this schema applies to */
+  widgetType: WidgetType;
+  /** Display name for the widget */
+  displayName: string;
+  /** Optional tab configuration - if present, tabs are enabled */
+  tabsConfig?: TabConfig[];
+  /** Editable property fields */
+  fields: PropertyField[];
+  /** Optional custom validator function */
+  validate?: (props: Record<string, unknown>) => string | null;
+  /** Props that can be populated from data sources */
+  dataSourceTargetProps?: string[];
+  /** Optional schema for per-item configurations in custom data sources */
+  itemConfigSchema?: ItemConfigSchema;
 }
 //#endregion
-//#region src/hooks/use-calendar-events.d.ts
-/**
-* Result type for useCalendarEvents hook.
-* Uses QueryResult<CalendarEvent[]> with default Error type.
-*/
-type UseCalendarEventsResult = QueryResult<CalendarEvent[]>;
-/**
-* Hook to fetch calendar events.
-* This is a stub implementation - override with your own data fetching logic.
-*/
-declare function useCalendarEvents(): UseCalendarEventsResult;
-//#endregion
-//#region src/hooks/use-todos.d.ts
-/**
-* Result type for useTodos hook.
-* Uses QueryResult<Todo[]> with default Error type.
-*/
-type UseTodosResult = QueryResult<Todo[]>;
-/**
-* Hook to fetch todo items.
-* This is a stub implementation - override with your own data fetching logic.
-*/
-declare function useTodos(): UseTodosResult;
-//#endregion
-//#region src/hooks/use-activities.d.ts
-/**
-* Result type for useActivities hook.
-* Uses QueryResult generic with Activity[] and default Error type.
-*/
-type UseActivitiesResult = QueryResult<Activity[]>;
+//#region ../core/src/registries/field-helpers.d.ts
 /**
-* Hook to fetch recent activities.
-* This is a stub implementation - override with your own data fetching logic.
+* Gap value mapping - use `as const satisfies` for compile-time validation
+* with literal type preservation.
 */
-declare function useActivities(): UseActivitiesResult;
+declare const gapValues: {
+  readonly none: 0;
+  readonly xs: 1;
+  readonly sm: 2;
+  readonly md: 4;
+  readonly lg: 6;
+  readonly xl: 8;
+};
 //#endregion
-//#region src/hooks/use-catchups.d.ts
-/**
-* Result type for useCatchUps hook.
-* Uses QueryResult<CatchUp[]> with default Error type.
-*/
-type UseCatchUpsResult = QueryResult<CatchUp[]>;
+//#region ../core/src/registries/container-types.d.ts
 /**
-* Hook to fetch catch up items.
-* This is a stub implementation - override with your own data fetching logic.
+* Interface for container widget behavior.
+* Container widgets can hold and manage child widgets.
+* Note: Children can be null for sparse arrays (e.g., grid layouts with empty cells)
 */
-declare function useCatchUps(): UseCatchUpsResult;
+interface ContainerWidgetBehavior {
+  /** Identifies this widget type as a container */
+  isContainer: true;
+  /** Gets children from the widget's props */
+  getChildren: (props: Record<string, unknown>) => (WidgetSchema | null)[];
+  /** Creates new props with updated children */
+  setChildren: (props: Record<string, unknown>, children: (WidgetSchema | null)[]) => Record<string, unknown>;
+  /** Optional: Check if this container accepts a specific widget type */
+  canAcceptChild?: (childType: string) => boolean;
+}
 //#endregion
-//#region src/hooks/use-mysite.d.ts
-/**
-* Result type for useMySite hook.
-* Uses QueryResultNullable since MySite data may not be available.
-*/
-type UseMySiteResult = QueryResultNullable<MySiteData>;
+//#region ../core/src/registries/widget-manifest.d.ts
 /**
-* Hook to fetch MySite data.
-* This is a stub implementation - override with your own data fetching logic.
+* The manifest a plugin author provides to register a custom widget.
+* Required fields ensure the widget works in both builder and SDK contexts.
+* Optional fields enable advanced behavior (containers, min SDK version).
 */
-declare function useMySite(): UseMySiteResult;
+interface WidgetManifest {
+  /** Schema version for forward compatibility. Currently must be 1. */
+  manifestVersion: number;
+  /** Unique widget type identifier (e.g., "StockTickerWidget"). */
+  type: string;
+  /** The React component that renders this widget. */
+  component: AnyComponent;
+  /** Human-readable name shown in the builder palette. */
+  displayName: string;
+  /** Brief description shown in the builder palette. */
+  description: string;
+  /** Icon identifier for the builder palette (e.g., "chart-line"). */
+  icon: string;
+  /** Category ID for palette grouping (e.g., "components", "blocks", "utility"). */
+  category: string;
+  /** Property schema defining editable fields in the builder's property panel. */
+  propertySchema: WidgetPropertySchema;
+  /** Default prop values when the widget is first created. */
+  defaultProps: Record<string, unknown>;
+  /** Container behavior — only if this widget can hold child widgets. */
+  container?: ContainerWidgetBehavior;
+  /** Minimum SDK version required (e.g., "1.0.0"). */
+  minSdkVersion?: string;
+  /** Resizable configuration. */
+  resizable?: {
+    horizontal?: boolean;
+    vertical?: boolean;
+    minWidth?: number;
+    minHeight?: number;
+  };
+}
 //#endregion
-//#region src/hooks/use-conversations.d.ts
-/**
-* Result type for useConversations hook.
-* Uses QueryResult<Conversation[]> with default Error type.
-*/
-type UseConversationsResult = QueryResult<Conversation[]>;
+//#region src/entry/create-portal.d.ts
 /**
-* Hook to fetch all conversations.
-* This is a stub implementation - override with your own data fetching logic.
+* Configuration for `createPortal()`.
 *
-* @returns UseConversationsResult with empty data array
+* Provides a single-call entry point that sets up the full provider hierarchy
+* (auth, SDK, shell) with sensible defaults. Every field is optional.
 *
-* @example
+* For full control, skip `createPortal()` and compose providers manually:
 * ```tsx
-* const { data: conversations, isLoading, isError } = useConversations();
-*
-* if (isLoading) return <Loading />;
-* if (isError) return <Error />;
-*
-* return conversations.map(conv => <ConversationItem key={conv.id} {...conv} />);
+* import { FluidAuthProvider, FluidProvider, RequireAuth, AppShell } from "@fluid-app/portal-sdk";
 * ```
 */
-declare function useConversations(): UseConversationsResult;
-/**
-* Result type for useConversationMessages hook.
-* Uses QueryResult<Message[]> with default Error type.
-*/
-type UseConversationMessagesResult = QueryResult<Message[]>;
+interface PortalConfig {
+  /** Custom page components keyed by navigation slug */
+  customPages?: Record<string, ComponentType<{
+    slug?: string;
+    params?: string;
+  }>>;
+  /** Custom widget manifests (type + component + propertySchema) */
+  customWidgets?: WidgetManifest[];
+  /** API client config overrides (merged with defaults) */
+  fluid?: Partial<FluidSDKConfig>;
+  /** Auth config overrides (merged with defaults) */
+  auth?: Partial<FluidAuthConfig>;
+  /** Root element ID. @default "root" */
+  rootId?: string;
+  /** AppShell props passthrough (basePath, sidebarHeader, etc.) */
+  shell?: Omit<AppShellProps, "customPages">;
+  /** Wrap AppShell with additional providers (inserted inside RequireAuth, below FluidProvider) */
+  providers?: ComponentType<{
+    children: ReactNode;
+  }>;
+  /** Disable StrictMode. @default false */
+  disableStrictMode?: boolean;
+}
 /**
-* Hook to fetch messages for a specific conversation.
-* This is a stub implementation - override with your own data fetching logic.
+* Bootstrap a Fluid portal with a single function call.
 *
-* @param conversationId - The ID of the conversation to fetch messages for
-* @returns UseConversationMessagesResult with empty data array
+* Sets up the full provider hierarchy (FluidAuthProvider → FluidProvider → RequireAuth → AppShell)
+* and renders into the DOM.
 *
-* @example
-* ```tsx
-* const { data: messages, isLoading, isError } = useConversationMessages(conversationId);
+* @example Minimal usage
+* ```ts
+* import { createPortal } from "@fluid-app/portal-sdk";
+* import "./index.css";
 *
-* if (isLoading) return <Loading />;
-* if (isError) return <Error />;
+* createPortal();
+* ```
 *
-* return messages.map(msg => <MessageBubble key={msg.id} {...msg} />);
+* @example With custom pages
+* ```ts
+* import { createPortal } from "@fluid-app/portal-sdk";
+* import { customPages } from "./portal.config";
+* import "./index.css";
+*
+* createPortal({ customPages });
+* ```
+*
+* @example With overrides
+* ```ts
+* createPortal({
+*   customPages,
+*   fluid: { baseUrl: "https://my-api.example.com" },
+*   auth: { onAuthFailure: () => console.log("auth failed") },
+*   shell: { basePath: "/portal" },
+* });
 * ```
 */
-declare function useConversationMessages(_conversationId: string): UseConversationMessagesResult;
+declare function createPortal(config?: PortalConfig): void;
 //#endregion
-//#region src/hooks/use-contacts.d.ts
-/**
-* Type predicate to check if a status string is a valid ContactStatus.
-* Enables runtime validation with type narrowing.
-*/
-declare function isContactStatus(value: string): value is ContactStatus;
-/**
-* Parameters for filtering and paginating contacts.
-* Uses readonly properties and proper ContactStatus type for status.
-*/
-interface UseContactsParams {
-  /** Search query to filter contacts by name, email, or company */
-  readonly search?: string;
-  /** Filter contacts by status - uses ContactStatus union type for type safety */
-  readonly status?: ContactStatus;
-  /** Maximum number of contacts to return */
-  readonly limit?: number;
-}
-/**
-* Result type for the useContacts hook.
-* Uses ListQueryResult<Contact> with totalCount and default Error type.
-*/
-type UseContactsResult = ListQueryResult<Contact>;
-/**
-* Result type for the useContact hook.
-* Uses QueryResultNullable since a specific contact may not exist.
-*/
-type UseContactResult = QueryResultNullable<Contact>;
+//#region src/config/defaults.d.ts
 /**
-* Hook to fetch a list of contacts with optional filtering and pagination.
-* This is a stub implementation - override with your own data fetching logic.
+* Creates a FluidSDKConfig with sensible defaults.
 *
-* @param params - Optional parameters for filtering and pagination
-* @returns Object containing contacts data, loading state, error state, and total count
+* Default behavior:
+* - baseUrl: reads from `VITE_API_URL` env var, falls back to `""` (same-origin relative)
+* - Auth: relies on session cookies sent via `credentials: 'include'`
 *
-* @example
-* ```tsx
-* const { data: contacts, isLoading, totalCount } = useContacts({
-*   search: 'john',
-*   status: 'active',
-*   limit: 20
-* });
+* Pass overrides to customize any field:
+* ```ts
+* const config = createDefaultFluidConfig({ baseUrl: "https://my-api.example.com" });
 * ```
 */
-declare function useContacts(_params?: UseContactsParams): UseContactsResult;
+declare function createDefaultFluidConfig(overrides?: Partial<FluidSDKConfig>): FluidSDKConfig;
 /**
-* Hook to fetch a single contact by ID.
-* This is a stub implementation - override with your own data fetching logic.
-*
-* @param contactId - The unique identifier of the contact to fetch
-* @returns Object containing contact data, loading state, and error state
+* Creates a FluidAuthConfig with sensible defaults.
 *
-* @example
-* ```tsx
-* const { data: contact, isLoading, isError } = useContact('contact-123');
+* The SDK's FluidAuthProvider already applies defaults for all fields,
+* so an empty config works out of the box. Use overrides to customize:
+* ```ts
+* const config = createDefaultAuthConfig({ onAuthFailure: () => navigate("/login") });
 * ```
 */
-declare function useContact(_contactId: string): UseContactResult;
+declare function createDefaultAuthConfig(overrides?: Partial<FluidAuthConfig>): FluidAuthConfig;
 //#endregion
-//#region src/components/RequireAuth.d.ts
-interface RequireAuthProps {
-  /** Content to render when authenticated */
-  children: ReactNode;
-  /** Component to show while checking authentication (default: AuthLoading) */
-  fallback?: ReactNode;
-  /** Component to show when not authenticated (default: AuthError) */
-  errorComponent?: ReactNode;
-}
+//#region src/hooks/use-fluid-api.d.ts
 /**
-* Component that protects content requiring authentication.
-*
-* **Important:** This provides UX-level protection only. It prevents
-* unauthenticated users from seeing the UI, but the real security
-* boundary is the server-side API. Client-side auth can always be
-* bypassed by modifying browser state.
-*
-* For defense-in-depth, configure `jwksUrl` in `FluidAuthConfig`
-* to enable client-side JWT signature verification.
-*
-* Shows different states based on auth status:
-* - Loading: Shows fallback (spinner by default)
-* - Not authenticated: Shows errorComponent (AuthError by default)
-* - Authenticated: Shows children
+* Hook to access the Fluid API client
 *
 * @example
 * ```tsx
-* // Basic usage - shows default loading/error states
-* <RequireAuth>
-*   <ProtectedContent />
-* </RequireAuth>
-*
-* // Custom loading state
-* <RequireAuth fallback={<CustomSpinner />}>
-*   <ProtectedContent />
-* </RequireAuth>
+* function UserInfo() {
+*   const api = useFluidApi();
 *
-* // Custom error component
-* <RequireAuth errorComponent={<LoginPrompt />}>
-*   <ProtectedContent />
-* </RequireAuth>
+*   const { data: user } = useQuery({
+*     queryKey: ["me"],
+*     queryFn: () => api.users.me(),
+*   });
 *
-* // Both custom
-* <RequireAuth
-*   fallback={<SkeletonLoader />}
-*   errorComponent={<RedirectToLogin />}
-* >
-*   <Dashboard />
-* </RequireAuth>
+*   return <p>Hello, {user?.name}</p>;
+* }
 * ```
 */
-declare function RequireAuth({
-  children,
-  fallback,
-  errorComponent
-}: RequireAuthProps): React.JSX.Element;
+declare function useFluidApi(): FluidClient;
 //#endregion
-//#region src/components/AuthError.d.ts
-interface AuthErrorProps {
-  /** Error message to display */
-  message?: string;
-  /** Optional title */
-  title?: string;
-  /** Optional children for custom content */
-  children?: ReactNode;
-}
+//#region src/hooks/use-fluid-profile.d.ts
 /**
-* Default authentication error component.
+* Base query key for profile data.
+* Kept for backwards compatibility — the runtime key used by the hook
+* includes a company prefix via {@link useCompanyScopedQueryKey}.
 *
-* Displays a simple error message when authentication fails.
-* Can be customized via props or replaced entirely in RequireAuth.
+* @deprecated Use {@link APP_DATA_QUERY_KEY} with `useFluidApp` instead.
+*/
+declare const PROFILE_QUERY_KEY: readonly ["fluid", "profile"];
+/**
+* Hook to fetch the portal profile (themes, navigation, screens).
+*
+* Internally fetches from the fluidos API (same data source as
+* {@link useFluidApp}) and selects the `profile` slice, so no
+* legacy `/api/rep_app/manifest` call is made.
+*
+* @deprecated Use `useFluidApp()` instead — it returns the full
+* `RepAppData` including `profile`, `screens`, and more.
 *
 * @example
 * ```tsx
-* // Use with default message
-* <AuthError />
+* function Navigation() {
+*   const { data: profile, isLoading } = useFluidProfile();
 *
-* // Use with custom message
-* <AuthError message="Session expired. Please log in again." />
+*   if (isLoading) return <Spinner />;
 *
-* // Use with custom content
-* <AuthError>
-*   <CustomLoginButton />
-* </AuthError>
+*   return (
+*     <nav>
+*       {profile?.navigation.navigation_items.map(item => (
+*         <NavItem key={item.id} item={item} />
+*       ))}
+*     </nav>
+*   );
+* }
 * ```
 */
-declare function AuthError({
-  message,
-  title,
-  children
-}: AuthErrorProps): React.JSX.Element;
+declare function useFluidProfile(): UseQueryResult<Profile>;
+//#endregion
+//#region src/hooks/use-fluid-app.d.ts
 /**
-* Simple loading spinner component for auth loading state.
+* Base query key for full app data (fluidos endpoint).
+* Kept for backwards compatibility — the runtime key used by the hook
+* includes a company prefix via {@link useCompanyScopedQueryKey}.
 */
-declare function AuthLoading(): React.JSX.Element;
-//#endregion
-//#region ../../messaging/core/src/types.d.ts
+declare const APP_DATA_QUERY_KEY: readonly ["fluid", "app"];
 /**
-* Domain types for the messaging package.
+* Hook to fetch the full portal app data from the fluidos API.
 *
-* These are owned by messaging-core and represent the contract that
-* any API adapter (current client, future BFF) must satisfy.
-* Consuming packages import from here — never from the API client directly.
-*/
-interface PaginationObject {
-  pagination: {
-    current: number;
-    previous: number | null;
-    next: number | null;
-    per_page: number;
-    pages: number;
-    count: number;
-  };
-}
-type Paginated<T> = [PaginationObject, {
-  items: T[];
-}];
-interface AttachmentMetadata {
-  width?: number;
-  height?: number;
-}
-interface Attachment {
-  id: number;
-  url: string;
-  filename: string;
-  kind: string;
-  image_url: string | null;
-  image_path: string | null;
-  content_type: string | null;
-  attachable_type: string | null;
-  attachable_id: number | null;
-  thumbnail_url: string | null;
-  metadata: AttachmentMetadata | null;
-  content_size: number | null;
-}
-interface MessageAttachmentInput {
-  url: string;
-  filename: string;
-  kind: string;
-  content_type?: string;
-  content_size?: number;
-  metadata?: AttachmentMetadata;
-}
-interface LinkPreview {
-  url: string;
-  title?: string | null;
-  description?: string | null;
-  images?: string[];
-  videos?: string[];
-  favicon?: string | null;
-  error?: string | null;
-  original_url?: string | null;
-}
-interface InfoMessageRecipient {
-  id: number;
-  first_name: string;
-  last_name: string;
-}
-interface DefaultMessageMetadata {
-  links: LinkPreview[];
-  client_message_id?: string | number | null;
-}
-interface SystemConversationUpdateMetadata {
-  name: string;
-  previous_name: string;
-  client_message_id?: string | number | null;
-  links?: LinkPreview[];
-}
-interface SystemConversationCreatedMetadata {
-  conversation_name: string;
-  description?: string;
-  member_count: number;
-  auto_add_recipients: boolean;
-  client_message_id?: string | number | null;
-  links?: LinkPreview[];
-}
-interface SystemRecipientActionMetadata {
-  recipient_ids_added?: number[];
-  recipient_ids_removed?: number[];
-  recipient_ids_left?: number[];
-  recipient_ids_joined?: number[];
-  recipient_added?: InfoMessageRecipient[];
-  recipient_removed?: InfoMessageRecipient[];
-  recipient_left?: InfoMessageRecipient[];
-  recipient_joined?: InfoMessageRecipient[];
-  client_message_id?: string | number | null;
-  links?: LinkPreview[];
-}
-interface InfoMessageMetadataShape {
-  recipient_added?: InfoMessageRecipient[];
-  recipient_ids_added?: number[];
-  recipient_removed?: InfoMessageRecipient[];
-  recipient_ids_removed?: number[];
-  links?: LinkPreview[];
-  client_message_id?: string | number | null;
-}
-type MessageMetadata = DefaultMessageMetadata | null | SystemConversationUpdateMetadata | SystemConversationCreatedMetadata | SystemRecipientActionMetadata | InfoMessageMetadataShape;
-interface Recipient {
-  id: number;
-  first_name: string;
-  last_name: string;
-  avatar_url: string | null;
-  image_url: string | null;
-  receivable_id: number;
-  receivable_type: "Contact" | "UserCompany";
-  discarded_at: string | null;
-  left_conversation_at: string | null;
-  blocked: boolean | null;
-  country_name: string | null;
-  pro_user: boolean;
-  avatar_background: string | null;
-  email?: string | null;
-  phone?: string | null;
-  status?: "online" | "offline" | "away";
-  last_online?: string | null;
-  "conversation_messaging_enabled?"?: boolean;
-}
-interface ReducedRecipient {
-  id: number;
-  first_name: string;
-  last_name: string;
-  image_url: string | null;
-  discarded_at: string | null;
-  blocked: boolean | null;
-  blocker: boolean | null;
-  avatar_background: string | null;
-  seen_at?: string | null;
-  email?: string | null;
-  phone?: string | null;
-  pro_user?: boolean;
-}
-interface SlimmedRecipient {
-  id: number;
-  first_name: string;
-  last_name: string;
-  discarded_at: string | null;
-  blocked: boolean | null;
-  avatar_background: string | null;
-  email?: string | null;
-  phone?: string | null;
-  removed_at?: string | null;
+* Returns a `RepAppData` object containing:
+* - `screens` — all screen definitions with normalized component trees
+* - `profile.themes` — fully-transformed ThemeDefinition[] (handles legacy + new formats)
+* - `profile.activeThemeId` — the currently active theme ID
+* - `profile.navigation.navigation_items` — sorted, recursive navigation tree
+*
+* Uses IndexedDB persistence so subsequent page loads hydrate instantly
+* from cache while revalidating in the background. The raw API response
+* (plain JSON) is cached; Color objects are recreated from cache via
+* `select` on every restore — this is fast (CPU only, no network).
+*
+* @example
+* ```tsx
+* function App() {
+*   const { data: appData, isLoading } = useFluidApp();
+*
+*   if (isLoading) return <Spinner />;
+*
+*   return (
+*     <AppShell
+*       appData={appData}
+*       navigation={appData.profile.navigation.navigation_items}
+*     />
+*   );
+* }
+* ```
+*/
+declare function useFluidApp(options?: {
+  enabled?: boolean;
+}): UseQueryResult<RepAppData>;
+//#endregion
+//#region src/hooks/use-fluid-permissions.d.ts
+/**
+* Base query key for permissions data.
+* Kept for backwards compatibility — the runtime key used by the hook
+* includes a company prefix via {@link useCompanyScopedQueryKey}.
+*/
+declare const PERMISSIONS_QUERY_KEY: readonly ["fluid", "permissions"];
+/**
+* Result of useFluidPermissions hook
+*/
+interface UseFluidPermissionsResult {
+  /** Raw permissions query result */
+  query: UseQueryResult<UserPermissions>;
+  /** Permissions data (alias for query.data) */
+  permissions: UserPermissions | undefined;
+  /** Check if user has a specific permission */
+  can: (resource: string, action?: PermissionAction) => boolean;
+  /** Check if user is a super admin */
+  isSuperAdmin: boolean;
 }
-interface WithContactRecipient {
-  id: number;
-  email?: string | null;
-  phone?: string | null;
-  first_name?: string | null;
-  last_name?: string | null;
-  image_url: string | null;
-  receivable_id: number;
-  receivable_type: "Contact";
+/**
+* Hook to fetch and check user permissions
+*
+* @example
+* ```tsx
+* function TeamSettings() {
+*   const { can, isSuperAdmin } = useFluidPermissions();
+*
+*   if (!can("team", "manage")) {
+*     return <AccessDenied />;
+*   }
+*
+*   return <TeamSettingsForm canDelete={can("team", "delete")} />;
+* }
+* ```
+*/
+declare function useFluidPermissions(): UseFluidPermissionsResult;
+//#endregion
+//#region src/hooks/use-fluid-theme.d.ts
+/**
+* Result of useFluidTheme hook
+*/
+interface UseFluidThemeResult {
+  /** Currently active theme */
+  currentTheme: ThemeDefinition | null;
+  /** Switch to a different theme */
+  setTheme: (theme: ThemeDefinition) => void;
+  /** Switch between light and dark mode */
+  setThemeMode: (mode: "light" | "dark") => void;
+  /** Current theme mode (convenience accessor) */
+  mode: "light" | "dark" | undefined;
 }
-interface RecipientSearchCount {
-  meta: {
-    count: number;
-  };
+/**
+* Hook to access and control theme settings
+*
+* @example
+* ```tsx
+* function ThemeSwitcher({ themes }: { themes: ThemeDefinition[] }) {
+*   const { currentTheme, setTheme, setThemeMode, mode } = useFluidTheme();
+*
+*   return (
+*     <div>
+*       <select
+*         value={currentTheme?.name}
+*         onChange={(e) => {
+*           const theme = themes.find(t => t.name === e.target.value);
+*           if (theme) setTheme(theme);
+*         }}
+*       >
+*         {themes.map(theme => (
+*           <option key={theme.name} value={theme.name}>
+*             {theme.name}
+*           </option>
+*         ))}
+*       </select>
+*
+*       <button onClick={() => setThemeMode(mode === "dark" ? "light" : "dark")}>
+*         Toggle {mode === "dark" ? "Light" : "Dark"} Mode
+*       </button>
+*     </div>
+*   );
+* }
+* ```
+*/
+declare function useFluidTheme(): UseFluidThemeResult;
+//#endregion
+//#region src/hooks/use-current-rep.d.ts
+/**
+* Base query key for current rep data.
+* Kept for backwards compatibility — the runtime key used by the hook
+* includes a company prefix via {@link useCompanyScopedQueryKey}.
+*/
+declare const CURRENT_REP_QUERY_KEY: readonly ["fluid", "currentRep"];
+/**
+* Hook to fetch the currently authenticated rep's profile
+*
+* @example
+* ```tsx
+* function RepHeader() {
+*   const { data: rep, isLoading } = useCurrentRep();
+*
+*   if (isLoading) return <Skeleton />;
+*
+*   return (
+*     <div>
+*       <Avatar src={rep?.avatar_url} />
+*       <span>{rep?.first_name} {rep?.last_name}</span>
+*     </div>
+*   );
+* }
+* ```
+*/
+declare function useCurrentRep(): UseQueryResult<Rep>;
+//#endregion
+//#region src/hooks/use-current-user.d.ts
+/**
+* Base query key for current user data.
+* Kept for backwards compatibility — the runtime key used by the hook
+* includes a company prefix via {@link useCompanyScopedQueryKey}.
+*/
+declare const CURRENT_USER_QUERY_KEY: readonly ["fluid", "currentUser"];
+/**
+* Hook to fetch the currently authenticated user's full profile.
+* Returns company, country, and other fields from GET /api/me.
+*
+* @example
+* ```tsx
+* function ShopPage() {
+*   const { data: user, isLoading } = useCurrentUser();
+*   const subdomain = user?.company?.subdomain;
+*   const countryIso = user?.country?.iso ?? "US";
+*   // ...
+* }
+* ```
+*/
+declare function useCurrentUser(): UseQueryResult<UserMe>;
+//#endregion
+//#region src/hooks/use-fluid-auth.d.ts
+/**
+* Hook to access authentication state and utilities.
+*
+* Must be used within a `FluidAuthProvider`.
+*
+* @returns Authentication context with user info, loading state, and utilities
+* @throws Error if used outside FluidAuthProvider
+*
+* @example
+* ```tsx
+* function UserProfile() {
+*   const { isAuthenticated, isLoading, user, clearAuth } = useFluidAuth();
+*
+*   if (isLoading) {
+*     return <Spinner />;
+*   }
+*
+*   if (!isAuthenticated) {
+*     return <p>Please log in</p>;
+*   }
+*
+*   return (
+*     <div>
+*       <p>Welcome, {user.full_name}!</p>
+*       <button onClick={clearAuth}>Log out</button>
+*     </div>
+*   );
+* }
+* ```
+*/
+declare function useFluidAuth(): FluidAuthContextValue;
+//#endregion
+//#region src/hooks/use-user-type.d.ts
+interface UseUserTypeResult {
+  userType: UserType | null;
+  isCustomer: boolean;
+  isRep: boolean;
+  isAdmin: boolean;
 }
-type FluidMessage = {
-  id: number;
-  body: string;
-  type: string;
-  created_at: string;
-  updated_at?: string | null;
-  deleted_at?: string | null;
-  edited_at?: string | null;
-  conversation_id: number;
-  status: string;
-  attachments: Attachment[];
-  reaction_stats: Record<string, number> | null;
-  reaction?: string | null;
-  metadata?: MessageMetadata;
-  emoji_only_count?: number;
-  mentioned_recipients: SlimmedRecipient[];
-  sent_at?: string;
-  pinned?: boolean;
-  scheduled_at?: string;
-  replied_to_message?: ({
-    id: number;
-  } & Record<string, unknown>) | null;
-  sender_recipient: ReducedRecipient;
-  seen_by: unknown;
-  seen_by_count: unknown;
+/**
+* Convenience hook for user-type checks in the portal SDK.
+*/
+declare function useUserType(): UseUserTypeResult;
+//#endregion
+//#region src/hooks/query-keys.d.ts
+/**
+* Create a company-scoped query key by prepending ["company", companyId].
+*
+* @param companyId - The company ID from the JWT payload
+* @param baseKey - The base query key segments (e.g. ["fluid", "profile"])
+* @returns A tuple like ["company", 42, "fluid", "profile"]
+*
+* @example
+* ```ts
+* const key = createCompanyQueryKey(42, "fluid", "profile");
+* // => ["company", 42, "fluid", "profile"]
+* ```
+*/
+declare function createCompanyQueryKey(companyId: number, ...baseKey: readonly string[]): readonly ["company", number, ...string[]];
+/**
+* Hook that returns a `scopeKey` function bound to the current company ID
+* from the auth context. If the user is not authenticated or has no
+* company_id, the base key is returned unscoped (graceful degradation).
+*
+* @example
+* ```tsx
+* function MyComponent() {
+*   const { scopeKey } = useCompanyScopedQueryKey();
+*   const queryKey = scopeKey(PROFILE_QUERY_KEY);
+*   // => ["company", 42, "fluid", "profile"]  (when authenticated)
+*   // => ["fluid", "profile"]                  (fallback)
+* }
+* ```
+*/
+declare function useCompanyScopedQueryKey(): {
+  readonly companyId: number | undefined;
+  readonly scopeKey: <T extends readonly string[]>(baseKey: T) => readonly (string | number)[];
 };
-interface MessagePinResponse {
-  message: string;
-  pinned: boolean;
-}
-interface BaseConversation {
-  id: number;
-  name: string;
-  description: string | null;
-  kind: string | null;
-  type: string;
-  status: string;
-  created_at: string;
-  pinned: boolean;
-  unread_messages_count?: number | null;
-  "sms_enabled?": boolean;
-  draft_message: DraftMessage | null;
-  "email_enabled?": boolean;
-  conversation_type: string;
-  "messaging_enabled?": boolean;
-  broadcasting: boolean | null;
-  total_recipients: number;
-  unread?: boolean | null;
-  image_url: string | null;
-  auto_add_recipients?: boolean | null;
-  muted?: boolean | null;
-  announcing?: boolean | null;
-  scheduled_messages_count?: number | null;
-  avatar_background_color: string | null;
-  avatar_emoji: string | null;
-  avatar_url: string | null;
-  pinned_messages_count?: number | null;
-  recipients: Recipient[];
-  creator: ReducedRecipient | null;
-}
-interface EmailConversation extends BaseConversation {
-  type: "EmailConversation";
-  kind: null;
-  "sms_enabled?": false;
-  "email_enabled?": true;
-  broadcasting: null;
-}
-interface ChannelConversation extends BaseConversation {
-  type: "ChannelConversation";
-  kind: "channel";
-  "sms_enabled?": false;
-  "email_enabled?": false;
-}
-interface GroupConversation extends BaseConversation {
-  type: "GroupConversation";
-  kind: "group";
-  "sms_enabled?": false;
-  "email_enabled?": false;
-  broadcasting: null;
+//#endregion
+//#region src/hooks/use-logout.d.ts
+interface UseLogoutOptions {
+  /** URL to redirect to after logout. Triggers a full page navigation. */
+  redirectUrl?: string;
+  /** Callback invoked after all state is cleared. Ignored when `redirectUrl` is set. */
+  onLogout?: () => void;
 }
-interface SmsConversation extends BaseConversation {
-  type: "SmsConversation";
-  kind: null;
-  "sms_enabled?": true;
-  "email_enabled?": false;
-  broadcasting: null;
+/**
+* Hook that returns a `logout` function which clears the server session
+* via `DELETE /logout` and all cached/persisted client state.
+*
+* @example
+* ```tsx
+* const logout = useLogout({ redirectUrl: "/login" });
+* <button onClick={logout}>Log out</button>
+* ```
+*
+* @example
+* ```tsx
+* const logout = useLogout({
+*   onLogout: () => navigate("/signed-out"),
+* });
+* ```
+*/
+declare function useLogout({
+  redirectUrl,
+  onLogout
+}?: UseLogoutOptions): () => Promise<void>;
+//#endregion
+//#region src/hooks/use-company-switch.d.ts
+interface UseCompanySwitchOptions {}
+/**
+* Hook that handles company switching for the portal.
+*
+* Calls PUT /api/authentication/company/{id}/switch, clears the TanStack
+* Query cache and IndexedDB persisted cache, then reloads the page so all
+* queries re-fetch with the new company context.
+*
+* The server updates the session cookie automatically via the switch
+* endpoint response; no client-side token storage is needed.
+*/
+declare function useCompanySwitch(_options?: UseCompanySwitchOptions): {
+  switchCompany: (companyId: number) => void;
+  isPending: boolean;
+  isError: boolean;
+  error: Error | null;
+};
+//#endregion
+//#region src/hooks/hook-types.d.ts
+/**
+* Hook type utilities and type predicates.
+*
+* This module provides:
+* - Generic hook result types with default type parameters
+* - Type predicates for query state narrowing
+* - Reusable patterns for type-safe property access in hooks
+*
+* Following generics best practices:
+* - generics-default-type-parameters: Default E to Error for common case
+* - generics-type-predicates: Type predicates for result state narrowing
+* - generics-constrain-type-parameters: K extends keyof T for property access
+*/
+/**
+* Base result type for query hooks with default error type.
+* Uses default type parameter for E (generics-default-type-parameters rule).
+*
+* @typeParam T - The data type
+* @typeParam E - The error type (defaults to Error)
+*
+* @example
+* // Error type defaults to Error
+* type UsersResult = QueryResult<User[]>;
+*
+* // Can override when needed
+* type CustomResult = QueryResult<User[], ApiError>;
+*/
+interface QueryResult<T, E = Error> {
+  readonly data: T;
+  readonly isLoading: boolean;
+  readonly isError: boolean;
+  readonly error?: E | undefined;
 }
-interface DirectConversation extends BaseConversation {
-  type: "DirectConversation";
-  kind: "direct";
-  "sms_enabled?": false;
-  "email_enabled?": false;
-  broadcasting: null;
+/**
+* Result type for hooks that may not have data yet.
+* Extends QueryResult with nullable data.
+*
+* @typeParam T - The data type
+* @typeParam E - The error type (defaults to Error)
+*/
+interface QueryResultNullable<T, E = Error> {
+  readonly data: T | null | undefined;
+  readonly isLoading: boolean;
+  readonly isError: boolean;
+  readonly error?: E | undefined;
 }
-interface BotConversation extends BaseConversation {
-  type: "BotConversation";
-  kind: "direct";
-  "sms_enabled?": false;
-  "email_enabled?": false;
-  broadcasting: null;
+/**
+* Result type for list/collection hooks with aggregates.
+*
+* @typeParam T - The item type in the array
+* @typeParam E - The error type (defaults to Error)
+*/
+interface ListQueryResult<T, E = Error> extends QueryResult<T[], E> {
+  readonly totalCount: number;
 }
-interface DownlineConversation extends BaseConversation {
-  type: "DownlineConversation";
-  kind: "downline";
-  "sms_enabled?": false;
-  "email_enabled?": false;
-  broadcasting: null;
+/**
+* Result type for list hooks with value aggregation (e.g., deals with total value).
+*
+* @typeParam T - The item type in the array
+* @typeParam E - The error type (defaults to Error)
+*/
+interface ValueListQueryResult<T, E = Error> extends ListQueryResult<T, E> {
+  readonly totalValue: number;
 }
-type Conversation$1 = EmailConversation | ChannelConversation | GroupConversation | SmsConversation | DirectConversation | BotConversation | DownlineConversation;
-type ListConversationsInput = {
-  status?: "open" | "closed";
-  kind?: "direct" | "group" | "channel";
-  pinned?: boolean;
-  per_page?: number;
-  page?: number;
-  template?: string;
-  search?: string;
-  filterrific?: Record<string, unknown>;
-} | undefined;
-type ConversationCreateInput = {
-  conversation: {
-    kind?: string;
-    type?: string;
-    name?: string;
-    description?: string | null;
-    broadcasting?: boolean;
-    filter?: Record<string, unknown>;
-    auto_add_recipients?: boolean;
-  };
-  recipients?: {
-    id?: number;
-    uid?: number;
-    email?: string;
-    phone?: string;
-    first_name?: string;
-    last_name?: string;
-    image_url?: string;
-  }[];
-};
-type FindConversationInput = {
-  contact_id: number;
-  conversation_type: "ChannelConversation" | "DirectConversation" | "GroupConversation" | "SmsConversation" | "EmailConversation" | "channel" | "direct" | "group";
-};
-type CreateMessageInput = {
-  message: {
-    body?: string;
-    theme?: string;
-    subject?: string;
-    type?: string;
-    attachments_attributes?: MessageAttachmentInput[];
-  };
-  client_message_id?: string | number;
+/**
+* Type predicate to check if a query result has successfully loaded data.
+* Narrows the data type from T | null | undefined to T.
+*
+* @example
+* const result = useContact(id);
+* if (hasData(result)) {
+*   // TypeScript knows result.data is Contact, not Contact | null
+*   console.log(result.data.name);
+* }
+*/
+declare function hasData<T, E = Error>(result: QueryResultNullable<T, E>): result is QueryResultNullable<T, E> & {
+  readonly data: T;
 };
-type ScheduledMessageInput = {
-  scheduled_message: {
-    body?: string;
-    theme?: string;
-    scheduled_at: string;
-    attachments_attributes?: MessageAttachmentInput[];
-    type?: string;
-  };
+/**
+* Type predicate to check if a query result is in loading state.
+* Useful for conditional rendering.
+*
+* @example
+* if (isLoading(result)) {
+*   return <Spinner />;
+* }
+*/
+declare function isLoading<T, E = Error>(result: QueryResult<T, E> | QueryResultNullable<T, E>): boolean;
+/**
+* Type predicate to check if a query result has an error.
+* Narrows to include the error property.
+*
+* @example
+* if (isErrorResult(result)) {
+*   console.error(result.error); // error is E, not undefined
+* }
+*/
+declare function isErrorResult<T, E = Error>(result: QueryResult<T, E> | QueryResultNullable<T, E>): result is (QueryResult<T, E> | QueryResultNullable<T, E>) & {
+  readonly isError: true;
+  readonly error: E;
 };
-type SaveDraftInput = {
-  draft_message: {
-    body?: string | null;
-    replied_to_id?: number | null;
-    attachments_attributes?: (MessageAttachmentInput & {
-      id?: number;
-      _destroy?: boolean;
-    })[];
-  };
+/**
+* Type predicate to check if a query result is in idle state (not loading, no error, has data).
+*
+* @example
+* if (isIdle(result)) {
+*   // Safe to access and render data
+* }
+*/
+declare function isIdle<T, E = Error>(result: QueryResult<T, E> | QueryResultNullable<T, E>): boolean;
+/**
+* Type-safe property selector for hook results.
+* Uses K extends keyof T constraint (generics-function-constraints rule).
+*
+* @typeParam T - The data object type
+* @typeParam K - Key of T (constrained to actual keys)
+*
+* @example
+* const users = [{ name: "Alice", age: 30 }];
+* const names = selectProperty(users, "name"); // string[]
+* const ages = selectProperty(users, "age");   // number[]
+* selectProperty(users, "invalid"); // Error: "invalid" not in "name" | "age"
+*/
+declare function selectProperty<T, K extends keyof T>(items: readonly T[], key: K): T[K][];
+/**
+* Type-safe property getter for a single item.
+* Returns undefined if item is null/undefined.
+*
+* @typeParam T - The data object type
+* @typeParam K - Key of T (constrained to actual keys)
+*/
+declare function getProperty<T, K extends keyof T>(item: T | null | undefined, key: K): T[K] | undefined;
+/**
+* Generic type for hooks that fetch a single resource by ID.
+* Useful for creating consistent API across different resource types.
+*
+* @typeParam T - The resource type
+* @typeParam E - The error type (defaults to Error)
+*/
+type UseSingleResourceHook<T, E = Error> = (id: string) => QueryResultNullable<T, E>;
+/**
+* Generic type for hooks that fetch a list of resources with optional params.
+* Uses generics-default-type-parameters for the params type.
+*
+* @typeParam T - The item type
+* @typeParam P - The params type (defaults to empty object)
+* @typeParam E - The error type (defaults to Error)
+*/
+type UseListResourceHook<T, P extends Record<string, unknown> = Record<string, never>, E = Error> = (params?: P) => ListQueryResult<T, E>;
+/**
+* Transforms a nullable result to a non-nullable one if data exists.
+* Useful when you've already checked hasData().
+*/
+type WithData<R extends QueryResultNullable<unknown>> = R extends QueryResultNullable<infer T, infer E> ? QueryResultNullable<T, E> & {
+  readonly data: T;
+} : never;
+/**
+* Activity slug constants as a const object.
+* Derive the ActivitySlug type from this single source of truth.
+*/
+declare const ACTIVITY_SLUGS: {
+  readonly abandonedCart: "abandoned_cart";
+  readonly announcements: "announcements";
+  readonly cartItemsAdded: "cart_items_added";
+  readonly commentReply: "comment_reply";
+  readonly directMessage: "direct_message";
+  readonly fantasyPoint: "fantasy_point";
+  readonly newLead: "new_lead";
+  readonly orderPlaced: "order_placed";
+  readonly pageViews: "page_views";
+  readonly pageViewsContact: "page_views_contact";
+  readonly tasks: "tasks";
+  readonly upcomingEvent: "upcoming_event";
+  readonly video: "video";
+  readonly videoComplete: "video_complete";
+  readonly videoCompleteContact: "video_complete_contact";
+  readonly videoContact: "video_contact";
+  readonly messageReceived: "message_received";
+  readonly messageSent: "message_sent";
+  readonly newCartItemsAdded: "new_cart_items_added";
+  readonly smartLinkClicked: "smart_link_clicked";
+  readonly reviewLeft: "review_left";
 };
-interface DraftMessage {
-  id: number;
-  body: string | null;
-  created_at: string;
-  updated_at: string;
-  scheduled_at: string | null;
-  metadata?: unknown;
-  replied_to_message: ({
-    id: number;
-  } & Record<string, unknown>) | null;
-  mentioned_recipients: ({
-    id: number;
-  } & Record<string, unknown>)[];
-  attachments: Attachment[];
-  sender_recipient?: ReducedRecipient;
-  conversation?: {
-    id: number;
-    name: string | null;
-  } & Record<string, unknown>;
+/** Activity slug union type derived from ACTIVITY_SLUGS constant. */
+type ActivitySlug = (typeof ACTIVITY_SLUGS)[keyof typeof ACTIVITY_SLUGS];
+/** Type predicate to check if a string is a valid ActivitySlug. */
+declare function isActivitySlug(value: string): value is ActivitySlug;
+/** Transformed activity for display. */
+interface Activity {
+  readonly id: number;
+  readonly userName: string;
+  readonly avatarUrl: string | null;
+  readonly activityType: string;
+  readonly targetName: string;
+  readonly timestamp: string;
+  readonly slug: ActivitySlug;
 }
-type ListConnectedRecipientsInput = {
-  kind?: "external" | "sms" | "email" | "internal";
-  filterrific?: Record<string, unknown>;
-  per_page?: number;
-  page?: number;
-};
-//#endregion
-//#region ../../messaging/core/src/auth-types.d.ts
-interface MessagingAuthContext {
-  readonly recipientId: number | null;
-  readonly companyId: number | null;
-  readonly currentUser: MessagingCurrentUser | null;
-  readonly isLoading: boolean;
+/** Description/rich text metadata for a calendar event. */
+interface CalendarEventDescription {
+  readonly id?: number | null;
+  readonly name?: string | null;
+  readonly body?: string | null;
+  readonly record_type?: string | null;
+  readonly record_id?: number | null;
+  readonly created_at?: string | null;
+  readonly updated_at?: string | null;
+  readonly locale?: string | null;
 }
-interface MessagingCurrentUser {
+/** Calendar event data from the API. */
+interface CalendarEvent {
   readonly id: number;
-  readonly recipientId: number;
-  readonly firstName: string;
-  readonly lastName: string;
-  readonly email: string;
-  readonly imageUrl?: string;
-  readonly affiliateId?: number;
+  readonly title: string;
+  readonly description?: CalendarEventDescription | null;
+  readonly color?: string | null;
+  readonly url?: string | null;
+  readonly start: string;
+  readonly end: string;
+  readonly active?: boolean | null;
+  readonly time_zone?: string | null;
+  readonly status?: string | null;
+  readonly image_url?: string | null;
+  readonly images?: readonly unknown[] | null;
+  readonly venue?: string | null;
+  readonly countries?: readonly string[] | null;
+  readonly hasTomorrow?: boolean | null;
+  readonly hasYesterday?: boolean | null;
+  readonly isAllDay?: boolean;
+}
+/** Catch up suggestion data from the API. */
+interface CatchUp {
+  readonly id: number;
+  readonly suggestion_title: string;
+}
+/** MySite data returned by the hook. */
+interface MySiteData {
+  readonly url: string | null;
+  readonly views: number;
+  readonly leads: number;
+  readonly userName: string;
+}
+/** Transformed todo for display. */
+interface Todo {
+  readonly id: number;
+  readonly body: string;
+  readonly dueAt: string | null;
+  readonly completedAt: string | null;
+  readonly createdAt: string;
+  readonly contactName: string | null;
 }
 //#endregion
-//#region ../../messaging/core/src/file-upload-types.d.ts
+//#region src/hooks/use-calendar-events.d.ts
 /**
-* Generic file upload abstraction.
-*
-* These types are re-exported from messaging-core so that both
-* messaging-ui (which owns the concrete hook) and external consumers
-* can reference the same contracts without depending on the UI layer.
+* Result type for useCalendarEvents hook.
+* Uses QueryResult<CalendarEvent[]> with default Error type.
 */
-type UploadResult = {
-  readonly url: string;
-  readonly size: number;
-  readonly mimetype: string;
-  readonly kind: string;
-  readonly metadata?: {
-    width: number;
-    height: number;
-  } | null;
-};
-type UploadCallbacks = {
-  onProgress: (progress: number) => void;
-  onSuccess: (result: UploadResult) => void;
-  onError: (error: Error) => void;
-};
-type FileUploader = {
-  uploadFile: (file: File, callbacks: UploadCallbacks) => {
-    abort: () => void;
-  };
-};
+type UseCalendarEventsResult = QueryResult<CalendarEvent[]>;
+/**
+* Hook to fetch calendar events.
+* This is a stub implementation - override with your own data fetching logic.
+*/
+declare function useCalendarEvents(): UseCalendarEventsResult;
 //#endregion
-//#region ../../messaging/core/src/messaging-api.d.ts
+//#region src/hooks/use-todos.d.ts
 /**
-* Interface defining all messaging API operations that core hooks need.
-* Each app provides an implementation via {@link MessagingApiProvider},
-* decoupling shared packages from concrete API clients.
+* Result type for useTodos hook.
+* Uses QueryResult<Todo[]> with default Error type.
 */
-interface MessagingApi {
-  listConversations(input?: ListConversationsInput): Promise<Paginated<Conversation$1>>;
-  getConversation(conversationId: number): Promise<Conversation$1>;
-  findConversation(input: FindConversationInput): Promise<Conversation$1>;
-  createConversation(input: ConversationCreateInput): Promise<Conversation$1>;
-  getAnnouncementChannel(): Promise<Conversation$1>;
-  listMessages(conversationId: number, input?: {
-    preview?: boolean;
-    message_id?: number;
-    after?: number;
-    before?: number;
-    sorted_by?: string;
-    per_page?: number;
-    page?: number;
-  }): Promise<Paginated<FluidMessage>>;
-  createMessage(conversationId: number, input: CreateMessageInput): Promise<FluidMessage>;
-  replyToMessage(conversationId: number, messageId: number, input: CreateMessageInput): Promise<FluidMessage>;
-  reactToMessage(conversationId: number, input: {
-    message_id: number;
-    reaction: string;
-  }): Promise<string>;
-  unreactToMessage(conversationId: number, input: {
-    message_id: number;
-  }): Promise<string>;
-  pinMessage(conversationId: number, messageId: number): Promise<MessagePinResponse>;
-  unpinMessage(conversationId: number, messageId: number): Promise<MessagePinResponse>;
-  listPinnedMessages(conversationId: number, input?: {
-    sorted_by?: string;
-    per_page?: number;
-    page?: number;
-  }): Promise<Paginated<FluidMessage>>;
-  listScheduledMessages(conversationId: number, input?: {
-    per_page?: number;
-    page?: number;
-  }): Promise<Paginated<FluidMessage>>;
-  createScheduledMessage(conversationId: number, input: ScheduledMessageInput): Promise<FluidMessage>;
-  updateScheduledMessage(conversationId: number, id: number, input: ScheduledMessageInput): Promise<FluidMessage>;
-  destroyScheduledMessage(conversationId: number, id: number): Promise<{
-    success: boolean;
-    message: string;
-  }>;
-  listMyScheduledMessages(input?: {
-    per_page?: number;
-    page?: number;
-  }): Promise<Paginated<DraftMessage>>;
-  saveDraft(conversationId: number, input: SaveDraftInput): Promise<DraftMessage | Record<string, never>>;
-  destroyDraft(conversationId: number): Promise<unknown>;
-  searchRecipientsCount(input: {
-    filter: Record<string, unknown>;
-  }): Promise<RecipientSearchCount>;
-  listConnectedRecipients(input: ListConnectedRecipientsInput): Promise<Paginated<Recipient | WithContactRecipient>>;
-}
+type UseTodosResult = QueryResult<Todo[]>;
+/**
+* Hook to fetch todo items.
+* This is a stub implementation - override with your own data fetching logic.
+*/
+declare function useTodos(): UseTodosResult;
 //#endregion
-//#region src/messaging/use-messaging-auth.d.ts
-declare function useMessagingAuth(): MessagingAuthContext;
+//#region src/hooks/use-activities.d.ts
+/**
+* Result type for useActivities hook.
+* Uses QueryResult generic with Activity[] and default Error type.
+*/
+type UseActivitiesResult = QueryResult<Activity[]>;
+/**
+* Hook to fetch recent activities.
+* This is a stub implementation - override with your own data fetching logic.
+*/
+declare function useActivities(): UseActivitiesResult;
+//#endregion
+//#region src/hooks/use-catchups.d.ts
+/**
+* Result type for useCatchUps hook.
+* Uses QueryResult<CatchUp[]> with default Error type.
+*/
+type UseCatchUpsResult = QueryResult<CatchUp[]>;
+/**
+* Hook to fetch catch up items.
+* This is a stub implementation - override with your own data fetching logic.
+*/
+declare function useCatchUps(): UseCatchUpsResult;
 //#endregion
-//#region ../../messaging/api-client/src/client.d.ts
+//#region src/hooks/use-mysite.d.ts
 /**
-* Configuration for the messaging API client.
-* The consuming app provides auth headers and base URL.
+* Result type for useMySite hook.
+* Uses QueryResultNullable since MySite data may not be available.
 */
-interface MessagingApiConfig {
-  baseUrl: string;
-  getHeaders: () => Record<string, string> | Promise<Record<string, string>>;
-  onAuthError?: () => void;
-}
-//#endregion
-//#region src/messaging/use-messaging-config.d.ts
-interface MessagingConfig {
-  readonly apiConfig: MessagingApiConfig;
-  readonly messagingApi: MessagingApi;
-  readonly websocketUrl: string;
-}
-declare function useMessagingConfig(): MessagingConfig;
+type UseMySiteResult = QueryResultNullable<MySiteData>;
+/**
+* Hook to fetch MySite data.
+* This is a stub implementation - override with your own data fetching logic.
+*/
+declare function useMySite(): UseMySiteResult;
 //#endregion
-//#region src/messaging/fluid-file-uploader.d.ts
+//#region src/hooks/use-conversations.d.ts
 /**
-* Creates a FileUploader that uploads to Filestack using the REST API.
+* Result type for useConversations hook.
+* Uses QueryResult<Conversation[]> with default Error type.
+*/
+type UseConversationsResult = QueryResult<Conversation[]>;
+/**
+* Hook to fetch all conversations.
+* This is a stub implementation - override with your own data fetching logic.
 *
-* @param apiKey - Filestack API key. If falsy, returns a noop uploader
-*                 that rejects uploads with a helpful error message.
+* @returns UseConversationsResult with empty data array
+*
+* @example
+* ```tsx
+* const { data: conversations, isLoading, isError } = useConversations();
+*
+* if (isLoading) return <Loading />;
+* if (isError) return <Error />;
+*
+* return conversations.map(conv => <ConversationItem key={conv.id} {...conv} />);
+* ```
 */
-declare function createFluidFileUploader(apiKey: string | undefined): FileUploader;
+declare function useConversations(): UseConversationsResult;
+/**
+* Result type for useConversationMessages hook.
+* Uses QueryResult<Message[]> with default Error type.
+*/
+type UseConversationMessagesResult = QueryResult<Message[]>;
+/**
+* Hook to fetch messages for a specific conversation.
+* This is a stub implementation - override with your own data fetching logic.
+*
+* @param conversationId - The ID of the conversation to fetch messages for
+* @returns UseConversationMessagesResult with empty data array
+*
+* @example
+* ```tsx
+* const { data: messages, isLoading, isError } = useConversationMessages(conversationId);
+*
+* if (isLoading) return <Loading />;
+* if (isError) return <Error />;
+*
+* return messages.map(msg => <MessageBubble key={msg.id} {...msg} />);
+* ```
+*/
+declare function useConversationMessages(_conversationId: string): UseConversationMessagesResult;
 //#endregion
-//#region ../core/src/registries/property-schema-types.d.ts
+//#region src/hooks/use-contacts.d.ts
 /**
-* Tab configuration for organizing properties
+* Type predicate to check if a status string is a valid ContactStatus.
+* Enables runtime validation with type narrowing.
 */
-interface TabConfig {
-  /** Unique identifier for the tab */
-  id: string;
-  /** Display label for the tab */
-  label: string;
+declare function isContactStatus(value: string): value is ContactStatus;
+/**
+* Parameters for filtering and paginating contacts.
+* Uses readonly properties and proper ContactStatus type for status.
+*/
+interface UseContactsParams {
+  /** Search query to filter contacts by name, email, or company */
+  readonly search?: string;
+  /** Filter contacts by status - uses ContactStatus union type for type safety */
+  readonly status?: ContactStatus;
+  /** Maximum number of contacts to return */
+  readonly limit?: number;
 }
 /**
-* Property field type constant - single source of truth for field types.
-* Use PROPERTY_FIELD_TYPES.text instead of "text" for type-safe comparisons.
+* Result type for the useContacts hook.
+* Uses ListQueryResult<Contact> with totalCount and default Error type.
 */
-declare const PROPERTY_FIELD_TYPES: {
-  readonly text: "text";
-  readonly textarea: "textarea";
-  readonly number: "number";
-  readonly boolean: "boolean";
-  readonly select: "select";
-  readonly color: "color";
-  readonly range: "range";
-  readonly dataSource: "dataSource";
-  readonly resource: "resource";
-  readonly image: "image";
-  readonly alignment: "alignment";
-  readonly slider: "slider";
-  readonly colorPicker: "colorPicker";
-  readonly sectionHeader: "sectionHeader";
-  readonly separator: "separator";
-  readonly buttonGroup: "buttonGroup";
-  readonly colorSelect: "colorSelect";
-  readonly sectionLayoutSelect: "sectionLayoutSelect";
-  readonly background: "background";
-  readonly contentPosition: "contentPosition";
-  readonly textSizeSelect: "textSizeSelect";
-  readonly cssUnit: "cssUnit";
-  readonly fontPicker: "fontPicker";
-  readonly stringArray: "stringArray";
-  readonly borderRadius: "borderRadius";
-  readonly screenPicker: "screenPicker";
-};
+type UseContactsResult = ListQueryResult<Contact>;
 /**
-* Union type of all property field types, derived from PROPERTY_FIELD_TYPES constant.
-* @see deriving-typeof-for-object-keys pattern
+* Result type for the useContact hook.
+* Uses QueryResultNullable since a specific contact may not exist.
 */
-type PropertyFieldType = (typeof PROPERTY_FIELD_TYPES)[keyof typeof PROPERTY_FIELD_TYPES];
+type UseContactResult = QueryResultNullable<Contact>;
 /**
-* Runtime validation for property field types.
-* @param value - The value to check
-* @returns true if value is a valid PropertyFieldType
+* Hook to fetch a list of contacts with optional filtering and pagination.
+* This is a stub implementation - override with your own data fetching logic.
+*
+* @param params - Optional parameters for filtering and pagination
+* @returns Object containing contacts data, loading state, error state, and total count
+*
+* @example
+* ```tsx
+* const { data: contacts, isLoading, totalCount } = useContacts({
+*   search: 'john',
+*   status: 'active',
+*   limit: 20
+* });
+* ```
 */
-declare function isPropertyFieldType(value: string): value is PropertyFieldType;
+declare function useContacts(_params?: UseContactsParams): UseContactsResult;
 /**
-* Base schema for a property field
+* Hook to fetch a single contact by ID.
+* This is a stub implementation - override with your own data fetching logic.
+*
+* @param contactId - The unique identifier of the contact to fetch
+* @returns Object containing contact data, loading state, and error state
+*
+* @example
+* ```tsx
+* const { data: contact, isLoading, isError } = useContact('contact-123');
+* ```
 */
-interface PropertyFieldSchema {
-  /** Property key in the widget props */
-  key: string;
-  /** Display label for the field */
-  label: string;
-  /** Field type determines the input control */
-  type: PropertyFieldType;
-  /** Optional description/help text */
-  description?: string;
-  /** Optional default value */
-  defaultValue?: unknown;
-  /** Optional tab ID (must match a TabConfig id if widget has tabsConfig) */
-  tab?: string;
-  /** Optional group for organizing fields within a tab */
-  group?: string;
-  /**
-  * @deprecated Use requiresKeyValue instead
-  */
-  requiresKeyToBeTrue?: string;
-  /** Optional requires a specific key to have a specific value. Supports single condition or array (AND logic). */
-  requiresKeyValue?: {
-    key: string;
-    value: unknown;
-  } | Array<{
-    key: string;
-    value: unknown;
-  }>;
+declare function useContact(_contactId: string): UseContactResult;
+//#endregion
+//#region src/components/RequireAuth.d.ts
+interface RequireAuthProps {
+  /** Content to render when authenticated */
+  children: ReactNode;
+  /** Component to show while checking authentication (default: AuthLoading) */
+  fallback?: ReactNode;
+  /** Component to show when not authenticated (default: AuthError) */
+  errorComponent?: ReactNode;
+}
+/**
+* Component that protects content requiring authentication.
+*
+* **Important:** This provides UX-level protection only. It prevents
+* unauthenticated users from seeing the UI, but the real security
+* boundary is the server-side API. Client-side auth can always be
+* bypassed by modifying browser state.
+*
+* For defense-in-depth, configure `jwksUrl` in `FluidAuthConfig`
+* to enable client-side JWT signature verification.
+*
+* Shows different states based on auth status:
+* - Loading: Shows fallback (spinner by default)
+* - Not authenticated: Shows errorComponent (AuthError by default)
+* - Authenticated: Shows children
+*
+* @example
+* ```tsx
+* // Basic usage - shows default loading/error states
+* <RequireAuth>
+*   <ProtectedContent />
+* </RequireAuth>
+*
+* // Custom loading state
+* <RequireAuth fallback={<CustomSpinner />}>
+*   <ProtectedContent />
+* </RequireAuth>
+*
+* // Custom error component
+* <RequireAuth errorComponent={<LoginPrompt />}>
+*   <ProtectedContent />
+* </RequireAuth>
+*
+* // Both custom
+* <RequireAuth
+*   fallback={<SkeletonLoader />}
+*   errorComponent={<RedirectToLogin />}
+* >
+*   <Dashboard />
+* </RequireAuth>
+* ```
+*/
+declare function RequireAuth({
+  children,
+  fallback,
+  errorComponent
+}: RequireAuthProps): React.JSX.Element;
+//#endregion
+//#region src/components/AuthError.d.ts
+interface AuthErrorProps {
+  /** Error message to display */
+  message?: string;
+  /** Optional title */
+  title?: string;
+  /** Optional children for custom content */
+  children?: ReactNode;
 }
 /**
-* Text field schema
+* Default authentication error component.
+*
+* Displays a simple error message when authentication fails.
+* Can be customized via props or replaced entirely in RequireAuth.
+*
+* @example
+* ```tsx
+* // Use with default message
+* <AuthError />
+*
+* // Use with custom message
+* <AuthError message="Session expired. Please log in again." />
+*
+* // Use with custom content
+* <AuthError>
+*   <CustomLoginButton />
+* </AuthError>
+* ```
 */
-interface TextFieldSchema extends PropertyFieldSchema {
-  type: "text";
-  placeholder?: string;
-  maxLength?: number;
-}
+declare function AuthError({
+  message,
+  title,
+  children
+}: AuthErrorProps): React.JSX.Element;
 /**
-* Textarea field schema
+* Simple loading spinner component for auth loading state.
 */
-interface TextareaFieldSchema extends PropertyFieldSchema {
-  type: "textarea";
-  placeholder?: string;
-  rows?: number;
-  maxLength?: number;
-}
+declare function AuthLoading(): React.JSX.Element;
+//#endregion
+//#region ../../messaging/core/src/types.d.ts
 /**
-* Number field schema
+* Domain types for the messaging package.
+*
+* These are owned by messaging-core and represent the contract that
+* any API adapter (current client, future BFF) must satisfy.
+* Consuming packages import from here — never from the API client directly.
 */
-interface NumberFieldSchema extends PropertyFieldSchema {
-  type: "number";
-  min?: number;
-  max?: number;
-  step?: number;
+interface PaginationObject {
+  pagination: {
+    current: number;
+    previous: number | null;
+    next: number | null;
+    per_page: number;
+    pages: number;
+    count: number;
+  };
 }
-/**
-* Boolean field schema
-*/
-interface BooleanFieldSchema extends PropertyFieldSchema {
-  type: "boolean";
+type Paginated<T> = [PaginationObject, {
+  items: T[];
+}];
+interface AttachmentMetadata {
+  width?: number;
+  height?: number;
 }
-/**
-* Select field schema with type-safe option values.
-* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
-*/
-interface SelectFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
-  type: "select";
-  options: Array<{
-    label: string;
-    value: T;
-  }>;
-  defaultValue?: T;
+interface Attachment {
+  id: number;
+  url: string;
+  filename: string;
+  kind: string;
+  image_url: string | null;
+  image_path: string | null;
+  content_type: string | null;
+  attachable_type: string | null;
+  attachable_id: number | null;
+  thumbnail_url: string | null;
+  metadata: AttachmentMetadata | null;
+  content_size: number | null;
 }
-/**
-* Color field schema
-*/
-interface ColorFieldSchema extends PropertyFieldSchema {
-  type: "color";
+interface MessageAttachmentInput {
+  url: string;
+  filename: string;
+  kind: string;
+  content_type?: string;
+  content_size?: number;
+  metadata?: AttachmentMetadata;
 }
-/**
-* Range slider field schema
-*/
-interface RangeFieldSchema extends PropertyFieldSchema {
-  type: "range";
-  min: number;
-  max: number;
-  step?: number;
+interface LinkPreview {
+  url: string;
+  title?: string | null;
+  description?: string | null;
+  images?: string[];
+  videos?: string[];
+  favicon?: string | null;
+  error?: string | null;
+  original_url?: string | null;
 }
-/**
-* Data source field schema for configuring widget data sources
-*/
-interface DataSourceFieldSchema extends PropertyFieldSchema {
-  type: "dataSource";
+interface InfoMessageRecipient {
+  id: number;
+  first_name: string;
+  last_name: string;
 }
-/**
-* Resource field schema for selecting a single resource from the selection modal
-*/
-interface ResourceFieldSchema extends PropertyFieldSchema {
-  type: "resource";
-  /** Optional filter to specific shareable types */
-  allowedTypes?: string[];
+interface DefaultMessageMetadata {
+  links: LinkPreview[];
+  client_message_id?: string | number | null;
 }
-/**
-* Image field schema for selecting a single image from the image picker
-*/
-interface ImageFieldSchema extends PropertyFieldSchema {
-  type: "image";
+interface SystemConversationUpdateMetadata {
+  name: string;
+  previous_name: string;
+  client_message_id?: string | number | null;
+  links?: LinkPreview[];
 }
-/**
-* Alignment field schema
-*/
-interface AlignmentFieldSchema extends PropertyFieldSchema {
-  type: "alignment";
-  options: {
-    verticalEnabled: boolean;
-    horizontalEnabled: boolean;
-  };
-  defaultValue?: AlignOptions;
+interface SystemConversationCreatedMetadata {
+  conversation_name: string;
+  description?: string;
+  member_count: number;
+  auto_add_recipients: boolean;
+  client_message_id?: string | number | null;
+  links?: LinkPreview[];
 }
-/**
-* Slider field schema with optional unit suffix (e.g., "rem", "px")
-*/
-interface SliderFieldSchema extends PropertyFieldSchema {
-  type: "slider";
-  min: number;
-  max: number;
-  step?: number;
-  unit?: string;
+interface SystemRecipientActionMetadata {
+  recipient_ids_added?: number[];
+  recipient_ids_removed?: number[];
+  recipient_ids_left?: number[];
+  recipient_ids_joined?: number[];
+  recipient_added?: InfoMessageRecipient[];
+  recipient_removed?: InfoMessageRecipient[];
+  recipient_left?: InfoMessageRecipient[];
+  recipient_joined?: InfoMessageRecipient[];
+  client_message_id?: string | number | null;
+  links?: LinkPreview[];
+}
+interface InfoMessageMetadataShape {
+  recipient_added?: InfoMessageRecipient[];
+  recipient_ids_added?: number[];
+  recipient_removed?: InfoMessageRecipient[];
+  recipient_ids_removed?: number[];
+  links?: LinkPreview[];
+  client_message_id?: string | number | null;
+}
+type MessageMetadata = DefaultMessageMetadata | null | SystemConversationUpdateMetadata | SystemConversationCreatedMetadata | SystemRecipientActionMetadata | InfoMessageMetadataShape;
+interface Recipient {
+  id: number;
+  first_name: string;
+  last_name: string;
+  avatar_url: string | null;
+  image_url: string | null;
+  receivable_id: number;
+  receivable_type: "Contact" | "UserCompany";
+  discarded_at: string | null;
+  left_conversation_at: string | null;
+  blocked: boolean | null;
+  country_name: string | null;
+  pro_user: boolean;
+  avatar_background: string | null;
+  email?: string | null;
+  phone?: string | null;
+  status?: "online" | "offline" | "away";
+  last_online?: string | null;
+  "conversation_messaging_enabled?"?: boolean;
+}
+interface ReducedRecipient {
+  id: number;
+  first_name: string;
+  last_name: string;
+  image_url: string | null;
+  discarded_at: string | null;
+  blocked: boolean | null;
+  blocker: boolean | null;
+  avatar_background: string | null;
+  seen_at?: string | null;
+  email?: string | null;
+  phone?: string | null;
+  pro_user?: boolean;
+}
+interface SlimmedRecipient {
+  id: number;
+  first_name: string;
+  last_name: string;
+  discarded_at: string | null;
+  blocked: boolean | null;
+  avatar_background: string | null;
+  email?: string | null;
+  phone?: string | null;
+  removed_at?: string | null;
+}
+interface WithContactRecipient {
+  id: number;
+  email?: string | null;
+  phone?: string | null;
+  first_name?: string | null;
+  last_name?: string | null;
+  image_url: string | null;
+  receivable_id: number;
+  receivable_type: "Contact";
 }
-/**
-* Color picker field schema with optional swatches
-*/
-interface ColorPickerFieldSchema extends PropertyFieldSchema {
-  type: "colorPicker";
-  swatches?: string[];
+interface RecipientSearchCount {
+  meta: {
+    count: number;
+  };
 }
-/**
-* Section header field schema for visual grouping
-*/
-interface SectionHeaderFieldSchema extends PropertyFieldSchema {
-  type: "sectionHeader";
-  subtitle?: string;
+type FluidMessage = {
+  id: number;
+  body: string;
+  type: string;
+  created_at: string;
+  updated_at?: string | null;
+  deleted_at?: string | null;
+  edited_at?: string | null;
+  conversation_id: number;
+  status: string;
+  attachments: Attachment[];
+  reaction_stats: Record<string, number> | null;
+  reaction?: string | null;
+  metadata?: MessageMetadata;
+  emoji_only_count?: number;
+  mentioned_recipients: SlimmedRecipient[];
+  sent_at?: string;
+  pinned?: boolean;
+  scheduled_at?: string;
+  replied_to_message?: ({
+    id: number;
+  } & Record<string, unknown>) | null;
+  sender_recipient: ReducedRecipient;
+  seen_by: unknown;
+  seen_by_count: unknown;
+};
+interface MessagePinResponse {
+  message: string;
+  pinned: boolean;
 }
-/**
-* Separator field schema for visual separation
-*/
-interface SeparatorFieldSchema extends PropertyFieldSchema {
-  type: "separator";
+interface BaseConversation {
+  id: number;
+  name: string;
+  description: string | null;
+  kind: string | null;
+  type: string;
+  status: string;
+  created_at: string;
+  pinned: boolean;
+  unread_messages_count?: number | null;
+  "sms_enabled?": boolean;
+  draft_message: DraftMessage | null;
+  "email_enabled?": boolean;
+  conversation_type: string;
+  "messaging_enabled?": boolean;
+  broadcasting: boolean | null;
+  total_recipients: number;
+  unread?: boolean | null;
+  image_url: string | null;
+  auto_add_recipients?: boolean | null;
+  muted?: boolean | null;
+  announcing?: boolean | null;
+  scheduled_messages_count?: number | null;
+  avatar_background_color: string | null;
+  avatar_emoji: string | null;
+  avatar_url: string | null;
+  pinned_messages_count?: number | null;
+  recipients: Recipient[];
+  creator: ReducedRecipient | null;
 }
-/**
-* Button group field schema.
-* Uses StrictOmit to ensure "defaultValue" key exists on PropertyFieldSchema.
-*/
-interface ButtonGroupFieldSchema<T extends string | number = string | number> extends StrictOmit<PropertyFieldSchema, "defaultValue"> {
-  type: "buttonGroup";
-  options: Array<{
-    label?: string;
-    icon?: LucideIcon;
-    value: T;
-  }>;
-  defaultValue?: T;
+interface EmailConversation extends BaseConversation {
+  type: "EmailConversation";
+  kind: null;
+  "sms_enabled?": false;
+  "email_enabled?": true;
+  broadcasting: null;
 }
-/**
-* Color select field schema
-*/
-interface ColorSelectFieldSchema extends PropertyFieldSchema {
-  type: "colorSelect";
-  defaultValue?: ColorOptions;
-  excludeColors?: ColorOptions[];
+interface ChannelConversation extends BaseConversation {
+  type: "ChannelConversation";
+  kind: "channel";
+  "sms_enabled?": false;
+  "email_enabled?": false;
 }
-/**
-* Section layout select field schema for visual masonry layout selector
-*/
-interface SectionLayoutSelectFieldSchema extends PropertyFieldSchema {
-  type: "sectionLayoutSelect";
-  defaultValue?: SectionLayoutType;
+interface GroupConversation extends BaseConversation {
+  type: "GroupConversation";
+  kind: "group";
+  "sms_enabled?": false;
+  "email_enabled?": false;
+  broadcasting: null;
 }
-/**
-* Background field combines resource selection and color properties.
-* Uses StrictOmit to exclude conflicting "type" discriminant from parents.
-*/
-interface BackgroundFieldSchema extends StrictOmit<ResourceFieldSchema, "type">, StrictOmit<ColorFieldSchema, "type"> {
-  type: "background";
+interface SmsConversation extends BaseConversation {
+  type: "SmsConversation";
+  kind: null;
+  "sms_enabled?": true;
+  "email_enabled?": false;
+  broadcasting: null;
 }
-/**
-* Content position field schema for 3x3 grid position picker
-*/
-interface ContentPositionFieldSchema extends PropertyFieldSchema {
-  type: "contentPosition";
-  defaultValue?: string;
+interface DirectConversation extends BaseConversation {
+  type: "DirectConversation";
+  kind: "direct";
+  "sms_enabled?": false;
+  "email_enabled?": false;
+  broadcasting: null;
 }
-/**
-* Text size select field schema for visual font size selector
-*/
-interface TextSizeSelectFieldSchema extends PropertyFieldSchema {
-  type: "textSizeSelect";
-  defaultValue?: FontSizeOptions;
+interface BotConversation extends BaseConversation {
+  type: "BotConversation";
+  kind: "direct";
+  "sms_enabled?": false;
+  "email_enabled?": false;
+  broadcasting: null;
 }
-/**
-* CSS unit type for height/width fields
-*/
-type CssUnit = "px" | "rem" | "vh" | "%";
-/**
-* CSS unit field schema for numeric values with selectable units (px, rem, vh, %)
-*/
-interface CssUnitFieldSchema extends PropertyFieldSchema {
-  type: "cssUnit";
-  minByUnit?: Partial<Record<CssUnit, number>>;
-  maxByUnit?: Partial<Record<CssUnit, number>>;
-  stepByUnit?: Partial<Record<CssUnit, number>>;
-  allowedUnits?: CssUnit[];
-  defaultUnit?: CssUnit;
+interface DownlineConversation extends BaseConversation {
+  type: "DownlineConversation";
+  kind: "downline";
+  "sms_enabled?": false;
+  "email_enabled?": false;
+  broadcasting: null;
+}
+type Conversation$1 = EmailConversation | ChannelConversation | GroupConversation | SmsConversation | DirectConversation | BotConversation | DownlineConversation;
+type ListConversationsInput = {
+  status?: "open" | "closed";
+  kind?: "direct" | "group" | "channel";
+  pinned?: boolean;
+  per_page?: number;
+  page?: number;
+  template?: string;
+  search?: string;
+  filterrific?: Record<string, unknown>;
+} | undefined;
+type ConversationCreateInput = {
+  conversation: {
+    kind?: string;
+    type?: string;
+    name?: string;
+    description?: string | null;
+    broadcasting?: boolean;
+    filter?: Record<string, unknown>;
+    auto_add_recipients?: boolean;
+  };
+  recipients?: {
+    id?: number;
+    uid?: number;
+    email?: string;
+    phone?: string;
+    first_name?: string;
+    last_name?: string;
+    image_url?: string;
+  }[];
+};
+type FindConversationInput = {
+  contact_id: number;
+  conversation_type: "ChannelConversation" | "DirectConversation" | "GroupConversation" | "SmsConversation" | "EmailConversation" | "channel" | "direct" | "group";
+};
+type CreateMessageInput = {
+  message: {
+    body?: string;
+    theme?: string;
+    subject?: string;
+    type?: string;
+    attachments_attributes?: MessageAttachmentInput[];
+  };
+  client_message_id?: string | number;
+};
+type ScheduledMessageInput = {
+  scheduled_message: {
+    body?: string;
+    theme?: string;
+    scheduled_at: string;
+    attachments_attributes?: MessageAttachmentInput[];
+    type?: string;
+  };
+};
+type SaveDraftInput = {
+  draft_message: {
+    body?: string | null;
+    replied_to_id?: number | null;
+    attachments_attributes?: (MessageAttachmentInput & {
+      id?: number;
+      _destroy?: boolean;
+    })[];
+  };
+};
+interface DraftMessage {
+  id: number;
+  body: string | null;
+  created_at: string;
+  updated_at: string;
+  scheduled_at: string | null;
+  metadata?: unknown;
+  replied_to_message: ({
+    id: number;
+  } & Record<string, unknown>) | null;
+  mentioned_recipients: ({
+    id: number;
+  } & Record<string, unknown>)[];
+  attachments: Attachment[];
+  sender_recipient?: ReducedRecipient;
+  conversation?: {
+    id: number;
+    name: string | null;
+  } & Record<string, unknown>;
 }
-/**
-* Font picker field schema for Google Fonts selection
-*/
-interface FontPickerFieldSchema extends PropertyFieldSchema {
-  type: "fontPicker";
-  placeholder?: string;
+type ListConnectedRecipientsInput = {
+  kind?: "external" | "sms" | "email" | "internal";
+  filterrific?: Record<string, unknown>;
+  per_page?: number;
+  page?: number;
+};
+//#endregion
+//#region ../../messaging/core/src/auth-types.d.ts
+interface MessagingAuthContext {
+  readonly recipientId: number | null;
+  readonly companyId: number | null;
+  readonly currentUser: MessagingCurrentUser | null;
+  readonly isLoading: boolean;
 }
-/**
-* String array field schema for managing lists of text items
-*/
-interface StringArrayFieldSchema extends PropertyFieldSchema {
-  type: "stringArray";
-  placeholder?: string;
-  defaultValue?: string[];
+interface MessagingCurrentUser {
+  readonly id: number;
+  readonly recipientId: number;
+  readonly firstName: string;
+  readonly lastName: string;
+  readonly email: string;
+  readonly imageUrl?: string;
+  readonly affiliateId?: number;
 }
+//#endregion
+//#region ../../messaging/core/src/file-upload-types.d.ts
 /**
-* Border radius composite field schema for controlling 4 corners with a single field.
-* Maps to 4 individual widget prop keys (topLeft, topRight, bottomLeft, bottomRight).
+* Generic file upload abstraction.
+*
+* These types are re-exported from messaging-core so that both
+* messaging-ui (which owns the concrete hook) and external consumers
+* can reference the same contracts without depending on the UI layer.
 */
-interface BorderRadiusFieldSchema extends PropertyFieldSchema {
-  type: "borderRadius";
-  keys: {
-    topLeft: string;
-    topRight: string;
-    bottomLeft: string;
-    bottomRight: string;
+type UploadResult = {
+  readonly url: string;
+  readonly size: number;
+  readonly mimetype: string;
+  readonly kind: string;
+  readonly metadata?: {
+    width: number;
+    height: number;
+  } | null;
+};
+type UploadCallbacks = {
+  onProgress: (progress: number) => void;
+  onSuccess: (result: UploadResult) => void;
+  onError: (error: Error) => void;
+};
+type FileUploader = {
+  uploadFile: (file: File, callbacks: UploadCallbacks) => {
+    abort: () => void;
   };
-  defaultValue?: BorderRadiusOptions;
-}
-/**
-* Screen picker field schema for selecting a portal screen (navigation, system, or available)
-*/
-interface ScreenPickerFieldSchema extends PropertyFieldSchema {
-  type: "screenPicker";
-  /** Whether to include system navigation items in the picker */
-  includeSystemItems?: boolean;
-}
-/**
-* Union of all field schema types
-*/
-type PropertyField = TextFieldSchema | TextareaFieldSchema | NumberFieldSchema | BooleanFieldSchema | SelectFieldSchema<string | number> | ColorFieldSchema | RangeFieldSchema | DataSourceFieldSchema | ResourceFieldSchema | ImageFieldSchema | AlignmentFieldSchema | SliderFieldSchema | ColorPickerFieldSchema | SectionHeaderFieldSchema | SeparatorFieldSchema | ButtonGroupFieldSchema<string | number> | ColorSelectFieldSchema | SectionLayoutSelectFieldSchema | BackgroundFieldSchema | ContentPositionFieldSchema | TextSizeSelectFieldSchema | CssUnitFieldSchema | FontPickerFieldSchema | StringArrayFieldSchema | BorderRadiusFieldSchema | ScreenPickerFieldSchema;
-/**
-* Schema for per-item configuration in custom data sources.
-* Widgets can define this to allow users to configure widget-specific
-* settings for each selected item (e.g., title, description, button).
-*/
-interface ItemConfigSchema {
-  /** Fields available for per-item configuration */
-  fields: PropertyField[];
-  /** Optional description shown at top of item config panel */
-  description?: string;
-}
+};
+//#endregion
+//#region ../../messaging/core/src/messaging-api.d.ts
 /**
-* Schema for a widget's editable properties
+* Interface defining all messaging API operations that core hooks need.
+* Each app provides an implementation via {@link MessagingApiProvider},
+* decoupling shared packages from concrete API clients.
 */
-interface WidgetPropertySchema {
-  /** Widget type this schema applies to */
-  widgetType: WidgetType;
-  /** Display name for the widget */
-  displayName: string;
-  /** Optional tab configuration - if present, tabs are enabled */
-  tabsConfig?: TabConfig[];
-  /** Editable property fields */
-  fields: PropertyField[];
-  /** Optional custom validator function */
-  validate?: (props: Record<string, unknown>) => string | null;
-  /** Props that can be populated from data sources */
-  dataSourceTargetProps?: string[];
-  /** Optional schema for per-item configurations in custom data sources */
-  itemConfigSchema?: ItemConfigSchema;
+interface MessagingApi {
+  listConversations(input?: ListConversationsInput): Promise<Paginated<Conversation$1>>;
+  getConversation(conversationId: number): Promise<Conversation$1>;
+  findConversation(input: FindConversationInput): Promise<Conversation$1>;
+  createConversation(input: ConversationCreateInput): Promise<Conversation$1>;
+  getAnnouncementChannel(): Promise<Conversation$1>;
+  listMessages(conversationId: number, input?: {
+    preview?: boolean;
+    message_id?: number;
+    after?: number;
+    before?: number;
+    sorted_by?: string;
+    per_page?: number;
+    page?: number;
+  }): Promise<Paginated<FluidMessage>>;
+  createMessage(conversationId: number, input: CreateMessageInput): Promise<FluidMessage>;
+  replyToMessage(conversationId: number, messageId: number, input: CreateMessageInput): Promise<FluidMessage>;
+  reactToMessage(conversationId: number, input: {
+    message_id: number;
+    reaction: string;
+  }): Promise<string>;
+  unreactToMessage(conversationId: number, input: {
+    message_id: number;
+  }): Promise<string>;
+  pinMessage(conversationId: number, messageId: number): Promise<MessagePinResponse>;
+  unpinMessage(conversationId: number, messageId: number): Promise<MessagePinResponse>;
+  listPinnedMessages(conversationId: number, input?: {
+    sorted_by?: string;
+    per_page?: number;
+    page?: number;
+  }): Promise<Paginated<FluidMessage>>;
+  listScheduledMessages(conversationId: number, input?: {
+    per_page?: number;
+    page?: number;
+  }): Promise<Paginated<FluidMessage>>;
+  createScheduledMessage(conversationId: number, input: ScheduledMessageInput): Promise<FluidMessage>;
+  updateScheduledMessage(conversationId: number, id: number, input: ScheduledMessageInput): Promise<FluidMessage>;
+  destroyScheduledMessage(conversationId: number, id: number): Promise<{
+    success: boolean;
+    message: string;
+  }>;
+  listMyScheduledMessages(input?: {
+    per_page?: number;
+    page?: number;
+  }): Promise<Paginated<DraftMessage>>;
+  saveDraft(conversationId: number, input: SaveDraftInput): Promise<DraftMessage | Record<string, never>>;
+  destroyDraft(conversationId: number): Promise<unknown>;
+  searchRecipientsCount(input: {
+    filter: Record<string, unknown>;
+  }): Promise<RecipientSearchCount>;
+  listConnectedRecipients(input: ListConnectedRecipientsInput): Promise<Paginated<Recipient | WithContactRecipient>>;
 }
 //#endregion
-//#region ../core/src/registries/field-helpers.d.ts
-/**
-* Gap value mapping - use `as const satisfies` for compile-time validation
-* with literal type preservation.
-*/
-declare const gapValues: {
-  readonly none: 0;
-  readonly xs: 1;
-  readonly sm: 2;
-  readonly md: 4;
-  readonly lg: 6;
-  readonly xl: 8;
-};
+//#region src/messaging/use-messaging-auth.d.ts
+declare function useMessagingAuth(): MessagingAuthContext;
 //#endregion
-//#region ../core/src/registries/container-types.d.ts
+//#region ../../messaging/api-client/src/client.d.ts
 /**
-* Interface for container widget behavior.
-* Container widgets can hold and manage child widgets.
-* Note: Children can be null for sparse arrays (e.g., grid layouts with empty cells)
+* Configuration for the messaging API client.
+* The consuming app provides auth headers and base URL.
 */
-interface ContainerWidgetBehavior {
-  /** Identifies this widget type as a container */
-  isContainer: true;
-  /** Gets children from the widget's props */
-  getChildren: (props: Record<string, unknown>) => (WidgetSchema | null)[];
-  /** Creates new props with updated children */
-  setChildren: (props: Record<string, unknown>, children: (WidgetSchema | null)[]) => Record<string, unknown>;
-  /** Optional: Check if this container accepts a specific widget type */
-  canAcceptChild?: (childType: string) => boolean;
+interface MessagingApiConfig {
+  baseUrl: string;
+  getHeaders: () => Record<string, string> | Promise<Record<string, string>>;
+  onAuthError?: () => void;
 }
 //#endregion
-//#region ../core/src/registries/widget-manifest.d.ts
+//#region src/messaging/use-messaging-config.d.ts
+interface MessagingConfig {
+  readonly apiConfig: MessagingApiConfig;
+  readonly messagingApi: MessagingApi;
+  readonly websocketUrl: string;
+}
+declare function useMessagingConfig(): MessagingConfig;
+//#endregion
+//#region src/messaging/fluid-file-uploader.d.ts
 /**
-* The manifest a plugin author provides to register a custom widget.
-* Required fields ensure the widget works in both builder and SDK contexts.
-* Optional fields enable advanced behavior (containers, min SDK version).
+* Creates a FileUploader that uploads to Filestack using the REST API.
+*
+* @param apiKey - Filestack API key. If falsy, returns a noop uploader
+*                 that rejects uploads with a helpful error message.
 */
-interface WidgetManifest {
-  /** Schema version for forward compatibility. Currently must be 1. */
-  manifestVersion: number;
-  /** Unique widget type identifier (e.g., "StockTickerWidget"). */
-  type: string;
-  /** The React component that renders this widget. */
-  component: AnyComponent;
-  /** Human-readable name shown in the builder palette. */
-  displayName: string;
-  /** Brief description shown in the builder palette. */
-  description: string;
-  /** Icon identifier for the builder palette (e.g., "chart-line"). */
-  icon: string;
-  /** Category ID for palette grouping (e.g., "components", "blocks", "utility"). */
-  category: string;
-  /** Property schema defining editable fields in the builder's property panel. */
-  propertySchema: WidgetPropertySchema;
-  /** Default prop values when the widget is first created. */
-  defaultProps: Record<string, unknown>;
-  /** Container behavior — only if this widget can hold child widgets. */
-  container?: ContainerWidgetBehavior;
-  /** Minimum SDK version required (e.g., "1.0.0"). */
-  minSdkVersion?: string;
-  /** Resizable configuration. */
-  resizable?: {
-    horizontal?: boolean;
-    vertical?: boolean;
-    minWidth?: number;
-    minHeight?: number;
-  };
-}
+declare function createFluidFileUploader(apiKey: string | undefined): FileUploader;
 //#endregion
 //#region ../widgets/src/widgets/TextWidget.d.ts
 type TextAlignment = "left" | "center" | "right";