unlayer-types 1.372.0 → 1.377.0

package/embed.d.ts

@@ -1341,6 +1341,19 @@ declare module "packages/editor/src/engine/constants" {
         IS_SAFARI: boolean;
     };
 }
+declare module "packages/editor/src/engine/config/optionGroups" {
+    export interface OptionGroup<T> {
+        label: string;
+        options: OptionItem<T>[];
+    }
+    export type OptionItem<T> = T | OptionGroup<T>;
+    export function isOptionGroup<T>(item: OptionItem<T>): item is OptionGroup<T>;
+    export function extractFlatOptions<T>(items?: OptionItem<T>[]): T[];
+    export function buildRootItems<T>(groups: OptionGroup<T>[]): OptionItem<T>[];
+    export function getItemsAtPath<T>(rootItems: OptionItem<T>[], path: number[]): OptionItem<T>[];
+    export function findPathToValue<T>(items: OptionItem<T>[], targetValue: string, getOptionValue: (item: T) => string, currentPath?: number[]): number[] | null;
+    export function hasNestedValue<T>(item: OptionItem<T>, targetValue: string, getOptionValue: (item: T) => string): boolean;
+}
 declare module "packages/editor/src/state/types/types" {
     import * as Ariakit from '@ariakit/react';
     import { MutableRefObject, ReactInstance } from 'react';
@@ -1580,9 +1593,12 @@ declare module "packages/editor/src/state/types/types" {
         };
         schemaVersion?: number;
     };
+    export type { OptionGroup, OptionItem } from "packages/editor/src/engine/config/optionGroups";
+    export type FontGroup = import("packages/editor/src/engine/config/optionGroups").OptionGroup<CustomFont>;
+    export type FontItem = import("packages/editor/src/engine/config/optionGroups").OptionItem<CustomFont>;
     export type Fonts = {
         showDefaultFonts?: boolean;
-        customFonts?: CustomFont[];
+        customFonts?: FontItem[];
     };
     export type Icon = {
         name?: string;
@@ -1962,14 +1978,32 @@ declare module "packages/editor/src/engine/config/callbacks" {
         remove: () => void;
     };
 }
+declare module "packages/editor/src/engine/utils/fonts" {
+    /**
+     * Extracts the primary (first) font from a CSS font-family value.
+     * Handles quoted fonts like "'Open Sans', Arial, sans-serif" -> "Open Sans"
+     * And unquoted fonts like "arial,helvetica,sans-serif" -> "arial"
+     */
+    export function extractPrimaryFont(fontFamily: string | undefined): string;
+    export function parseFontFamily(fontFamily: string | undefined): string[];
+    export function fontsMatch(fontA: string | undefined, fontB: string | undefined): boolean;
+    export function findMatchingFont(fontFamily: string | undefined, availableFonts: Array<{
+        label: string;
+        value: string;
+    }>): string;
+}
 declare module "packages/editor/src/engine/config/fonts" {
     import { z } from 'zod';
     import { FontZodSchema } from '@libs/schemas/common/schemas';
+    import { OptionGroup, OptionItem } from "packages/editor/src/engine/config/optionGroups";
     export type Font = z.infer<typeof FontZodSchema>;
     export type FontList = Font[];
+    export type FontGroup = OptionGroup<Font>;
+    export type FontItem = OptionItem<Font>;
+    export function isFontGroup(item: FontItem): item is FontGroup;
     export interface FontConfig {
         showDefaultFonts?: boolean;
-        customFonts?: FontList;
+        customFonts?: FontItem[];
     }
     export interface FontOptions {
         showCustomFonts?: boolean;
@@ -1982,6 +2016,7 @@ declare module "packages/editor/src/engine/config/fonts" {
     export function getFontsVersion(): number;
     export function getCustomFontsCount(): number;
     export const defaultFontWeights: number[];
+    export function getGroupedFonts(options?: FontOptions): FontGroup[] | null;
 }
 declare module "packages/editor/src/engine/config/safeHtml" {
     import { Config } from 'dompurify';

package/package.json

@@ -1,5 +1,5 @@
 {
   "name": "unlayer-types",
-  "version": "1.372.0",
+  "version": "1.377.0",
   "license": "MIT"
 }