@carto/ps-react-ui 5.0.0-widgets.9 → 5.1.0

package/dist/types/chat/types.d.ts

@@ -0,0 +1,214 @@
+import { ReactNode } from 'react';
+import { ButtonBaseProps, SxProps, Theme } from '@mui/material';
+export interface ChatSxProps {
+    sx?: SxProps<Theme>;
+}
+export interface ChatErrorAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ChatUserMessageProps extends ChatSxProps {
+    children: ReactNode;
+    /** enabled to render text with a lighter color for indicating things like an error sending the message */
+    muted?: boolean;
+    /** content to render on top of the message for user attachments */
+    topContext?: ReactNode;
+}
+export interface ChatAgentMessageProps extends ChatSxProps {
+    children: ReactNode;
+}
+export interface ChatAgentMessageMarkdownProps extends ChatSxProps {
+    /**
+     * Markdown source — rendered as GitHub-Flavored Markdown (tables, task lists,
+     * strikethrough) through the library's sanitized renderer, inside a
+     * `ChatAgentMessage`. Raw HTML is skipped and images are stripped, since the
+     * content is model output.
+     */
+    children: string;
+}
+export interface ChatErrorMessageProps extends ChatSxProps {
+    errors: string[];
+    icon?: ReactNode;
+    actions?: ChatErrorAction[];
+}
+export interface ChatSuggestionButtonProps extends ChatSxProps, Omit<ButtonBaseProps, 'children'> {
+    label: ReactNode;
+    color?: string;
+}
+export interface ChatThinkingProps extends ChatSxProps {
+    duration?: number;
+    children?: ReactNode;
+}
+export interface ChatLoaderProps extends ChatSxProps {
+    size?: number;
+    labels?: {
+        loading?: string;
+    };
+}
+export interface ChatContentProps extends ChatSxProps {
+    children: ReactNode;
+    /**
+     * Smooth-scrolls to the bottom whenever new content is added — but only if
+     * the user was already at (or near) the bottom. Readers who scrolled up to
+     * revisit older messages are left alone. Defaults to `true`; pass `false`
+     * to opt out and manage scroll yourself via the ref.
+     */
+    autoScroll?: boolean;
+    labels?: {
+        jumpToLatest?: string;
+    };
+}
+/**
+ * Imperative handle exposed by `ChatContent` via `ref`. Use it to drive scroll
+ * from the parent — for example, calling `scrollToBottom()` when a new agent
+ * message arrives.
+ */
+export interface ChatContentRef {
+    /** Smooth-scrolls the content area to the bottom. */
+    scrollToBottom: () => void;
+    /** Smooth-scrolls the content area to the top. */
+    scrollToTop: () => void;
+    /** `true` when the content area is scrolled to (or near) its bottom edge. */
+    isAtBottom: boolean;
+    /** `true` when the content area is scrolled to (or near) its top edge. */
+    isAtTop: boolean;
+}
+export interface ChatHeaderProps extends ChatSxProps {
+    leftSlot?: ReactNode;
+    title: ReactNode;
+    rightSlot?: ReactNode;
+    onClose?: () => void;
+}
+export interface ChatFooterProps extends ChatSxProps {
+    /** Current value of the chat message area. */
+    value: string;
+    /** Called with the new textarea value on every keystroke. */
+    onChange: (value: string) => void;
+    /** Called when the send button is clicked or Enter is pressed (without Shift). */
+    onSend: () => void;
+    /** Called when the stop button is clicked. Only shown while `isGenerating` is true. */
+    onStop?: () => void;
+    /** When true, swaps the send button for a stop button and disables the textarea. */
+    isGenerating?: boolean;
+    /** Disables the textarea and both send/stop buttons. */
+    disabled?: boolean;
+    /** Placeholder text for the textarea. Defaults to `'Type a message...'`. */
+    placeholder?: string;
+    /** Accessible labels for the send and stop buttons (used as `aria-label`). */
+    labels?: {
+        /** Defaults to `'Send'`. */
+        send?: string;
+        /** Defaults to `'Stop'`. */
+        stop?: string;
+        /** `aria-label` for the model-selector trigger. Defaults to `'Select model'`. */
+        model?: string;
+    };
+    /** Helper text rendered under the input. Defaults to an AI disclaimer; pass `null` to hide. */
+    caption?: ReactNode;
+    /**
+     * Selectable models for the in-toolbar model selector. The selector is only
+     * rendered when this is a non-empty array; the component is otherwise
+     * model-agnostic (the host owns the list, selection, and default).
+     */
+    models?: ChatModelOption[];
+    /** Currently selected model `value`. Controlled — the host owns the state. */
+    selectedModel?: string;
+    /** Called with the picked model `value` when the user selects one. */
+    onModelChange?: (value: string) => void;
+    /** Extra controls rendered at the start (left) of the toolbar, before the model selector. */
+    startToolbarSlot?: ReactNode;
+    /** Extra controls rendered at the end (right) of the toolbar, before the send/stop button. */
+    endToolbarSlot?: ReactNode;
+}
+/** An option for the `ChatFooter` model selector. */
+export interface ChatModelOption {
+    value: string;
+    label: string;
+}
+export interface ChatStarterItem {
+    label: string;
+    color?: string;
+}
+export interface ChatStarterProps extends ChatSxProps {
+    icon?: ReactNode;
+    title?: ReactNode;
+    description?: ReactNode;
+    items: string[] | ChatStarterItem[];
+    size?: 'small' | 'medium';
+    onSelect?: (prompt: string) => void;
+}
+export interface ChatRatingActionProps {
+    onRatingChange?: (rating: 'up' | 'down' | null) => void;
+    rating?: 'up' | 'down' | null;
+    labels?: {
+        thumbUp?: string;
+        thumbDown?: string;
+    };
+}
+export interface ChatToolItem {
+    id: string;
+    name: string;
+    status: 'running' | 'complete' | 'error';
+    /** Display label shown while status is 'running'. Falls back to a capitalized `name`. */
+    runningLabel?: string;
+    /** Display label shown for non-running statuses. Falls back to a capitalized `name`. */
+    label?: string;
+    /** Friendly reference name for the tool (e.g. "add_marker"). Displayed with icon. */
+    reference?: string;
+    /** Execution duration in seconds (e.g. 1.8) */
+    duration?: number;
+    /** Input arguments as a JSON string or plain text */
+    inputArguments?: string;
+    /** Output as a JSON string or plain text */
+    output?: string;
+}
+export interface ChatToolTraceProps extends ChatSxProps {
+    tool: ChatToolItem;
+    /** Whether the trace accordion is expanded */
+    expanded?: boolean;
+    /** Callback when accordion expansion state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    labels?: {
+        toolExecuted?: string;
+        reference?: string;
+        duration?: string;
+        status?: string;
+        inputArguments?: string;
+        output?: string;
+        fullView?: string;
+        success?: string;
+        error?: string;
+        running?: string;
+    };
+}
+export interface ChatToolCodeAreaProps extends ChatSxProps {
+    /** Code content to display */
+    content: string;
+    /** Label for the full view dialog title */
+    title?: string;
+    /** Render with error styling (red left border, tinted background) */
+    isError?: boolean;
+    labels?: {
+        fullView?: string;
+    };
+}
+export interface ChatToolFullViewDialogProps {
+    open: boolean;
+    onClose: () => void;
+    title: string;
+    content: string;
+}
+export interface ChatToolGroupProps extends ChatSxProps {
+    tools: ChatToolItem[];
+    /** Whether the group accordion is expanded */
+    expanded?: boolean;
+    /** Callback when group expansion state changes */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Map of tool IDs to their individual expanded state. Used to preserve expansion state during grouping. */
+    expandedTools?: Record<string, boolean>;
+    /** Callback when an individual tool's expansion state changes */
+    onToolExpandedChange?: (value: Record<string, boolean>, toolId?: string) => void;
+    labels?: ChatToolTraceProps['labels'] & {
+        toolsUsed?: string;
+    };
+}

package/dist/types/chat/use-typewriter.d.ts

@@ -0,0 +1,32 @@
+interface UseTypewriterOptions {
+    /** Characters revealed per second (default: `500`). */
+    speed?: number;
+    /** When true, reveal the full text immediately (and snap to it if it grows). */
+    skipAnimation?: boolean;
+}
+interface UseTypewriterResult {
+    /** The portion of `fullText` revealed so far. */
+    displayedText: string;
+    /** `true` while characters are still being revealed. */
+    isTyping: boolean;
+}
+/**
+ * Reveals a string character-by-character at a steady rate via
+ * `requestAnimationFrame`. Designed for bursty, streamed agent text: as
+ * `fullText` grows the reveal keeps chasing the new end, and flipping
+ * `skipAnimation` to `true` (e.g. once generation finishes) snaps to the full
+ * text. Pair it with `ChatAgentMessage`.
+ *
+ * @example
+ * ```tsx
+ * const { displayedText, isTyping } = useTypewriter(message)
+ * return (
+ *   <ChatAgentMessage>
+ *     <Markdown>{displayedText}</Markdown>
+ *     {isTyping ? <Cursor /> : null}
+ *   </ChatAgentMessage>
+ * )
+ * ```
+ */
+export declare function useTypewriter(fullText: string, options?: UseTypewriterOptions): UseTypewriterResult;
+export {};

package/dist/types/components/basemaps/basemaps.d.ts

@@ -1,3 +1,23 @@
-import { BasemapsUIProps } from './types';
+import { BasemapsUIProps } from './types.js';
 import { JSX } from 'react';
+/**
+ * Provides an interactive basemap selector with responsive drawer, grouping support, and customizable positioning.
+ *
+ * @remarks
+ * This is an uncontrolled component focused on UI presentation. Typically used with the `BasemapsControls` HOC from `@carto/ps-react-maps` for automatic state management.
+ *
+ * @example
+ * ```tsx
+ * <BasemapsControls mapId={mapId}>
+ *   {({ basemap, setBasemap }) => (
+ *     <BasemapsUI
+ *       options={basemapOptions}
+ *       selected={basemap}
+ *       onChange={setBasemap}
+ *       position="bottom-right"
+ *     />
+ *   )}
+ * </BasemapsControls>
+ * ```
+ */
 export declare function BasemapsUI({ options, labels: _labels, position, selected, onChange, TooltipProps, }: BasemapsUIProps): JSX.Element;

package/dist/types/components/basemaps/const.d.ts

@@ -1,2 +1,2 @@
-import { BasemapsUILabels } from './types';
+import { BasemapsUILabels } from './types.js';
 export declare const DEFAULT_BASEMAPS_LABELS: BasemapsUILabels;

package/dist/types/components/basemaps/group-wrapper.d.ts

@@ -3,4 +3,4 @@ export declare function GroupWrapper({ title, children, collapsed, }: {
     title: string;
     children: ReactNode;
     collapsed?: boolean;
-}): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react/jsx-runtime").JSX.Element | null | undefined;
+}): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import('react').ReactPortal | import('react').ReactElement<unknown, string | import('react').JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import('react').JSX.Element | null | undefined;

package/dist/types/components/basemaps/group.d.ts

@@ -1,6 +1,6 @@
-import { BasemapOption } from './types';
+import { BasemapOption } from './types.js';
 export declare function Group({ values, selected, onChange, }: {
     values: Omit<BasemapOption, 'group'>[];
     selected: string | null | undefined;
     onChange: (id: string) => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): import('react').JSX.Element;

package/dist/types/components/basemaps/header.d.ts

@@ -1,6 +1,6 @@
-import { BasemapsUILabels } from './types';
+import { BasemapsUILabels } from './types.js';
 export declare function Header({ isMobile, labels, onChangeCollapsed, }: {
     labels: BasemapsUILabels['header'];
     isMobile?: boolean;
     onChangeCollapsed: () => void;
-}): import("react/jsx-runtime").JSX.Element;
+}): import('react').JSX.Element;

package/dist/types/components/common-types.d.ts

@@ -0,0 +1,49 @@
+import type { ReactNode } from 'react';
+import type { Class } from 'type-fest';
+type GeoJsonEditMode = unknown;
+export interface EditableModesMapping {
+    icon: ReactNode;
+}
+export type MeasurementSystem = 'metric' | 'imperial';
+export type MeasurementUnitMetricDistance = 'm-km' | 'kilometer' | 'meter' | 'centimeter' | 'milimeter';
+export type MeasurementUnitImperialDistance = 'ft-mi' | 'mile' | 'yard' | 'feet';
+export type MeasurementUnit = MeasurementUnitMetricDistance | MeasurementUnitImperialDistance;
+export type MeasurementMode = 'distance' | 'buffer' | 'area';
+export interface MeasurementModeOption<M extends string = MeasurementMode, T = GeoJsonEditMode> {
+    value: M;
+    mode: Class<T>;
+}
+export type MeasurementModes<M extends string = MeasurementMode, T = GeoJsonEditMode> = Record<M, MeasurementModeOption<M, T>>;
+export interface MeasurementUnitOption<U extends string = MeasurementUnit> {
+    value: U;
+    system?: MeasurementSystem;
+}
+export type MeasurementUnits<T extends string = keyof MeasurementModes, U extends string = MeasurementUnit> = Record<T, MeasurementUnitOption<U>[]>;
+export type MeasurementOptionsMode<T extends string = MeasurementMode> = Record<T, string | undefined>;
+export type MeasurementOptionsUnit<T extends string = MeasurementUnit> = Record<T, string | undefined>;
+export type CustomMeasureMode<T> = InstanceType<Class<T>>;
+export type MeasurementModesMapping<T extends string> = Record<T, EditableModesMapping>;
+export interface MeasureUnitMapping {
+    short: string;
+}
+export type MeasurementUnitsMapping<U extends string = MeasurementUnit> = Record<U, MeasureUnitMapping>;
+/**
+ * Lasso tool modes. `select` (formerly `edit`) selects features on click;
+ * geometry editing is a separate session started from the toolbar's
+ * "Edit geometry" action. `lasso-select` selects every feature intersecting a
+ * freehand trace. `text` places a Point annotation with a map label. The legacy
+ * `'edit'` value is still accepted at runtime by `setModeSelected` and mapped
+ * to `'select'`.
+ */
+export type LassoToolsMode = 'polygon' | 'rectangle' | 'circle' | 'lasso' | 'text' | 'select' | 'lasso-select';
+export interface LassoToolsModeOption<M extends string = LassoToolsMode, T = GeoJsonEditMode> {
+    value: M;
+    mode: Class<T>;
+}
+export type LassoToolsModes<M extends string = LassoToolsMode, T = GeoJsonEditMode> = Record<M, LassoToolsModeOption<M, T>>;
+export type LassoToolOptionsMode<M extends string = LassoToolsMode> = Record<M, string | undefined>;
+export type LassoToolsModesMapping<M extends string> = Record<M, EditableModesMapping & {
+    disabled?: boolean;
+}>;
+export type CustomLassoToolsMode<T> = InstanceType<Class<T>>;
+export {};

package/dist/types/components/copy-button/copy-button.d.ts

@@ -0,0 +1,2 @@
+import { CopyButtonProps } from './types.js';
+export declare function CopyButton({ copyText, onSuccess, onError, 'aria-label': ariaLabel, ...props }: CopyButtonProps): import('react').JSX.Element;

package/dist/types/components/copy-button/types.d.ts

@@ -0,0 +1,6 @@
+import { IconButtonProps } from '@mui/material/IconButton';
+export interface CopyButtonProps extends Omit<IconButtonProps, 'onError' | 'onClick'> {
+    copyText: string;
+    onSuccess?: () => void;
+    onError?: (err: Error) => void;
+}

package/dist/types/components/geolocation-controls/geolocation-controls.d.ts

@@ -1,3 +1,14 @@
-import { GeolocationControlProps } from './types';
+import { GeolocationControlProps } from './types.js';
 import { JSX } from 'react';
+/**
+ * Provides a seamless interface for accessing device location through the browser's Geolocation API, with permission handling, continuous tracking, and error management.
+ *
+ * @example
+ * ```tsx
+ * <GeolocationControls
+ *   onChange={(coords) => console.log(coords.latitude, coords.longitude)}
+ *   onError={(error) => console.error(error.message)}
+ * />
+ * ```
+ */
 export declare function GeolocationControls({ disabled, labels, PaperProps, TooltipProps, watch, onChange, onError, }: GeolocationControlProps): JSX.Element;

package/dist/types/components/index.d.ts

@@ -1,20 +1,37 @@
-export type { CustomMeasureMode, MeasurementMode, MeasurementModeOption, MeasurementModes, MeasurementModesMapping, MeasurementOptionsMode, MeasurementOptionsUnit, MeasurementSystem, MeasurementUnit, MeasurementUnitImperialDistance, MeasurementUnitMetricDistance, MeasurementUnitOption, MeasurementUnits, LassoToolsMode, LassoToolsModeOption, LassoToolsModes, LassoToolOptionsMode, LassoToolsModesMapping, } from './types';
-export type { LassoToolsComponentProps, LassoToolsInlineComponentProps, } from './lasso-tool/types';
-export { LassoToolsUI } from './lasso-tool/lasso-tool';
-export { LassoToolsInlineUI } from './lasso-tool/lasso-tool-inline';
-export { DEFAULT_LASSO_TOOLS_MODES_MAPPING, LASSO_TOOLS_LABELS, } from './lasso-tool/const';
-export { DrawCircleIcon, DrawLassoIcon, DrawPolygonIcon, DrawSquareIcon, SelectToolIcon, } from './lasso-tool/icons';
-export type { MeasurementToolsComponentProps } from './measurement-tools/types';
-export { DEFAULT_MEASUREMENT_TOOLS_LABELS, DEFAULT_MEASUREMENT_TOOLS_UNITS_MAPPING, DEFAULT_MEASUREMENT_TOOLS_MODES_MAPPING, } from './measurement-tools/const';
-export { AreaIcon, BufferIcon, RulerIcon } from './measurement-tools/icons';
-export { MeasurementToolsUI } from './measurement-tools/measurement-tools';
-export type { GeolocationControlProps } from './geolocation-controls/types';
-export { GeolocationControls } from './geolocation-controls/geolocation-controls';
-export type { ZoomControlProps } from './zoom-controls/types';
-export { ZoomControlsUI } from './zoom-controls/zoom-controls';
-export type { ListDataProps, DataItem } from './list-data/types';
-export { ListDataUI } from './list-data/list-data';
-export { BasemapsUI } from './basemaps/basemaps';
-export type { BasemapsUIProps } from './basemaps/types';
-export { Tooltip, setTooltipEnterDelay } from './tooltip/tooltip';
-export { SmartTooltip } from './smart-tooltip/smart-tooltip';
+export type { CustomMeasureMode, MeasurementMode, MeasurementModeOption, MeasurementModes, MeasurementModesMapping, MeasurementOptionsMode, MeasurementOptionsUnit, MeasurementSystem, MeasurementUnit, MeasurementUnitImperialDistance, MeasurementUnitMetricDistance, MeasurementUnitOption, MeasurementUnits, LassoToolsMode, LassoToolsModeOption, LassoToolsModes, LassoToolOptionsMode, LassoToolsModesMapping, } from './types.js';
+export type { LassoToolsComponentProps, LassoToolsInlineComponentProps, LassoGeometryToolbarUIProps, LassoToolsUIContextValue, LassoGeometryType, LassoDrawColor, LassoDrawColorPreset, LassoDrawFill, LassoDrawStroke, LassoDrawStyle, LassoLayerFiltersUIProps, LassoLayerFilterItem, LassoMessageUIProps, } from './lasso-tool/types.js';
+export type { InteractionModeSectionProps } from './lasso-tool/options-sections.js';
+export { InteractionModeSection } from './lasso-tool/options-sections.js';
+export { LassoToolsUI } from './lasso-tool/lasso-tool.js';
+export { LassoToolsInlineUI } from './lasso-tool/lasso-tool-inline.js';
+export { LassoGeometryToolbarUI } from './lasso-tool/geometry-toolbar.js';
+export { LassoLayerFiltersUI } from './lasso-tool/layer-filters.js';
+export { LassoMessageUI } from './lasso-tool/message.js';
+export { DEFAULT_LASSO_TOOLS_MODES_MAPPING, LASSO_TOOLS_LABELS, } from './lasso-tool/const.js';
+export { DrawCircleIcon, DrawLassoIcon, DrawPolygonIcon, DrawSquareIcon, LassoSelectIcon, SelectToolIcon, SpatialMaskIcon, TextAaIcon, UnionIcon, } from './lasso-tool/icons.js';
+export type { LassoToolbarUIProps, LassoToolbarButtonUIProps, ToggleTypeActionProps, LabelActionProps, LassoTextPresentation, EditPropertiesActionProps, LockActionProps, DeleteActionProps, ColorActionProps, FillActionProps, StrokeActionProps, UndoActionProps, RedoActionProps, EditGeometryActionProps, UnionActionProps, SplitActionProps, SubtractActionProps, IntersectActionProps, DuplicateActionProps, AcceptActionProps, CancelActionProps, } from './lasso-tool/toolbar/index.js';
+export type { LassoGeometryToolbarContextValue } from './lasso-tool/toolbar/context.js';
+export { useLassoGeometryToolbarAction } from './lasso-tool/toolbar/context.js';
+export { useLassoToolsUIArgs } from './lasso-tool/tools-context.js';
+export { LassoToolbarUI, LassoToolbarButtonUI, ToggleTypeAction, LabelAction, ColorDot, EditPropertiesAction, LockAction, DeleteAction, ColorAction, FillAction, StrokeAction, UndoAction, RedoAction, EditGeometryAction, UnionAction, SplitAction, SubtractAction, IntersectAction, DuplicateAction, AcceptAction, CancelAction, EDIT_GEOMETRY_ACTION_LABELS, UNION_ACTION_LABELS, SPLIT_ACTION_LABELS, SUBTRACT_ACTION_LABELS, INTERSECT_ACTION_LABELS, DUPLICATE_ACTION_LABELS, ACCEPT_ACTION_LABELS, CANCEL_ACTION_LABELS, TOGGLE_TYPE_ACTION_LABELS, LABEL_ACTION_LABELS, EDIT_PROPERTIES_ACTION_LABELS, LOCK_ACTION_LABELS, DELETE_ACTION_LABELS, COLOR_ACTION_LABELS, FILL_ACTION_LABELS, STROKE_ACTION_LABELS, UNDO_ACTION_LABELS, REDO_ACTION_LABELS, LASSO_DRAW_COLOR_HEX, isLassoDrawColorPreset, normalizeHex, } from './lasso-tool/toolbar/index.js';
+export type { LassoUndoRedoUIProps } from './lasso-tool/undo-redo.js';
+export { LassoUndoRedoUI } from './lasso-tool/undo-redo.js';
+export type { LassoEditConfirmToolbarUIProps } from './lasso-tool/edit-confirm-toolbar.js';
+export { LassoEditConfirmToolbarUI } from './lasso-tool/edit-confirm-toolbar.js';
+export type { MeasurementToolsComponentProps } from './measurement-tools/types.js';
+export { DEFAULT_MEASUREMENT_TOOLS_LABELS, DEFAULT_MEASUREMENT_TOOLS_UNITS_MAPPING, DEFAULT_MEASUREMENT_TOOLS_MODES_MAPPING, } from './measurement-tools/const.js';
+export { AreaIcon, BufferIcon, RulerIcon } from './measurement-tools/icons.js';
+export { MeasurementToolsUI } from './measurement-tools/measurement-tools.js';
+export type { GeolocationControlProps } from './geolocation-controls/types.js';
+export { GeolocationControls } from './geolocation-controls/geolocation-controls.js';
+export type { ZoomControlProps } from './zoom-controls/types.js';
+export { ZoomControlsUI } from './zoom-controls/zoom-controls.js';
+export type { ListDataProps, DataItem } from './list-data/types.js';
+export { ListDataUI } from './list-data/list-data.js';
+export { BasemapsUI } from './basemaps/basemaps.js';
+export type { BasemapsUIProps } from './basemaps/types.js';
+export { Tooltip, setTooltipEnterDelay } from './tooltip/tooltip.js';
+export { SmartTooltip } from './smart-tooltip/smart-tooltip.js';
+export { ResponsiveDrawer } from './responsive-drawer/responsive-drawer.js';
+export type { CopyButtonProps } from './copy-button/types.js';
+export { CopyButton } from './copy-button/copy-button.js';

package/dist/types/components/lasso-tool/chip.d.ts

@@ -1,6 +1,6 @@
 import { PickDeep } from 'type-fest';
-import { LassoToolsComponentProps, LassoToolsData } from './types';
+import { LassoToolsComponentProps, LassoToolsData } from './types.js';
 export declare function LassoToolsUIChip({ chipProps, value, labels, onChipToggle, onDelete, }: Pick<LassoToolsComponentProps, 'chipProps' | 'onDelete' | 'onChipToggle'> & {
     value: LassoToolsData;
     labels?: PickDeep<LassoToolsComponentProps['labels'], 'chip'>['chip'];
-}): import("react/jsx-runtime").JSX.Element;
+}): import('react').JSX.Element;

package/dist/types/components/lasso-tool/const.d.ts

@@ -1,5 +1,5 @@
-import { LassoToolsMode, LassoToolsModesMapping } from '../types';
-import { LassoToolsComponentProps } from './types';
+import { LassoToolsMode, LassoToolsModesMapping } from '../types.js';
+import { LassoToolsComponentProps } from './types.js';
 import { RequiredDeep } from 'type-fest';
 export declare const LASSO_TOOLS_LABELS: NonNullable<RequiredDeep<LassoToolsComponentProps['labels']>>;
 export declare const DEFAULT_LASSO_TOOLS_MODES_MAPPING: LassoToolsModesMapping<LassoToolsMode>;

package/dist/types/components/lasso-tool/edit-confirm-toolbar.d.ts

@@ -0,0 +1,26 @@
+import { ComponentProps, JSX } from 'react';
+import { Paper } from '@mui/material';
+export interface LassoEditConfirmToolbarUIProps {
+    /** Commit the edit session (Enter). */
+    onAccept: () => void;
+    /** Discard the edit session (Escape). */
+    onCancel: () => void;
+    labels?: {
+        accept?: string;
+        cancel?: string;
+    };
+    /** Keyboard-shortcut hints appended to each tooltip, e.g. `{ accept: '↵' }`. */
+    shortcuts?: {
+        accept?: string;
+        cancel?: string;
+    };
+    /** Forwarded to `LassoToolbarUI`, which owns the Paper's `ref`. */
+    PaperProps?: Omit<ComponentProps<typeof Paper>, 'ref'>;
+}
+/**
+ * Cancel / Accept mini-toolbar shown above the geometry being edited.
+ * Purely presentational — anchor it with `LassoTools.EditGeometryToolbar`
+ * from `@carto/ps-react-maps`. Label drag during the session is pick-based
+ * (TextLayer vs geometry), not a toolbar action.
+ */
+export declare function LassoEditConfirmToolbarUI({ onAccept, onCancel, labels, shortcuts, PaperProps, }: LassoEditConfirmToolbarUIProps): JSX.Element;

package/dist/types/components/lasso-tool/geometry-toolbar.d.ts

@@ -0,0 +1,49 @@
+import { JSX } from 'react';
+import { LassoGeometryToolbarUIProps } from './types.js';
+import { ConnectedColorAction, ConnectedDeleteAction, ConnectedDuplicateAction, ConnectedEditGeometryAction, ConnectedEditPropertiesAction, ConnectedFillAction, ConnectedIntersectAction, ConnectedLabelAction, ConnectedLockAction, ConnectedSplitAction, ConnectedStrokeAction, ConnectedSubtractAction, ConnectedToggleTypeAction, ConnectedUnionAction } from './toolbar/connected.js';
+/**
+ * Shell for the contextual toolbar of a lasso selection: the floating `Paper`,
+ * plus the state every action needs published on a context. **Which actions it
+ * has is the consumer's call** — list them as children, in the order you want:
+ *
+ * ```tsx
+ * <LassoTools.GeometryToolbar mapId='map1'>
+ *   {(props) => (
+ *     <LassoGeometryToolbarUI {...props}>
+ *       <LassoGeometryToolbarUI.Color />
+ *       <LassoGeometryToolbarUI.Label />
+ *       <LassoGeometryToolbarUI.Divider />
+ *       <LassoGeometryToolbarUI.Delete />
+ *     </LassoGeometryToolbarUI>
+ *   )}
+ * </LassoTools.GeometryToolbar>
+ * ```
+ *
+ * Same contract as widgets-v2: the actions take no data props (they read the
+ * context) and each one renders nothing when its handler is missing, so a
+ * composition can list every action safely. Pre-composed toolbars are
+ * application-level code and live outside this library — see
+ * `apps/storybook/stories/modules/lasso/geometry-toolbar.tsx` for the canonical
+ * example, which reproduces the full CARTO design.
+ *
+ * For a toolbar outside this shell, compose `LassoToolbarUI` with the
+ * prop-driven actions from `lasso-tool/toolbar` instead.
+ */
+export declare function LassoGeometryToolbarUI({ type, label, locked, selectionCount, anyLocked, style, defaultTextColor, onToggleType, onRename, onSetTextPresentation, onToggleLock, onDelete, onSetStyle, onEditGeometry, editingGeometry, onUnion, splittable, onSplit, onSubtract, onIntersect, onDuplicate, selectedIds, properties, onEditProperties, forceTextVisible, labels, PaperProps, children, }: LassoGeometryToolbarUIProps): JSX.Element;
+export declare namespace LassoGeometryToolbarUI {
+    var Color: typeof ConnectedColorAction;
+    var Fill: typeof ConnectedFillAction;
+    var Stroke: typeof ConnectedStrokeAction;
+    var EditGeometry: typeof ConnectedEditGeometryAction;
+    var Label: typeof ConnectedLabelAction;
+    var EditProperties: typeof ConnectedEditPropertiesAction;
+    var ToggleType: typeof ConnectedToggleTypeAction;
+    var Union: typeof ConnectedUnionAction;
+    var Split: typeof ConnectedSplitAction;
+    var Subtract: typeof ConnectedSubtractAction;
+    var Intersect: typeof ConnectedIntersectAction;
+    var Duplicate: typeof ConnectedDuplicateAction;
+    var Lock: typeof ConnectedLockAction;
+    var Delete: typeof ConnectedDeleteAction;
+    var Divider: () => JSX.Element;
+}

package/dist/types/components/lasso-tool/icons.d.ts

@@ -1,6 +1,23 @@
 import { SVGProps } from 'react';
-export declare function DrawPolygonIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
-export declare function DrawSquareIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
-export declare function DrawCircleIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
-export declare function DrawLassoIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
-export declare function SelectToolIcon(props: SVGProps<SVGSVGElement>): import("react/jsx-runtime").JSX.Element;
+export declare function DrawPolygonIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+export declare function DrawSquareIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+export declare function DrawCircleIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+export declare function DrawLassoIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+export declare function SelectToolIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+/** Freehand-selection glyph: the lasso trace with a selection cursor. */
+export declare function LassoSelectIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+/**
+ * Union/join glyph: two rings with the overlap filled by a dot grid.
+ * From Figma node 6985:35371.
+ *
+ * The Figma glyph spans 14.25 of the 24 units; the rest of this set spans 20, so
+ * it read visibly smaller in the toolbar. Scaled about its own center
+ * ((4.5+18.75)/2, (5.25+18.75)/2) by 20/14.25 ≈ 1.4 to match them.
+ */
+export declare function UnionIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+/** Spatial-mask glyph (circle with horizontal "globe" stripes) for the lasso
+ * geometry toolbar's mask/draw toggle. From Figma node 5960:14347. */
+export declare function SpatialMaskIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;
+/** "Aa" glyph for the lasso geometry toolbar's rename action. From Figma node
+ * 5960:14347. */
+export declare function TextAaIcon(props: SVGProps<SVGSVGElement>): import('react').JSX.Element;

package/dist/types/components/lasso-tool/lasso-tool-inline.d.ts

@@ -1,3 +1,36 @@
-import { JSX } from 'react';
-import { LassoToolsInlineComponentProps } from './types';
-export declare function LassoToolsInlineUI({ enabled, values, chipProps, labels, modes, modesMapping, modeSelected, BoxProps: { sx, ...BoxProps }, onChipToggle, onDelete, onChangeMode, onAllChipToggle, onAllDelete, }: LassoToolsInlineComponentProps): JSX.Element;
+import { JSX, ReactNode } from 'react';
+import { LassoToolsInlineComponentProps, LassoToolsUIContextValue } from './types.js';
+/**
+ * Inline layout variant of the lasso tools toolbar — a shell that publishes
+ * wiring props on context. **Which blocks it has is the consumer's call** —
+ * list them as children. See `stories/modules/lasso/lasso-tools-inline-toolbar.tsx`
+ * for the full CARTO design.
+ *
+ * @example
+ * ```tsx
+ * <LassoToolsInlineUI {...props}>
+ *   <LassoToolsInlineUI.Modes />
+ *   <LassoToolsInlineUI.InteractionMode>
+ *     <LassoToolsInlineUI.UndoRedo />
+ *   </LassoToolsInlineUI.InteractionMode>
+ *   <LassoToolsInlineUI.Chips />
+ *   <LassoToolsInlineUI.Actions />
+ * </LassoToolsInlineUI>
+ * ```
+ */
+export declare function LassoToolsInlineUI({ enabled, values, chipProps, labels, modes, modesMapping, modeSelected, interactionMode, BoxProps: { sx, ...BoxProps }, onChipToggle, onDelete, onChangeMode, onChangeInteractionMode, onAllChipToggle, onAllDelete, onLayerFilters, canUndo, canRedo, onUndo, onRedo, shortcuts, children, }: LassoToolsInlineComponentProps): JSX.Element;
+export declare namespace LassoToolsInlineUI {
+    var InteractionMode: (props: Parameters<typeof InteractionModeWrapperBase>[0]) => JSX.Element;
+    var Modes: (props: Parameters<typeof ModesWrapperBase>[0]) => JSX.Element;
+    var UndoRedo: (props: Parameters<typeof UndoRedoWrapperBase>[0]) => JSX.Element;
+    var Chips: (props: Parameters<typeof ChipsWrapperBase>[0]) => JSX.Element;
+    var Actions: (props: Parameters<typeof ActionsWrapperBase>[0]) => JSX.Element;
+}
+declare function InteractionModeWrapperBase({ interactionMode, labels, onChangeInteractionMode, children, }: LassoToolsUIContextValue & {
+    children?: ReactNode;
+}): JSX.Element | null;
+declare function ModesWrapperBase({ enabled, modes, modesMapping, modeSelected, labels, onChangeMode, }: LassoToolsUIContextValue): JSX.Element | null;
+declare function UndoRedoWrapperBase({ enabled, canUndo, canRedo, onUndo, onRedo, labels, shortcuts, }: LassoToolsUIContextValue): JSX.Element | null;
+declare function ChipsWrapperBase({ values, chipProps, labels, onChipToggle, onDelete, }: LassoToolsUIContextValue): JSX.Element;
+declare function ActionsWrapperBase({ values, labels, onAllChipToggle, onAllDelete, onLayerFilters, }: LassoToolsUIContextValue): JSX.Element | null;
+export {};