@lmb-it/kitsconcerto-native 0.1.285 → 0.1.286

package/index.d.ts

@@ -925,7 +925,7 @@ export interface IRadioSlots extends IFormElementBaseSlots {
  * `useComponentDefaults`) — derive from this to keep the runtime set
  * in sync with the type contract automatically.
  */
-export type AllSlotKeys = keyof IFormElementBaseSlots | keyof ITextInputSlots | keyof IDatepickerSlots | keyof ISelectSlots | keyof IChipInputSlots | keyof IMultiSelectSlots | keyof ISwitchSlots | keyof ICheckboxSlots | keyof IRadioSlots;
+export type AllSlotKeys = keyof IFormElementBaseSlots | keyof ITextInputSlots | keyof IDatepickerSlots | keyof ISelectSlots | keyof IChipInputSlots | keyof IMultiSelectSlots | keyof ISwitchSlots | keyof ICheckboxSlots | keyof IRadioSlots | keyof IImageCropperSlots;
 /**
  * Wide superset of every form-element slot — the union of all
  * form-element slot interfaces.
@@ -975,6 +975,81 @@ export interface IButtonElementSlots {
     /** The text label inside the button */
     label?: IElementSlotConfig;
 }
+/**
+ * Element slots for ImageCropper.
+ *
+ * ⛔ THE CROPPER IS DRAWN, NOT COMPOSED, SO IT NEEDS SLOTS NOTHING ELSE HAS.
+ * A shade that dims everything outside the window, a window outline, thirds
+ * guides, eight grips, a zoom readout — none of these is a Button or a Card
+ * with a different colour, and a consumer who cannot reach them cannot make
+ * the cropper look like the rest of their product. Eight new keys below; the
+ * rest are the names this library already uses for the same jobs.
+ *
+ * ⚠️ A SLOT ADDED HERE IS INERT UNTIL IT IS ADDED TO `ELEMENT_SLOT_KEYS` IN
+ * `useComponentDefaults.ts` TOO. That allowlist is what decides whether a slot
+ * is merged at all; a key in this interface and not in that set type-checks
+ * perfectly, themes without complaint, and renders nothing. See the note on
+ * that constant — it has caught this before.
+ */
+export interface IImageCropperSlots {
+    /** The whole component's outer shell — border, radius, background. */
+    root?: IElementSlotConfig;
+    /** Top bar: title on one side, close on the other. */
+    header?: IElementSlotConfig;
+    /** The header's text. */
+    title?: IElementSlotConfig;
+    /** Everything between header and footer — stage plus preview. */
+    content?: IElementSlotConfig;
+    /**
+     * The STAGE: the bounded box the image and the crop window live in.
+     *
+     * ⚠️ ITS SIZE IS THE VIEWPORT THE GEOMETRY IS WRITTEN AGAINST, so a
+     * padding here changes what every pointer coordinate means. That is
+     * intended — it is measured, not assumed — but it is not merely cosmetic.
+     */
+    container?: IElementSlotConfig;
+    /** The action row — cancel, rotate, reset, save. */
+    footer?: IElementSlotConfig;
+    /** Icons inside the toolbar buttons. */
+    icon?: IElementSlotConfig;
+    /** Secondary text: the hint line, the "JPG · 320 KB" readout. */
+    text?: IElementSlotConfig;
+    /**
+     * The crop window's own chrome — its outline and corner radius. The shape
+     * that gets CUT OUT of the shade is `mask`; this is the line drawn on top.
+     */
+    cropWindow?: IElementSlotConfig;
+    /**
+     * The dimmed region OUTSIDE the crop window.
+     *
+     * ⚠️ ITS `backgroundColor` WANTS AN ALPHA TOKEN, not a solid colour —
+     * `black-alpha-60` and friends are literal in both colour modes precisely
+     * so a scrim never inverts. A solid value here hides the image completely.
+     */
+    shade?: IElementSlotConfig;
+    /** The rule-of-thirds guides drawn inside the window. */
+    gridLine?: IElementSlotConfig;
+    /** One of the eight resize grips. */
+    handle?: IElementSlotConfig;
+    /** The pill that reads back the current zoom. */
+    zoomChip?: IElementSlotConfig;
+    /** The box around the live preview of the cropped result. */
+    previewFrame?: IElementSlotConfig;
+    /** The "drop an image here" target shown before a source is chosen. */
+    dropZone?: IElementSlotConfig;
+    /** The filled portion of the processing/compression bar. */
+    progressFill?: IElementSlotConfig;
+    /**
+     * The crop window's cut-out SHAPE — a circle for avatars, a rect for
+     * covers. Shares the Sidebar's `mask` name because it does the same job:
+     * the overlay geometry, not the chrome drawn over it.
+     */
+    mask?: IElementSlotConfig;
+    /** Zoom slider rail. Same name, same job, as the Switch's. */
+    track?: IElementSlotConfig;
+    /** Zoom slider knob. */
+    thumb?: IElementSlotConfig;
+}
 /** Element slots for Card */
 export interface ICardElementSlots {
     /** The card root element (outer container) */
@@ -1380,6 +1455,7 @@ export interface IKitsComponentDefaults {
      */
     Table?: IComponentThemeConfig<ITableElementSlots> & ITableFlatConfig;
     Sidebar?: IComponentThemeConfig<ISidebarElementSlots>;
+    ImageCropper?: IComponentThemeConfig<IImageCropperSlots>;
     Accordion?: IComponentThemeConfig<IAccordionElementSlots>;
     Group?: IComponentThemeConfig<IGroupElementSlots>;
     Header?: IComponentThemeConfig<IHeaderElementSlots>;
@@ -8143,6 +8219,249 @@ export interface IWidgetData<T> {
     };
 }
 
+/**
+ * The vocabulary the cropper's geometry is written in.
+ *
+ * ⛔ THREE COORDINATE SPACES, AND CONFUSING TWO OF THEM IS THE WHOLE BUG CLASS
+ * THIS FILE EXISTS TO NAME. Every rect and point below belongs to exactly one
+ * of them, and a function that crosses between them says so in its name.
+ *
+ *   SOURCE   — the original image's own pixels, before any rotation. The only
+ *              space a crop can finally be expressed in, because it is the only
+ *              one the decoder understands.
+ *   ORIENTED — source after a 90°-step rotation. Same pixels, and for 90/270 the
+ *              width and height have SWAPPED. Still image pixels, not screen.
+ *   VIEWPORT — the on-screen stage, in layout units (CSS px on web, DIP on
+ *              native). This is where the crop window and the pointer live.
+ *
+ * ⚠️ VIEWPORT UNITS ARE NOT DEVICE PIXELS and this module never converts to
+ * them. A retina screen draws the same viewport rect over twice as many device
+ * pixels; that is the renderer's business. Mixing the two is how a crop comes
+ * out half size on one device and right on another.
+ */
+/** Width and height, in whichever space the function taking it names. */
+export interface ICropSize {
+    width: number;
+    height: number;
+}
+/** A point, in whichever space the function taking it names. */
+export interface ICropPoint {
+    x: number;
+    y: number;
+}
+/** An axis-aligned rect: `x`/`y` are its TOP-LEFT corner. */
+export interface ICropRect extends ICropSize, ICropPoint {
+}
+/**
+ * Display rotation in 90° steps, CLOCKWISE.
+ *
+ * ⚠️ CLOCKWISE IS A CHOICE, AND IT IS THE ONE THE "ROTATE" BUTTON MAKES. Both
+ * platform encoders are told the same number, so flipping this convention means
+ * flipping it in three places at once.
+ */
+export type CropRotation = 0 | 90 | 180 | 270;
+/**
+ * Where the oriented image sits on the stage: scaled by `scale`, then its
+ * top-left placed at (`x`, `y`) in VIEWPORT space.
+ *
+ * ⚠️ `x`/`y` ARE THE IMAGE'S TOP-LEFT, NOT ITS CENTRE. A centre-based transform
+ * is equally valid and reads better for pinch gestures — it is not what this
+ * module uses, and the two differ by half a scaled image.
+ */
+export interface ICropTransform {
+    scale: number;
+    x: number;
+    y: number;
+}
+/** The eight resize grips, named for the compass edge they sit on. */
+export type CropHandle = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
+/** `[width, height]` — e.g. `[1, 1]` for a square, `[16, 9]` for a cover. */
+export type CropAspect = readonly [number, number];
+/** Options for {@link resizeRect}. */
+export interface ICropResizeOptions {
+    /** Locked width ÷ height. Omit for a free resize. */
+    ratio?: number;
+    /** Floor on the result, in viewport units. */
+    min?: ICropSize;
+    /** The result may not leave this rect — except where `min` forbids it. */
+    bounds?: ICropRect;
+}
+
+/** What the crop window is cut to. */
+export type CropMaskShape = "circle" | "rectangle";
+/** Encoders both platforms can actually produce. */
+export type CropOutputFormat = "jpeg" | "png" | "webp";
+/**
+ * What the cropper is asked to produce.
+ *
+ * ⚠️ EVERY FIELD IS A CEILING, NOT A TARGET. A 200×200 source asked for at most
+ * 1024×1024 comes back 200×200 — upscaling invents detail and charges bytes for
+ * it. Likewise `maxBytes` is "no larger than", reached by lowering quality and
+ * then, only if that is not enough, by scaling down.
+ */
+export interface ICropOutput {
+    /** Ceiling on the result's width, in image pixels. */
+    maxWidth?: number;
+    /** Ceiling on the result's height, in image pixels. */
+    maxHeight?: number;
+    /**
+     * Ceiling on the encoded file size, in BYTES. Defaults to 500 KB.
+     *
+     * ⚠️ `png` IS LOSSLESS, SO QUALITY CANNOT BUY BYTES BACK. A PNG over the
+     * ceiling can only be made smaller by shrinking its dimensions, and a PNG
+     * of a photograph may not reach a tight ceiling at any sane size. Use
+     * `jpeg` or `webp` when `maxBytes` matters.
+     */
+    maxBytes?: number;
+    /**
+     * Encoder for the result. Defaults to `jpeg`.
+     *
+     * ⛔ THE OUTPUT FORMAT NEVER ECHOES THE INPUT'S. A HEIC chosen on an iPhone
+     * is re-encoded to this format, which is how a photo that no browser would
+     * display becomes one that every browser displays. The input's format is
+     * never carried through.
+     */
+    format?: CropOutputFormat;
+}
+/** What the cropper hands back. */
+export interface ICropResult {
+    /**
+     * The cropped image. A `blob:` object URL on web, a `file://` path on
+     * native.
+     *
+     * ⛔ ON WEB THIS IS AN OBJECT URL THE CALLER NOW OWNS. It holds its blob in
+     * memory until someone calls `URL.revokeObjectURL` on it; dropping the
+     * reference does not free it. Revoke it once uploaded or once a later crop
+     * replaces it.
+     */
+    uri: string;
+    /** The result's real pixel width, after every ceiling was applied. */
+    width: number;
+    /** The result's real pixel height. */
+    height: number;
+    /** The encoded size in bytes — what `maxBytes` was measured against. */
+    size: number;
+    /** The encoder that actually produced it. */
+    format: CropOutputFormat;
+    /** The blob itself, on web, for callers that would rather not re-fetch the URL. */
+    blob?: Blob;
+}
+/** Why a crop could not be produced. */
+export type CropErrorReason = 
+/** The source could not be decoded — most often a HEIC in a browser that has no decoder. */
+"decode-failed"
+/** The encoder could not reach `maxBytes` even at its smallest. */
+ | "too-large"
+/** The platform refused the encode. */
+ | "encode-failed";
+export interface ICropError {
+    reason: CropErrorReason;
+    /** A sentence fit to show a user. */
+    message: string;
+}
+export interface IImageCropperProps {
+    /**
+     * The image to crop: a URL/URI, a `File` picked on web, or — on native — a
+     * bundled asset straight from `require('./photo.png')`.
+     *
+     * ⛔ PREFER THE `require()` FORM ON NATIVE. React Native hands back an
+     * asset id whose dimensions are already known, so the cropper reads them
+     * synchronously from the asset registry. A bundled asset passed as a URI
+     * STRING instead forces an `Image.getSize` round-trip to whatever host that
+     * URI names — in development that is the Metro dev server, which a physical
+     * phone frequently cannot reach, and in a release build it is not fetchable
+     * that way at all. Both failures surface as
+     * `onError({reason: 'decode-failed'})`, which reads like a corrupt image
+     * and is not one.
+     *
+     * ⚠️ THE `require()` FORM IS NATIVE-ONLY and is reported, not ignored, on
+     * web: a bundler there resolves `require` of an image to a URL string or a
+     * module object, never to React Native's numeric asset id.
+     *
+     * ⚠️ A HEIC `File` IS ACCEPTED AND MAY STILL FAIL TO DECODE ON WEB. Safari
+     * decodes HEIC; Chrome and Firefox do not, and no amount of re-encoding
+     * helps because the pixels were never read. That case arrives as
+     * `onError({reason: 'decode-failed'})` with a sentence saying so, rather
+     * than as a blank stage. Native decodes HEIC on both platforms.
+     */
+    source?: string | File | number | null;
+    /** Locked crop ratio as `[width, height]`. Defaults to `[1, 1]`. */
+    aspect?: CropAspect;
+    /** Circle for avatars, rectangle for covers. Defaults to `rectangle`. */
+    maskShape?: CropMaskShape;
+    /** Ceilings on the result. See {@link ICropOutput}. */
+    output?: ICropOutput;
+    /** The crop the user accepted. */
+    onCrop?: (result: ICropResult) => void;
+    /** The user backed out. */
+    onCancel?: () => void;
+    /** Something could not be done, with a reason fit to show. */
+    onError?: (error: ICropError) => void;
+    /**
+     * A finger is on the stage (`true`), or has left it (`false`).
+     *
+     * ⛔ IT EXISTS FOR ONE JOB: TURNING OFF AN ENCLOSING `ScrollView` ON NATIVE.
+     * A cropper lives inside a scrollable form, and iOS gives a vertical drag
+     * to the scroll view before anything in the content can ask for it —
+     * `UIScrollView` delays content touches, decides the gesture is a scroll,
+     * and then never delivers it. Nothing rendered INSIDE that scroll view can
+     * outvote it, so the owner of the scroll view has to stand down:
+     *
+     * ```tsx
+     * const [framing, setFraming] = useState(false);
+     * <ScrollView scrollEnabled={!framing}>
+     *     <ImageCropper onInteractionChange={setFraming} ... />
+     * </ScrollView>
+     * ```
+     *
+     * ⚠️ IT IS NOT NEEDED ON WEB, and is harmless there — the web stage stops
+     * page scrolling itself with a non-passive wheel listener and pointer
+     * capture, neither of which native has an equivalent for.
+     *
+     * ⚠️ AND IT IS A BELT, NOT THE ONLY BRACES. The native cropper already
+     * claims the touch in a way that blocks the scroll view wherever the touch
+     * reaches it at all; this is the deterministic fallback for the case where
+     * it does not.
+     */
+    onInteractionChange?: (active: boolean) => void;
+    /** Shown in the header. Omit for no header. */
+    title?: ReactNode;
+    /** Hide the live preview of the result. */
+    hidePreview?: boolean;
+    /** Hide the rule-of-thirds guides. */
+    hideGrid?: boolean;
+    /**
+     * Let the crop window be resized by its eight grips.
+     *
+     * ⚠️ WEB ONLY, AND ACCEPTED-AND-INERT ON NATIVE, the same contract `popup`
+     * carries on the selects: a shared config stays valid on both surfaces
+     * rather than making a consumer branch on platform. A finger has no hover
+     * and a grip small enough to look right is too small to hit, so native
+     * frames by pinch and pan against a fixed window instead.
+     */
+    resizable?: boolean;
+    /** Zoom ceiling, as a multiple of the scale that just covers the window. Defaults to 8. */
+    maxZoom?: number;
+    /** Labels, for translation. */
+    labels?: {
+        cancel?: string;
+        save?: string;
+        rotate?: string;
+        reset?: string;
+        zoom?: string;
+        preview?: string;
+        dropZone?: string;
+        processing?: string;
+    };
+    /** Stable test id, forwarded to the stage. */
+    testID?: string;
+    /** Per-instance slot overrides, merged over the theme. */
+    slots?: Partial<IImageCropperSlots>;
+    /** Style on the outer shell. */
+    style?: IStyleClasses;
+    className?: string;
+}
+
 export interface ILoaderProps<TColor = string, TStyle = unknown, TLocal = Record<string, unknown>> {
     localProps?: TLocal;
     animating?: boolean;
@@ -8714,6 +9033,78 @@ declare function Avatar(props: IAvatarProps): React__default.JSX.Element;
  */
 declare function AvatarStack(props: IAvatarStackProps): React__default.JSX.Element;
 
+declare function ImageCropper(rawProps: IImageCropperProps): React__default.JSX.Element;
+
+/**
+ * Where a host app plugs in the one thing the NATIVE cropper cannot do itself.
+ *
+ * ⛔ THIS FILE HAS NO `.native` SUFFIX ON PURPOSE, AND THAT IS NOT COSMETIC.
+ * `rollup.web.config.mjs` treats any path containing `.native.` as EXTERNAL —
+ * so a registry living in `encode.native.ts` and re-exported from the shared
+ * `components` barrel would compile, and then emit a bare import of a native
+ * file into the WEB bundle for a consumer's bundler to fail on. Found by
+ * reading that config rather than by shipping it. The registry itself imports
+ * nothing platform-specific, so a neutral name is also the honest one.
+ *
+ * ⚠️ THE WEB CROPPER NEVER CONSULTS THIS. It has a canvas and needs no
+ * injection. A cross-platform app can therefore call `setCropEncoder` once at
+ * start-up unconditionally: on web it is a harmless no-op, on a device it is
+ * what makes Save work.
+ */
+export interface ICropEncoder {
+    /**
+     * Produce one encoded file.
+     *
+     * @param uri        the source image
+     * @param sourceRect the region to keep, in SOURCE pixels, rotation undone
+     * @param sourceSize the source's full pixel size
+     * @param rotation   degrees clockwise to apply when saving
+     * @param size       the output's pixel size, already decided by the search
+     * @param quality    0–1; ignored by lossless formats
+     * @param format     the encoder to use
+     * @returns the written file's uri, its size in bytes, and — when the
+     *          implementation knows them — the dimensions it actually produced
+     *
+     * ⚠️ `width`/`height` ARE REPORTED BECAUSE THE REQUEST IS NOT ALWAYS THE
+     * RESULT. The bare-React-Native encoder asks its resizer for a square
+     * ceiling with `contain` (the only orientation-safe way to drive it), so
+     * the output can land a pixel or two off the requested size. Reporting the
+     * number back beats the caller assuming the one it asked for.
+     */
+    (args: {
+        uri: string;
+        sourceRect: ICropRect;
+        /**
+         * The source's full size.
+         *
+         * ⚠️ THE BUNDLED ENCODER NO LONGER NEEDS THIS, and the field stays
+         * anyway. It was added when that encoder rotated the file BEFORE
+         * cropping it and therefore had to re-express the rect into the rotated
+         * frame. Reordering the chain to crop first removed that mapping — but
+         * the contract is public, any implementation that rotates first still
+         * needs the dimensions, and they are free to carry. A canvas encoder
+         * ignores the field entirely.
+         */
+        sourceSize: ICropSize;
+        rotation: number;
+        size: ICropSize;
+        quality: number;
+        format: CropOutputFormat;
+    }): Promise<{
+        uri: string;
+        bytes: number;
+        width?: number;
+        height?: number;
+    }>;
+}
+/**
+ * Register the native encoder. Call once, at app start, before the cropper is
+ * used. Passing `null` unregisters it, which is what a test wants.
+ */
+declare const setCropEncoder: (next: ICropEncoder | null) => void;
+/** Whether a host app has wired one up. The native UI reads this to disable Save. */
+declare const hasCropEncoder: () => boolean;
+
 /**
  * Stepper — horizontal progress indicator for multi-step flows.
  *
@@ -15269,5 +15660,5 @@ declare const localeFiles: {
     };
 };
 
-export { ALPHA_COLOR_VARS, ALPHA_STEPS, ALPHA_TOKEN_NAMES, AccentEdge, CustomAccordion as Accordion, ActionCard, Alert, AlertDescription, AlertIcon, AlertTitle, KitsAnimatePresence as AnimatePresence, AnyFile, Avatar, AvatarStack, Badge, Banner, BottomTabBar, Box, BreadCrumb, BreadcrumbProvider, Button, Card, Carousel, Center, ChatBubble, Chip, CircularProgress, Collapse, CommandPalette, Container, CustomPopover, DEFAULT_NATIVE_SHADOWS, DataView, DataViewContext, DateSeparator, Delta, DetailList as DetailsList, Divider, Donut, DotGrid, EDateFormat, EKeyFilter, Editable, EmptyState, FIELD_LABEL_MARGIN, FIELD_MARGIN, Flex, Form, FormSelect, GUTTER, Gallery, Gauge, Form as GoForm, Datatable as GoTable, KitsGrid as Grid, KitsGridItem as GridItem, GroupedBars, HELPER_TEXT_MARGIN, HStack, Heading, Icon, IconMap, Image, KitsInputSwitch as InputSwitch, KeyboardNavContext, KitsAutoComplete, KitsBarChart, KitsCascadeSelect, KitsCheckbox as KitsCheckboxes, KitsConfirm, KitsConfirmPopup, KitsContainer, KitsInputCalendar as KitsDatepicker, KitsDialogControlled as KitsDialog, KitsDropdown, FilePicker as KitsFilePicker, KitsInputColorPicker, KitsInputLocation, KitsInputMask, KitsInputNumber, KitsInputPassword, KitsInputText, KitsInputTextarea, KitsLineChart, KitsListBox, KitsMultiSelect, KitsPhoneComponent, KitsRadar, KitsRadio as KitsRadios, RadiusPicker as KitsRadiusPicker, KitsSliders, KitsThemeProvider, KitsToast, KitsTreeSelect, Label, Legend, Link, List, ListItem, Loader, LocaleContext, LocaleContextProvider, MainContext, MainContextProvider, MapTile, MessageComposer, MessageReceipt, MetricCard, KitsMultiSelect as MultiSelect, PermissionsProvider, PersonCard, ProgressBar, RadiusPicker, RankedList, ReducedMotionProvider, Rise, SHADOW_PRESET_KEYS, SPACER, KitsScrollView as ScrollView, SegmentedControl, FormSelect as Select, SelectButton, Skeleton$1 as Skeleton, SkeletonRows, Skeleton as SkeletonText, Sparkline, StackedBars, StatCard, StatGroup, StatePill, StatusCard, Stepper, Striped, Svg, TableContext, Tabs, Text, ThemeContextProvider, Timeline, Tip, Tooltip, Translate, KitsTreeSelect as TreeSelect, TreeView, TriStateCheckbox, TypingIndicator, VStack, Wash, WidgetPanel, borderProperties, breakpoints, capitalizeFirstLetter, checkExtAgainstAccepted, checkNameDuplication, colorWithAlpha, dateTimeFormat, deepMerge, defaultSeverityTheme, defaultTheme, downloadCanvas, dynamicList, expandShadowNative, extendTheme, fileTypeIcon, fileValidation, filesExt, filesMemes, filesTypes, flattenSlotStyles, fontSizeMapping, formFileValidation, formatNumber, getActiveNativeShadows, getCombinedChildIds, getCustomDateTime, getDateElements, getDefaultValues, getMeme, getParams, getPropertyByPath, getType, getTypes, getURLParams, imagesExt, imagesMemes, imagesTypes, isAlphaToken, isNumber, isSemanticToken, isShadowPreset, isThemeToken, isToday, isValidURL, kitsMotion, listingProperties, localeFiles, allProperties as mapCssProperties, mergeRefs, nonPxProperties, propertiesWithoutCssEquivalent, pxProperties, resolveStyleRecord, resolveTokenValue, schemaBuilder, setActiveNativeShadows, shadowNative, shadowWeb, sizeMapping, sizingProperties, timeAgo, timeSince, toMemes, useAllSeverityColors, useBreadcrumb, useBreadcrumbTrail, useComponentDefaults, useCountUp, useDataView, useDialog, useDisclosure, useEnter, useFieldLogic, useFocusStyles, useFormFieldKeyboardNav, useFormManager, useKeyboardNav, useKeyboardNavProvider, useKitsColorScheme, useKitsConcerto, useKitsTheme, useLanguage, useMeasuredWidth, useNativeColorMap, usePermissions, usePopup, useReducedMotion, useResolvedElementStyles, useResolvedStyle, useRtlLineHeight, useScrollState, useSelectionController, useSeverityColors, useTable, useTheme, useThemedFont, useToast };
-export type { AlignmentsValues, AllSlotKeys, AnimationsValues, AvatarShape, AvatarSize, AvatarStatus, BannerAction, BannerStatus, BaseFieldProps, Booleanish, Breakpoint, CallbackProps, ChatBubbleTone, ChatBubbleVariant, ChipSeverity, ChipSize, ColorMode, ColorScale, ColorValue, Colors, ColorsType, ComponentSize, CustomSubmitButtonProps, DataTableFilterMeta, DataTableFilterMetaData, DataTableOperatorFilterMetaData, DataTableSelectionSingleChangeEvent, DataTableSortMeta, DeepPartial, DetailItemInputType, DynamicValue, ElementProps, EnteringAnimation, ExitingAnimation, ExpandedKeys, FetchError, FetchSuccess, FetchTableDataRes, FetchTablePaginationData, FieldWrapperProps, File$1 as File, FileUploaderTemplate, FileUploaderTemplateParams, FlexAlignmentsValues, FlexValues, FormBooleanEvent, FormBooleanTarget, FormEvent, FormTarget, GroupFieldConfigs, HighSizingValue, IAccentEdgeProps, IAccordionElementSlots, IAccordionProps, IActionCardProps, IAddressComponentValue, IAddressExperianFormat, IAddressFormat, IAddressFormatResults, IAddressSearchResults, IAlertComponent, IAlertProps, IAlignment, IAnimation, IAutoCompleteCore, IAutoCompleteElement, IAvatarElementSlots, IAvatarProps, IAvatarStackElementSlots, IAvatarStackProps, IBadgeProps, IBannerProps, IBarChartProps, IBaseValidation, IBasicSectionProps, IBg, IBodyTemplate, IBodyTemplateIcon, IBorder, IBottomTabBarElementSlots, IBottomTabBarProps, IBoxComponent, IBreadcrumbCrumb, IBreadcrumbProps, IBuilderAddressField, IBuilderCheckboxField, IBuilderContainerField, IBuilderDateField, IBuilderField, IBuilderFieldBase, IBuilderFieldExport, IBuilderFileField, IBuilderGroupField, IBuilderMultiselectField, IBuilderNumberField, IBuilderPhoneField, IBuilderRadiosField, IBuilderRadiusPickerField, IBuilderSectionField, IBuilderSelectField, IBuilderSwitchField, IBuilderTagsField, IBuilderTextField, IBuilderTextareaField, IButton, IButtonElementSlots, IButtonParams, IButtonProps, IButtonState, IButtonsFilter, ICanvasProps, ICardComponent, ICardElementSlots, ICarouselElementSlots, ICarouselProps, ICascadeSelect, ICascadeSelectCore, IChatBubbleElementSlots, IChatBubbleProps, ICheckbox, ICheckboxFilter, ICheckboxSlots, IChildren, IChildrenParams, IChipInputSlots, IChipProps, ICircularProgressProps, ICollapseProps, IColorPicker, IColumn, IColumnBase, ICombined, ICommandPaletteGroup, ICommandPaletteItem, ICommandPaletteProps, IComponentThemeConfig, IConditionGroupProps, IConditionRowProps, IConditionRule, IConditionsSectionProps, IConfirmDialogProps, IConfirmPopupProps, IContainer, IContainerCardProps, IContainerProps, IContextValues, ICountrySearchResults, ICssStyling, IDVButtonsFilter, IDVCheckboxFilter, IDVDateFilter, IDVDropdownFilter, IDVFilters, IDVMessages, IDVMultiselectFilter, IDVNumberFilter, IDVPaginationRequest, IDVPaginationResponse, IDVPaginationState, IDVPhoneFilter, IDVRangeFilter, IDVTextFilter, IDVTriStateFilter, IDataTableContextValues, IDataTableProps, IDataViewContextValues, IDataViewProps, IDataViewRefValues, IDatatableRefValues, IDate, IDateFilter, IDateProps, IDateSeparatorElementSlots, IDateSeparatorProps, IDateValidation, IDatepickerSlots, IDeltaProps, IDetailItem, IDetailListProps, IDialogButton, IDialogProps, IDialogRef, IDialogState, IDisplay, IDividerComponent, IDonutProps, IDonutSegment, IDotGridProps, IDoughnutChartProps, IDropdownCore, IDropdownFilter, IDropdownSelect, IEditableProps, IEditors, IEffects, IElementBase, IElementSlotConfig, IElementStyle, IEmail, IEmailSearchResults, IEmptyStateElementSlots, IEmptyStateProps, IFieldCardProps, IFieldCondition, IFieldPreviewProps, IFile, IFileUploader, IFileUploaderElement, IFileUploaderTypes, IFileValidation, IFilesExtTypeKeys, IFilters, IFlexAlignment, IFlexComponent, IFormAddon, IFormBuilderInternalState, IFormBuilderMeta, IFormBuilderPayload, IFormBuilderProps, IFormComponent, IFormElement, IFormElementBaseSlots, IFormElementSlots, IFormGrid, IFormListsElements, IFormSelect, IFormSelectElements, IFormSingleElement, IGalleryElementSlots, IGalleryItem, IGalleryProps, IGaugeProps, IGrid, IGridCellStyle, IGridComponent, IGridItem, IGridItemComponent, IGroup, IGroupCardProps, IGroupElementSlots, IGroupSettings, IGroupedBarsDatum, IGroupedBarsProps, IHeaderElementSlots, IHeadingComponent, IIconProps, IImageComponent, IImagesExtTypeKeys, IInteractivity, IKeyedColumn, IKitsAnimation, IKitsBarChartDatum, IKitsBarChartProps, IKitsCheckboxProps, IKitsComponentDefaults, IKitsContainer, IKitsDialogControlled, IKitsInputCalendar, IKitsInputColorPicker, IKitsInputLocation, IKitsInputMask, IKitsInputNumber, IKitsInputPassword, IKitsInputRating, IKitsInputSwitch, IKitsInputText, IKitsInputTextarea, IKitsLineChartProps, IKitsLineChartSeries, IKitsPhoneInput, IKitsRadioProps, IKitsTheme, IKitsThemeColors, IKitsThemeConfig, IKitsThemeContextValues, IKitsThemeFontSizes, IKitsThemeFontWeights, IKitsThemeFonts, IKitsThemeLineHeights, IKitsThemeRadii, IKitsThemeShadows, IKitsThemeSpacing, IKitsToastRef, ILabelElement, ILabelProps, ILanguage, ILayout, ILegendItem, ILegendProps, ILineChartProps, ILinkComponent, ILinkOverrides, IList, IListBoxCore, IListBoxElement, IListBoxSelect, IListItem, IListing, ILoaderProps, ILoadingIndicatorContext, ILocaleContextProps, ILocaleContextValues, ILocation, ILocationDetailsResponse, ILocationResponse, IMainContextProps, IMainContextValues, IMapTilePoint, IMapTileProps, IMemes, IMenuItem, IMessageComposerElementSlots, IMessageComposerProps, IMessageReceiptElementSlots, IMessageReceiptProps, IMessages, IMetricCardProps, IMinusButton, IModalComponent, IModalFormProps, IMultiSelect, IMultiSelectCore, IMultiSelectSlots, IMultiselect, IMultiselectFilter, INativeShadow, INonCrossPlatformTypes, INumberFilter, INumberInput, INumberProps, INumberValidation, IObjectGroup, IOneOfTypes, IOptionItem, IOptionsEditorProps, IOptionsSource, IPageISection, IPaginationRequest, IPaginationResponse, IPaginatorLabels, IPaletteItemProps, IPaletteProps, IPanelCustomSlot, IPassword, IPasswordProps, IPersonCardProps, IPhone, IPhoneFilter, IPhoneObjectValue, IPhoneValidationResults, IPhoneValue, IPieChartProps, IPlusButton, IPolarAreaChartProps, IPopoverProps, IProgressBarElementSlots, IProgressBarProps, IPropertiesPanelProps, IRTLDetection, IRadarChartProps, IRadarProps, IRadarSeries, IRadioCheckboxListItem, IRadioGroup, IRadioSlots, IRadiusPickerEvents, IRadiusPickerField, IRadiusPickerI18n, IRadiusPickerProps, IRangeFilter, IRankedListProps, IRankedListRow, IRef, IRepeatableSettings, IResponsiveElement, IRiseProps, ISVGComponent, IScrollViewComponent, ISegmentedControlOption, ISegmentedControlProps, ISelect, ISelectBase, ISelectCore, ISelectElement, ISelectSlots, ISelectType, ISelectedFile, ISelectedFileType, ISelectionValidation, ISeverityColorSlots, ISeverityThemeMap, IShadowDefinition, IShadowValue, ISidebarElementSlots, ISizing, ISkeleton, ISkeletonRowsProps, ISkeletonText, ISliderProps, ISpacing, ISparklineProps, IStackProps, IStackedBarsDatum, IStackedBarsProps, IStatCardElementSlots, IStatCardProps, IStatGroupElementSlots, IStatGroupProps, IStatePillProps, IStatisticsProps, IStats, IStatusCardProps, IStepperElementSlots, IStepperProps, IStripedProps, IStyleClasses, ISwitch, ISwitchSlots, ITabBarItem, ITabItem, ITableElementSlots, ITableFlatConfig, ITabsElementSlots, ITabsProps, ITags, IText, ITextComponent, ITextFieldProps, ITextFilter, ITextInput, ITextInputProps, ITextInputSlots, ITextValidation, ITextarea, IThemeContextProps, IThemeContextValues, ITimelineElementSlots, ITimelineItem, ITimelineProps, ITipProps, IToastAction, IToastFunction, IToastOptions, IToastParams, IToolbarProps, ITransforms, ITransition, ITranslatableInputProps, ITranslatableText, ITranslateComponent, ITreeItem, ITreeSelect, ITreeSelectCore, ITreeSelectElement, ITreeSelectNode, ITreeViewProps, ITriStateFilter, ITypingIndicatorElementSlots, ITypingIndicatorProps, IUnkeyedColumn, IUseCountUpOptions, IUseFormReturn, IUserAvatar, IValidationSectionProps, IWashProps, IWidgetBarIncomingProp, IWidgetChartContextProps, IWidgetChartProp, IWidgetData, IWidgetDoughnutIncomingProp, IWidgetLineIncomingProp, IWidgetPanelProps, IWidgetPieIncomingProp, IWidgetPolarAreaIncomingProp, IWidgetRadarIncomingProp, IconName, IconType, InputTextFieldProps, KitsBreakpoint, KitsConditionalObject, KitsDevice, KitsMotion, KitsOrientation, KitsPlatform, KitsResponsiveObject, KitsResponsiveValue, KitsThemeOverride, LabelVariant, LatLng, LoadMode, LoadingIndicatorRenderer, LogicFunction, MapInteraction, MeasurementValues, MessageReceiptState, Nullable, Numbering0_12, Numbering0_32, Numberish, OnCenterChange, OnLocationError, OnLocationFound, OnRadiusChange, OnRadiusValueChange, OnSubmitHandler, OnUnitChange, Orientation, PaginationState, PaginatorPageChangeEvent$1 as PaginatorPageChangeEvent, Permissions, PlatformKey, RadiusPickerDisplay, RadiusPickerLayout, RadiusPickerSize, RadiusUnit, RadiusValue, RenderLocationButtonProps, RenderMapProps, RenderSearchBoxProps, SelectFieldProps, SemanticColorTokens, ServerMethod, ServerResponse, ServerSideProps, SetManyOpts, Severity, Shades, ShadowPreset, Shapes, SidesValues, SizingNumbering, SizingValue, StatePillState, StepperVariant, TAcceptedFileType, TBuilderFieldType, TCheckboxRadioMode, TCheckboxRadioSize, TConditionAction, TConditionMatch, TConditionOperator, TDateBoundary, TDynamicFlag, TExternalFilterLabelMode, TFiltersLayout, TIsoFormat, TItemsPerRow, TKeyFilter, TLocationProvider, TPaginatorAlign, TextLabels, TextProps, ThemedFontKind, TimelineItemStatus, Timeout, TimingNumbering, ToastPosition, ToastSeverity, ToastSize, TooltipDataAttributes, TooltipProps, TreeChangeProps, TreeCheckboxSelectionKeyType, TreeCheckboxSelectionKeys, TreeNode, TreeNodeClickEvent, TreeNodeTemplateOptions, TreeProps, TreeRef, TreeSelectionEvent, Types, UseComponentDefaultsResult, UseDisclosureReturnType, UseFieldLogicElementProps, UseFieldLogicProps, UseFieldLogicReturn, UseFormManagerEvents, UseFormManagerReturn, UseToastApi, ValidationProps, children, clearFunction, downloadableFileResponse, settings1, settings2 };
+export { ALPHA_COLOR_VARS, ALPHA_STEPS, ALPHA_TOKEN_NAMES, AccentEdge, CustomAccordion as Accordion, ActionCard, Alert, AlertDescription, AlertIcon, AlertTitle, KitsAnimatePresence as AnimatePresence, AnyFile, Avatar, AvatarStack, Badge, Banner, BottomTabBar, Box, BreadCrumb, BreadcrumbProvider, Button, Card, Carousel, Center, ChatBubble, Chip, CircularProgress, Collapse, CommandPalette, Container, CustomPopover, DEFAULT_NATIVE_SHADOWS, DataView, DataViewContext, DateSeparator, Delta, DetailList as DetailsList, Divider, Donut, DotGrid, EDateFormat, EKeyFilter, Editable, EmptyState, FIELD_LABEL_MARGIN, FIELD_MARGIN, Flex, Form, FormSelect, GUTTER, Gallery, Gauge, Form as GoForm, Datatable as GoTable, KitsGrid as Grid, KitsGridItem as GridItem, GroupedBars, HELPER_TEXT_MARGIN, HStack, Heading, Icon, IconMap, Image, ImageCropper, KitsInputSwitch as InputSwitch, KeyboardNavContext, KitsAutoComplete, KitsBarChart, KitsCascadeSelect, KitsCheckbox as KitsCheckboxes, KitsConfirm, KitsConfirmPopup, KitsContainer, KitsInputCalendar as KitsDatepicker, KitsDialogControlled as KitsDialog, KitsDropdown, FilePicker as KitsFilePicker, KitsInputColorPicker, KitsInputLocation, KitsInputMask, KitsInputNumber, KitsInputPassword, KitsInputText, KitsInputTextarea, KitsLineChart, KitsListBox, KitsMultiSelect, KitsPhoneComponent, KitsRadar, KitsRadio as KitsRadios, RadiusPicker as KitsRadiusPicker, KitsSliders, KitsThemeProvider, KitsToast, KitsTreeSelect, Label, Legend, Link, List, ListItem, Loader, LocaleContext, LocaleContextProvider, MainContext, MainContextProvider, MapTile, MessageComposer, MessageReceipt, MetricCard, KitsMultiSelect as MultiSelect, PermissionsProvider, PersonCard, ProgressBar, RadiusPicker, RankedList, ReducedMotionProvider, Rise, SHADOW_PRESET_KEYS, SPACER, KitsScrollView as ScrollView, SegmentedControl, FormSelect as Select, SelectButton, Skeleton$1 as Skeleton, SkeletonRows, Skeleton as SkeletonText, Sparkline, StackedBars, StatCard, StatGroup, StatePill, StatusCard, Stepper, Striped, Svg, TableContext, Tabs, Text, ThemeContextProvider, Timeline, Tip, Tooltip, Translate, KitsTreeSelect as TreeSelect, TreeView, TriStateCheckbox, TypingIndicator, VStack, Wash, WidgetPanel, borderProperties, breakpoints, capitalizeFirstLetter, checkExtAgainstAccepted, checkNameDuplication, colorWithAlpha, dateTimeFormat, deepMerge, defaultSeverityTheme, defaultTheme, downloadCanvas, dynamicList, expandShadowNative, extendTheme, fileTypeIcon, fileValidation, filesExt, filesMemes, filesTypes, flattenSlotStyles, fontSizeMapping, formFileValidation, formatNumber, getActiveNativeShadows, getCombinedChildIds, getCustomDateTime, getDateElements, getDefaultValues, getMeme, getParams, getPropertyByPath, getType, getTypes, getURLParams, hasCropEncoder, imagesExt, imagesMemes, imagesTypes, isAlphaToken, isNumber, isSemanticToken, isShadowPreset, isThemeToken, isToday, isValidURL, kitsMotion, listingProperties, localeFiles, allProperties as mapCssProperties, mergeRefs, nonPxProperties, propertiesWithoutCssEquivalent, pxProperties, resolveStyleRecord, resolveTokenValue, schemaBuilder, setActiveNativeShadows, setCropEncoder, shadowNative, shadowWeb, sizeMapping, sizingProperties, timeAgo, timeSince, toMemes, useAllSeverityColors, useBreadcrumb, useBreadcrumbTrail, useComponentDefaults, useCountUp, useDataView, useDialog, useDisclosure, useEnter, useFieldLogic, useFocusStyles, useFormFieldKeyboardNav, useFormManager, useKeyboardNav, useKeyboardNavProvider, useKitsColorScheme, useKitsConcerto, useKitsTheme, useLanguage, useMeasuredWidth, useNativeColorMap, usePermissions, usePopup, useReducedMotion, useResolvedElementStyles, useResolvedStyle, useRtlLineHeight, useScrollState, useSelectionController, useSeverityColors, useTable, useTheme, useThemedFont, useToast };
+export type { AlignmentsValues, AllSlotKeys, AnimationsValues, AvatarShape, AvatarSize, AvatarStatus, BannerAction, BannerStatus, BaseFieldProps, Booleanish, Breakpoint, CallbackProps, ChatBubbleTone, ChatBubbleVariant, ChipSeverity, ChipSize, ColorMode, ColorScale, ColorValue, Colors, ColorsType, ComponentSize, CropAspect, CropErrorReason, CropHandle, CropMaskShape, CropOutputFormat, CropRotation, CustomSubmitButtonProps, DataTableFilterMeta, DataTableFilterMetaData, DataTableOperatorFilterMetaData, DataTableSelectionSingleChangeEvent, DataTableSortMeta, DeepPartial, DetailItemInputType, DynamicValue, ElementProps, EnteringAnimation, ExitingAnimation, ExpandedKeys, FetchError, FetchSuccess, FetchTableDataRes, FetchTablePaginationData, FieldWrapperProps, File$1 as File, FileUploaderTemplate, FileUploaderTemplateParams, FlexAlignmentsValues, FlexValues, FormBooleanEvent, FormBooleanTarget, FormEvent, FormTarget, GroupFieldConfigs, HighSizingValue, IAccentEdgeProps, IAccordionElementSlots, IAccordionProps, IActionCardProps, IAddressComponentValue, IAddressExperianFormat, IAddressFormat, IAddressFormatResults, IAddressSearchResults, IAlertComponent, IAlertProps, IAlignment, IAnimation, IAutoCompleteCore, IAutoCompleteElement, IAvatarElementSlots, IAvatarProps, IAvatarStackElementSlots, IAvatarStackProps, IBadgeProps, IBannerProps, IBarChartProps, IBaseValidation, IBasicSectionProps, IBg, IBodyTemplate, IBodyTemplateIcon, IBorder, IBottomTabBarElementSlots, IBottomTabBarProps, IBoxComponent, IBreadcrumbCrumb, IBreadcrumbProps, IBuilderAddressField, IBuilderCheckboxField, IBuilderContainerField, IBuilderDateField, IBuilderField, IBuilderFieldBase, IBuilderFieldExport, IBuilderFileField, IBuilderGroupField, IBuilderMultiselectField, IBuilderNumberField, IBuilderPhoneField, IBuilderRadiosField, IBuilderRadiusPickerField, IBuilderSectionField, IBuilderSelectField, IBuilderSwitchField, IBuilderTagsField, IBuilderTextField, IBuilderTextareaField, IButton, IButtonElementSlots, IButtonParams, IButtonProps, IButtonState, IButtonsFilter, ICanvasProps, ICardComponent, ICardElementSlots, ICarouselElementSlots, ICarouselProps, ICascadeSelect, ICascadeSelectCore, IChatBubbleElementSlots, IChatBubbleProps, ICheckbox, ICheckboxFilter, ICheckboxSlots, IChildren, IChildrenParams, IChipInputSlots, IChipProps, ICircularProgressProps, ICollapseProps, IColorPicker, IColumn, IColumnBase, ICombined, ICommandPaletteGroup, ICommandPaletteItem, ICommandPaletteProps, IComponentThemeConfig, IConditionGroupProps, IConditionRowProps, IConditionRule, IConditionsSectionProps, IConfirmDialogProps, IConfirmPopupProps, IContainer, IContainerCardProps, IContainerProps, IContextValues, ICountrySearchResults, ICropEncoder, ICropError, ICropOutput, ICropPoint, ICropRect, ICropResizeOptions, ICropResult, ICropSize, ICropTransform, ICssStyling, IDVButtonsFilter, IDVCheckboxFilter, IDVDateFilter, IDVDropdownFilter, IDVFilters, IDVMessages, IDVMultiselectFilter, IDVNumberFilter, IDVPaginationRequest, IDVPaginationResponse, IDVPaginationState, IDVPhoneFilter, IDVRangeFilter, IDVTextFilter, IDVTriStateFilter, IDataTableContextValues, IDataTableProps, IDataViewContextValues, IDataViewProps, IDataViewRefValues, IDatatableRefValues, IDate, IDateFilter, IDateProps, IDateSeparatorElementSlots, IDateSeparatorProps, IDateValidation, IDatepickerSlots, IDeltaProps, IDetailItem, IDetailListProps, IDialogButton, IDialogProps, IDialogRef, IDialogState, IDisplay, IDividerComponent, IDonutProps, IDonutSegment, IDotGridProps, IDoughnutChartProps, IDropdownCore, IDropdownFilter, IDropdownSelect, IEditableProps, IEditors, IEffects, IElementBase, IElementSlotConfig, IElementStyle, IEmail, IEmailSearchResults, IEmptyStateElementSlots, IEmptyStateProps, IFieldCardProps, IFieldCondition, IFieldPreviewProps, IFile, IFileUploader, IFileUploaderElement, IFileUploaderTypes, IFileValidation, IFilesExtTypeKeys, IFilters, IFlexAlignment, IFlexComponent, IFormAddon, IFormBuilderInternalState, IFormBuilderMeta, IFormBuilderPayload, IFormBuilderProps, IFormComponent, IFormElement, IFormElementBaseSlots, IFormElementSlots, IFormGrid, IFormListsElements, IFormSelect, IFormSelectElements, IFormSingleElement, IGalleryElementSlots, IGalleryItem, IGalleryProps, IGaugeProps, IGrid, IGridCellStyle, IGridComponent, IGridItem, IGridItemComponent, IGroup, IGroupCardProps, IGroupElementSlots, IGroupSettings, IGroupedBarsDatum, IGroupedBarsProps, IHeaderElementSlots, IHeadingComponent, IIconProps, IImageComponent, IImageCropperProps, IImageCropperSlots, IImagesExtTypeKeys, IInteractivity, IKeyedColumn, IKitsAnimation, IKitsBarChartDatum, IKitsBarChartProps, IKitsCheckboxProps, IKitsComponentDefaults, IKitsContainer, IKitsDialogControlled, IKitsInputCalendar, IKitsInputColorPicker, IKitsInputLocation, IKitsInputMask, IKitsInputNumber, IKitsInputPassword, IKitsInputRating, IKitsInputSwitch, IKitsInputText, IKitsInputTextarea, IKitsLineChartProps, IKitsLineChartSeries, IKitsPhoneInput, IKitsRadioProps, IKitsTheme, IKitsThemeColors, IKitsThemeConfig, IKitsThemeContextValues, IKitsThemeFontSizes, IKitsThemeFontWeights, IKitsThemeFonts, IKitsThemeLineHeights, IKitsThemeRadii, IKitsThemeShadows, IKitsThemeSpacing, IKitsToastRef, ILabelElement, ILabelProps, ILanguage, ILayout, ILegendItem, ILegendProps, ILineChartProps, ILinkComponent, ILinkOverrides, IList, IListBoxCore, IListBoxElement, IListBoxSelect, IListItem, IListing, ILoaderProps, ILoadingIndicatorContext, ILocaleContextProps, ILocaleContextValues, ILocation, ILocationDetailsResponse, ILocationResponse, IMainContextProps, IMainContextValues, IMapTilePoint, IMapTileProps, IMemes, IMenuItem, IMessageComposerElementSlots, IMessageComposerProps, IMessageReceiptElementSlots, IMessageReceiptProps, IMessages, IMetricCardProps, IMinusButton, IModalComponent, IModalFormProps, IMultiSelect, IMultiSelectCore, IMultiSelectSlots, IMultiselect, IMultiselectFilter, INativeShadow, INonCrossPlatformTypes, INumberFilter, INumberInput, INumberProps, INumberValidation, IObjectGroup, IOneOfTypes, IOptionItem, IOptionsEditorProps, IOptionsSource, IPageISection, IPaginationRequest, IPaginationResponse, IPaginatorLabels, IPaletteItemProps, IPaletteProps, IPanelCustomSlot, IPassword, IPasswordProps, IPersonCardProps, IPhone, IPhoneFilter, IPhoneObjectValue, IPhoneValidationResults, IPhoneValue, IPieChartProps, IPlusButton, IPolarAreaChartProps, IPopoverProps, IProgressBarElementSlots, IProgressBarProps, IPropertiesPanelProps, IRTLDetection, IRadarChartProps, IRadarProps, IRadarSeries, IRadioCheckboxListItem, IRadioGroup, IRadioSlots, IRadiusPickerEvents, IRadiusPickerField, IRadiusPickerI18n, IRadiusPickerProps, IRangeFilter, IRankedListProps, IRankedListRow, IRef, IRepeatableSettings, IResponsiveElement, IRiseProps, ISVGComponent, IScrollViewComponent, ISegmentedControlOption, ISegmentedControlProps, ISelect, ISelectBase, ISelectCore, ISelectElement, ISelectSlots, ISelectType, ISelectedFile, ISelectedFileType, ISelectionValidation, ISeverityColorSlots, ISeverityThemeMap, IShadowDefinition, IShadowValue, ISidebarElementSlots, ISizing, ISkeleton, ISkeletonRowsProps, ISkeletonText, ISliderProps, ISpacing, ISparklineProps, IStackProps, IStackedBarsDatum, IStackedBarsProps, IStatCardElementSlots, IStatCardProps, IStatGroupElementSlots, IStatGroupProps, IStatePillProps, IStatisticsProps, IStats, IStatusCardProps, IStepperElementSlots, IStepperProps, IStripedProps, IStyleClasses, ISwitch, ISwitchSlots, ITabBarItem, ITabItem, ITableElementSlots, ITableFlatConfig, ITabsElementSlots, ITabsProps, ITags, IText, ITextComponent, ITextFieldProps, ITextFilter, ITextInput, ITextInputProps, ITextInputSlots, ITextValidation, ITextarea, IThemeContextProps, IThemeContextValues, ITimelineElementSlots, ITimelineItem, ITimelineProps, ITipProps, IToastAction, IToastFunction, IToastOptions, IToastParams, IToolbarProps, ITransforms, ITransition, ITranslatableInputProps, ITranslatableText, ITranslateComponent, ITreeItem, ITreeSelect, ITreeSelectCore, ITreeSelectElement, ITreeSelectNode, ITreeViewProps, ITriStateFilter, ITypingIndicatorElementSlots, ITypingIndicatorProps, IUnkeyedColumn, IUseCountUpOptions, IUseFormReturn, IUserAvatar, IValidationSectionProps, IWashProps, IWidgetBarIncomingProp, IWidgetChartContextProps, IWidgetChartProp, IWidgetData, IWidgetDoughnutIncomingProp, IWidgetLineIncomingProp, IWidgetPanelProps, IWidgetPieIncomingProp, IWidgetPolarAreaIncomingProp, IWidgetRadarIncomingProp, IconName, IconType, InputTextFieldProps, KitsBreakpoint, KitsConditionalObject, KitsDevice, KitsMotion, KitsOrientation, KitsPlatform, KitsResponsiveObject, KitsResponsiveValue, KitsThemeOverride, LabelVariant, LatLng, LoadMode, LoadingIndicatorRenderer, LogicFunction, MapInteraction, MeasurementValues, MessageReceiptState, Nullable, Numbering0_12, Numbering0_32, Numberish, OnCenterChange, OnLocationError, OnLocationFound, OnRadiusChange, OnRadiusValueChange, OnSubmitHandler, OnUnitChange, Orientation, PaginationState, PaginatorPageChangeEvent$1 as PaginatorPageChangeEvent, Permissions, PlatformKey, RadiusPickerDisplay, RadiusPickerLayout, RadiusPickerSize, RadiusUnit, RadiusValue, RenderLocationButtonProps, RenderMapProps, RenderSearchBoxProps, SelectFieldProps, SemanticColorTokens, ServerMethod, ServerResponse, ServerSideProps, SetManyOpts, Severity, Shades, ShadowPreset, Shapes, SidesValues, SizingNumbering, SizingValue, StatePillState, StepperVariant, TAcceptedFileType, TBuilderFieldType, TCheckboxRadioMode, TCheckboxRadioSize, TConditionAction, TConditionMatch, TConditionOperator, TDateBoundary, TDynamicFlag, TExternalFilterLabelMode, TFiltersLayout, TIsoFormat, TItemsPerRow, TKeyFilter, TLocationProvider, TPaginatorAlign, TextLabels, TextProps, ThemedFontKind, TimelineItemStatus, Timeout, TimingNumbering, ToastPosition, ToastSeverity, ToastSize, TooltipDataAttributes, TooltipProps, TreeChangeProps, TreeCheckboxSelectionKeyType, TreeCheckboxSelectionKeys, TreeNode, TreeNodeClickEvent, TreeNodeTemplateOptions, TreeProps, TreeRef, TreeSelectionEvent, Types, UseComponentDefaultsResult, UseDisclosureReturnType, UseFieldLogicElementProps, UseFieldLogicProps, UseFieldLogicReturn, UseFormManagerEvents, UseFormManagerReturn, UseToastApi, ValidationProps, children, clearFunction, downloadableFileResponse, settings1, settings2 };

package/index.js

@@ -35,6 +35,8 @@ export { SegmentedControl } from './components/SegmentedControl/index.js';
 export { CommandPalette } from './components/overlay/CommandPalette/index.js';
 export { StatePill } from './components/StatePill/index.js';
 export { Avatar, AvatarStack } from './components/Avatar/index.js';
+export { ImageCropper } from './components/ImageCropper/index.js';
+export { hasCropEncoder, setCropEncoder } from './components/ImageCropper/encoderRegistry.js';
 export { Stepper } from './components/Stepper/index.js';
 export { StatCard, StatGroup } from './components/StatCard/index.js';
 export { default as Rise } from './components/Rise/index.js';

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmb-it/kitsconcerto-native",
-  "version": "0.1.285",
+  "version": "0.1.286",
   "description": "KitsConcerto — Native (React Native) UI components",
   "main": "index.cjs",
   "module": "index.js",
@@ -38,15 +38,24 @@
     "yup-password": "^0.4.0"
   },
   "peerDependencies": {
+    "@bam.tech/react-native-image-resizer": "^3.0.11",
+    "@react-native-community/image-editor": "^5.0.0",
     "chart.js": "^4.5.0",
     "jspdf": "^3.0.1",
     "lucide-react": "^0.400.0 || ^1.0.0",
     "react": "^19.0.0",
     "react-native": ">=0.70.0",
+    "react-native-gesture-handler": ">=2.0.0",
     "react-router-dom": "^7.9.4",
     "xlsx": "^0.18.4"
   },
   "peerDependenciesMeta": {
+    "@bam.tech/react-native-image-resizer": {
+      "optional": true
+    },
+    "@react-native-community/image-editor": {
+      "optional": true
+    },
     "chart.js": {
       "optional": true
     },
@@ -59,6 +68,9 @@
     "react-native": {
       "optional": true
     },
+    "react-native-gesture-handler": {
+      "optional": true
+    },
     "react-router-dom": {
       "optional": true
     },

package/packages/types/src/Theme/defaultTheme.cjs

@@ -1202,6 +1202,117 @@ const defaultTheme = {
       }
     },
     // ─── Sidebar ──────────────────────────────────────────
+    // ─── ImageCropper ─────────────────────────────────
+    // ⚠️ NUMBERS, NOT CSS STRINGS, FOR ANYTHING NATIVE ALSO READS — the
+    // same rule `Input.inputGroup` carries: React Native's ViewStyle wants
+    // `borderWidth: 1`, web treats the bare `1` as `1px`, and one shared
+    // declaration then renders the same frame on both.
+    ImageCropper: {
+      root: {
+        style: {
+          backgroundColor: "surface-card",
+          borderRadius: 16,
+          overflow: "hidden"
+        }
+      },
+      header: {
+        style: {
+          paddingLeft: 16,
+          paddingRight: 16,
+          paddingTop: 12,
+          paddingBottom: 12,
+          borderBottomWidth: 1,
+          borderColor: "border"
+        }
+      },
+      title: {
+        style: { fontSize: 16, fontWeight: "600", fontColor: "text-primary" }
+      },
+      content: {
+        style: { padding: 16, gap: 12 }
+      },
+      /* The stage. Dark on purpose: a photo reads against it in either
+         colour mode, and a light stage makes every pale image look like
+         it has no edges. */
+      container: {
+        style: {
+          backgroundColor: "black-alpha-90",
+          borderRadius: 12,
+          overflow: "hidden"
+        }
+      },
+      footer: {
+        style: {
+          paddingLeft: 16,
+          paddingRight: 16,
+          paddingTop: 12,
+          paddingBottom: 12,
+          borderTopWidth: 1,
+          borderColor: "border",
+          gap: 8
+        }
+      },
+      icon: { style: { fontColor: "text-primary" } },
+      text: { style: { fontSize: 12, fontColor: "text-secondary" } },
+      /* ⛔ THE SCRIM IS AN ALPHA TOKEN, NOT A SOLID. `black-alpha-*` is
+         literal in both colour modes — a scrim that inverted in dark mode
+         would light UP the area the user is cropping away. */
+      shade: { style: { backgroundColor: "black-alpha-60" } },
+      cropWindow: { style: { borderWidth: 2, borderColor: "#FFFFFF" } },
+      gridLine: { style: { backgroundColor: "white-alpha-40" } },
+      handle: {
+        style: {
+          backgroundColor: "#FFFFFF",
+          borderRadius: 2,
+          width: 14,
+          height: 14
+        }
+      },
+      zoomChip: {
+        style: {
+          backgroundColor: "black-alpha-60",
+          fontColor: "#FFFFFF",
+          borderRadius: 999,
+          paddingLeft: 10,
+          paddingRight: 10,
+          paddingTop: 2,
+          paddingBottom: 2,
+          fontSize: 12,
+          fontWeight: "600"
+        }
+      },
+      previewFrame: {
+        style: {
+          borderWidth: 1,
+          borderColor: "border",
+          borderRadius: 12,
+          overflow: "hidden",
+          backgroundColor: "bg-subtle"
+        }
+      },
+      dropZone: {
+        style: {
+          borderWidth: 1,
+          borderStyle: "dashed",
+          borderColor: "border-strong",
+          borderRadius: 12,
+          backgroundColor: "bg-subtle",
+          padding: 24
+        }
+      },
+      progressFill: { style: { backgroundColor: "primary", height: 4 } },
+      /* ⛔ THE SHAPE SLOT, AND IT CARRIES THE *RECTANGLE'S* RADIUS. The
+         circle is NOT a 999 pill set here — `maskShape: 'circle'` makes
+         the component use a true 50%, because a pill radius on a window
+         that is wider than it is tall gives a STADIUM, not a circle.
+         That is exactly what shipped for one render of the 16:9 cover
+         story: 999 leaked out of this slot into the rectangle case and
+         drew a lozenge. What belongs here is the corner rounding a
+         RECTANGULAR window should have; the circle overrides it. */
+      mask: { style: { borderRadius: 12 } },
+      track: { style: { backgroundColor: "bg-accent", borderRadius: 999, height: 4 } },
+      thumb: { style: { backgroundColor: "primary", borderRadius: 999 } }
+    },
     Sidebar: {
       root: {
         style: {