@salesforce/ui-design-mode 10.2.2 → 10.4.0

package/dist/authoring/core/utils/colorUtils.d.ts

@@ -0,0 +1,73 @@
+import { Color, Oklch, Oklab, Lch, Lab, Rgb, Hsl } from 'culori';
+export interface RgbaColor {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+export type { Oklch, Oklab, Lch, Lab, Rgb, Hsl };
+/**
+ * Check if a string is a valid CSS color value.
+ */
+export declare function isValidColor(value: string | null | undefined): boolean;
+/**
+ * Parse any CSS color string to { r, g, b, a }.
+ */
+export declare function parseColorToRgba(value: string | null | undefined): RgbaColor;
+/**
+ * Convert RGBA object to CSS string.
+ */
+export declare function rgbaToString(rgba: RgbaColor): string;
+/**
+ * Check if string is a valid hex color.
+ */
+export declare function isValidHexColor(color: string): boolean;
+/**
+ * Convert RGBA object to hex string.
+ */
+export declare function rgbaToHex(rgba: RgbaColor): string;
+/**
+ * Detect the color space mode from a color string.
+ */
+export declare function getColorMode(value: string | null | undefined): string;
+/**
+ * Convert RGBA to a specific color space.
+ */
+export declare function rgbaToColorSpace(rgba: RgbaColor, mode: "oklch"): Oklch;
+export declare function rgbaToColorSpace(rgba: RgbaColor, mode: "oklab"): Oklab;
+export declare function rgbaToColorSpace(rgba: RgbaColor, mode: "lch"): Lch;
+export declare function rgbaToColorSpace(rgba: RgbaColor, mode: "lab"): Lab;
+export declare function rgbaToColorSpace(rgba: RgbaColor, mode: string): Color | undefined;
+/**
+ * Convert color from any space back to RGBA.
+ */
+export declare function colorSpaceToRgba(color: Color | undefined): RgbaColor;
+/**
+ * Format color object to CSS string.
+ */
+export declare function formatColorSpace(color: Color | undefined): string;
+/**
+ * Convert RGB (0-255) to HSL.
+ */
+export declare function rgbToHsl(rgb: {
+    r: number;
+    g: number;
+    b: number;
+}): {
+    h: number;
+    s: number;
+    l: number;
+};
+/**
+ * Convert HSL to RGB (0-255).
+ */
+export declare function hslToRgb(hsl: {
+    h: number;
+    s: number;
+    l: number;
+}): {
+    r: number;
+    g: number;
+    b: number;
+};
+//# sourceMappingURL=colorUtils.d.ts.map

package/dist/authoring/core/utils/colorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorUtils.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/utils/colorUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIN,KAAK,KAAK,EACV,KAAK,KAAK,EACV,KAAK,KAAK,EACV,KAAK,GAAG,EACR,KAAK,GAAG,EACR,KAAK,GAAG,EACR,KAAK,GAAG,EACR,MAAM,QAAQ,CAAC;AAShB,MAAM,WAAW,SAAS;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AA4BjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CActE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAsC5E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGtD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAejD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;AACxE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,GAAG,CAAC;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,GAAG,CAAC;AACpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAyBnF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,SAAS,CAWpE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV,CAgBA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV,CAgBA"}

package/dist/authoring/core/utils/dimensionUtils.d.cts

@@ -0,0 +1,81 @@
+export interface UnitOption {
+    value: string;
+    label: string;
+}
+export interface UnitConstraint {
+    min: number;
+    max: number;
+    step: number;
+    decimals: number;
+}
+export type UnitConstraints = Record<string, UnitConstraint>;
+export interface ParsedCssValue {
+    numericValue: number | "";
+    unit: string;
+}
+export interface BoxSides {
+    top: string;
+    right: string;
+    bottom: string;
+    left: string;
+}
+export interface DimensionConfig {
+    units?: readonly UnitOption[];
+    defaultUnit?: string;
+    constraints?: UnitConstraints;
+    icon?: React.ComponentType<{
+        size?: number;
+        width?: number;
+        height?: number;
+    }>;
+}
+export interface BoxDimensionConfig {
+    units?: readonly UnitOption[];
+    sideLabels?: string[];
+}
+export declare const CSS_UNITS: readonly UnitOption[];
+export declare const DEFAULT_UNIT_CONSTRAINTS: UnitConstraints;
+/**
+ * Build a regex that matches a number followed by one of the given units.
+ */
+export declare function buildUnitPattern(units: readonly UnitOption[] | UnitOption[]): RegExp;
+/**
+ * Parse a CSS dimension string into { numericValue, unit }.
+ * Handles "16px", "1.5rem", "100%", bare numbers, and empty/null.
+ */
+export declare function parseCssValue(raw: string | number | null | undefined, defaultUnit?: string, unitPattern?: RegExp): ParsedCssValue;
+/**
+ * Look up the constraints for a unit, falling back to px constraints.
+ */
+export declare function getUnitConstraints(unit: string, constraints?: UnitConstraints): UnitConstraint;
+/**
+ * Clamp a numeric value to the min/max range for the given unit.
+ */
+export declare function clampCssValue(num: number, unit: string, constraints?: UnitConstraints): number;
+/**
+ * Round a numeric value to the appropriate decimal places for the given unit.
+ * Returns '' for empty / non-numeric input.
+ */
+export declare function formatCssValue(num: number | "" | null | undefined, unit: string, constraints?: UnitConstraints): number | "";
+/**
+ * Combine a numeric value and unit into a CSS string (e.g. 16, 'px' → "16px").
+ * Returns '' for empty / non-numeric input.
+ */
+export declare function buildCssString(numericValue: number | "" | null | undefined, unit: string): string;
+/**
+ * Compute the next value after an arrow-key increment/decrement.
+ */
+export declare function stepValue(currentValue: string, key: "ArrowUp" | "ArrowDown", shiftKey: boolean, unit: string, constraints?: UnitConstraints): string;
+/**
+ * Build a CSS box-model shorthand string (top right bottom left).
+ * Always emits all four values for simplicity.
+ */
+export declare function buildBoxShorthandCssValue({ top, right, bottom, left }: BoxSides): string;
+/**
+ * Parse a CSS box-model shorthand string into four side values.
+ * Handles 1–4 value shorthand syntax.
+ */
+export declare function parseBoxShorthandCssValue(shorthand: string | null | undefined): BoxSides;
+export declare const DIMENSION_CONFIGS: Record<string, DimensionConfig>;
+export declare const BOX_DIMENSION_CONFIGS: Record<string, BoxDimensionConfig>;
+//# sourceMappingURL=dimensionUtils.d.ts.map

package/dist/authoring/core/utils/dimensionUtils.d.ts

@@ -0,0 +1,81 @@
+export interface UnitOption {
+    value: string;
+    label: string;
+}
+export interface UnitConstraint {
+    min: number;
+    max: number;
+    step: number;
+    decimals: number;
+}
+export type UnitConstraints = Record<string, UnitConstraint>;
+export interface ParsedCssValue {
+    numericValue: number | "";
+    unit: string;
+}
+export interface BoxSides {
+    top: string;
+    right: string;
+    bottom: string;
+    left: string;
+}
+export interface DimensionConfig {
+    units?: readonly UnitOption[];
+    defaultUnit?: string;
+    constraints?: UnitConstraints;
+    icon?: React.ComponentType<{
+        size?: number;
+        width?: number;
+        height?: number;
+    }>;
+}
+export interface BoxDimensionConfig {
+    units?: readonly UnitOption[];
+    sideLabels?: string[];
+}
+export declare const CSS_UNITS: readonly UnitOption[];
+export declare const DEFAULT_UNIT_CONSTRAINTS: UnitConstraints;
+/**
+ * Build a regex that matches a number followed by one of the given units.
+ */
+export declare function buildUnitPattern(units: readonly UnitOption[] | UnitOption[]): RegExp;
+/**
+ * Parse a CSS dimension string into { numericValue, unit }.
+ * Handles "16px", "1.5rem", "100%", bare numbers, and empty/null.
+ */
+export declare function parseCssValue(raw: string | number | null | undefined, defaultUnit?: string, unitPattern?: RegExp): ParsedCssValue;
+/**
+ * Look up the constraints for a unit, falling back to px constraints.
+ */
+export declare function getUnitConstraints(unit: string, constraints?: UnitConstraints): UnitConstraint;
+/**
+ * Clamp a numeric value to the min/max range for the given unit.
+ */
+export declare function clampCssValue(num: number, unit: string, constraints?: UnitConstraints): number;
+/**
+ * Round a numeric value to the appropriate decimal places for the given unit.
+ * Returns '' for empty / non-numeric input.
+ */
+export declare function formatCssValue(num: number | "" | null | undefined, unit: string, constraints?: UnitConstraints): number | "";
+/**
+ * Combine a numeric value and unit into a CSS string (e.g. 16, 'px' → "16px").
+ * Returns '' for empty / non-numeric input.
+ */
+export declare function buildCssString(numericValue: number | "" | null | undefined, unit: string): string;
+/**
+ * Compute the next value after an arrow-key increment/decrement.
+ */
+export declare function stepValue(currentValue: string, key: "ArrowUp" | "ArrowDown", shiftKey: boolean, unit: string, constraints?: UnitConstraints): string;
+/**
+ * Build a CSS box-model shorthand string (top right bottom left).
+ * Always emits all four values for simplicity.
+ */
+export declare function buildBoxShorthandCssValue({ top, right, bottom, left }: BoxSides): string;
+/**
+ * Parse a CSS box-model shorthand string into four side values.
+ * Handles 1–4 value shorthand syntax.
+ */
+export declare function parseBoxShorthandCssValue(shorthand: string | null | undefined): BoxSides;
+export declare const DIMENSION_CONFIGS: Record<string, DimensionConfig>;
+export declare const BOX_DIMENSION_CONFIGS: Record<string, BoxDimensionConfig>;
+//# sourceMappingURL=dimensionUtils.d.ts.map

package/dist/authoring/core/utils/dimensionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimensionUtils.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/utils/dimensionUtils.ts"],"names":[],"mappings":"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"}

package/dist/authoring/core/utils/domUtils.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export declare function getScrollParent(el: HTMLElement | null | undefined): HTMLElement | null;
+//# sourceMappingURL=domUtils.d.ts.map

package/dist/authoring/core/utils/domUtils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export declare function getScrollParent(el: HTMLElement | null | undefined): HTMLElement | null;
+//# sourceMappingURL=domUtils.d.ts.map

package/dist/authoring/core/utils/domUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domUtils.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/utils/domUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAQtF"}

package/dist/authoring/react/index.d.cts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * `/authoring/react` entry: the raw React property-panel component for hosts
+ * that already run React on the page. React / react-dom are externalized by the
+ * bundler, so the host provides the single React copy. Non-React hosts should
+ * use `/authoring/web-component` instead.
+ */
+export { DesignPropertyPanel, mountDesignPropertyPanel } from '../core/DesignPropertyPanelRoot.cjs';
+export type { DesignPropertyPanelProps, DesignPropertyPanelHandle, DesignPanelComponent, StylesEntryMap, AgentforceComponentContext, OpenSourceFilePayload, } from '../core/DesignPropertyPanelRoot.cjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/authoring/react/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * `/authoring/react` entry: the raw React property-panel component for hosts
+ * that already run React on the page. React / react-dom are externalized by the
+ * bundler, so the host provides the single React copy. Non-React hosts should
+ * use `/authoring/web-component` instead.
+ */
+export { DesignPropertyPanel, mountDesignPropertyPanel } from '../core/DesignPropertyPanelRoot.js';
+export type { DesignPropertyPanelProps, DesignPropertyPanelHandle, DesignPanelComponent, StylesEntryMap, AgentforceComponentContext, OpenSourceFilePayload, } from '../core/DesignPropertyPanelRoot.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/authoring/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EACX,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,GACrB,MAAM,iCAAiC,CAAC"}