@lumiastream/ui 0.2.5 → 0.2.7

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { TextFieldProps } from '@mui/material/TextField';
+import { ButtonProps } from '@mui/material/Button';
 import * as React from 'react';
-import { JSX, ReactNode, HTMLAttributes } from 'react';
+import { ReactNode, CSSProperties, JSX, HTMLAttributes, ComponentType } from 'react';
+import { TextFieldProps } from '@mui/material/TextField';
 import { SelectProps } from '@mui/material/Select';
 import { CheckboxProps } from '@mui/material/Checkbox';
 import { FieldValues, Path } from 'react-hook-form';
@@ -10,20 +11,32 @@ import { RadioGroupProps } from '@mui/material/RadioGroup';
 import { AutocompleteRenderOptionState } from '@mui/material/Autocomplete';
 import { CompletionContext } from '@codemirror/autocomplete';
 
-interface LSButtonProps {
-    /** Is this the principal call to action on the page? */
+type LSButtonColor = 'inherit' | 'primary' | 'secondary' | 'error' | 'neutral';
+type LSButtonVariant = 'text' | 'outlined' | 'contained';
+type LSButtonProps = Omit<ButtonProps, 'children' | 'color' | 'variant' | 'size'> & {
+    /** Compatibility alias for color="primary". */
     primary?: boolean;
-    /** What background color to use */
+    /** Compatibility style override for the button background. */
     backgroundColor?: string;
+    /** Loading state. */
+    loading?: boolean;
+    /** Color of the button. */
+    color?: LSButtonColor;
     /** How large should the button be? */
     size?: 'small' | 'medium' | 'large';
-    /** Button contents */
-    label: string;
-    /** Optional click handler */
-    onClick?: () => void;
-}
-/** Primary UI component for user interaction */
-declare const LSButton: ({ primary, size, backgroundColor, label, ...props }: LSButtonProps) => react_jsx_runtime.JSX.Element;
+    /** Element placed before the children. */
+    startIcon?: ReactNode;
+    /** Element placed after the children. */
+    endIcon?: ReactNode;
+    /** The variant to use. */
+    variant?: LSButtonVariant;
+    /** Button contents. */
+    label?: ReactNode;
+    /** Adds wider horizontal padding. */
+    extended?: number;
+    style?: CSSProperties;
+};
+declare const LSButton: ({ label, disabled, loading, variant, extended, color, primary, backgroundColor, className, sx, style, ...props }: LSButtonProps) => react_jsx_runtime.JSX.Element;
 
 interface LSInputPropsChild$1 {
     id?: string;
@@ -199,7 +212,7 @@ type LSVariableInputContextValue = {
     isOriginConnected?: (origin: string) => boolean;
     translationKeyExists?: (key: string, namespace?: string) => boolean;
 };
-declare const LSVariableInputProvider: ({ children, value }: {
+declare const LSVariableInputProvider: ({ children, value, }: {
     children: ReactNode;
     value: LSVariableInputContextValue;
 }) => react_jsx_runtime.JSX.Element;
@@ -232,7 +245,7 @@ type LSVariableInputFieldProps = {
     value?: string | number | any[];
     placeholder?: string;
     renderOption?: (props: HTMLAttributes<HTMLLIElement>, option: any, state: AutocompleteRenderOptionState) => ReactNode;
-    variant?: 'standard' | 'filled' | 'outlined';
+    variant?: "standard" | "filled" | "outlined";
     ListboxComponent?: any;
     onScrollListBox?: (e: any) => void;
     onHighlightChange?: (e: any, value: any) => void;
@@ -472,4 +485,320 @@ declare const resolvePlatformChatterProfileUrl: ({ platform, username, displayna
 declare const normalizeHttpUrl: (value: unknown) => string | null;
 declare const resolveChatterProfileUrlWithResolvers: ({ platform, username, displayname, userId, extraSettings, resolvers, }: ResolveChatterProfileUrlWithResolversInput) => Promise<string | null>;
 
-export { type BuildChatMessageContentOptions, type ChatMessageContentItem, type ChatMessageEmoteStore, type ChatMessageToken, type ChatMessageTokenizationOptions, type ChatboxMediaPreview, type ChatboxMediaPreviewKind, type ChatterProfileResolver, type ChatterProfileResolverPayload, type ChatterProfileUrlInput, type IVariables, LSButton, type LSButtonProps, LSCheckbox, LSCheckboxField, LSColorPicker, type LSColorPickerProps, LSFontPicker, LSInput, type LSInputProps$1 as LSInputProps, LSMultiSelect, LSRadio, LSRadioGroup, LSSelect, LSSliderInput, type LSInputProps as LSSliderInputProps, LSTextField, type LSTextFieldProps, type LSVariableInputContextValue, LSVariableInputField, type LSVariableInputFieldProps, LSVariableInputProvider, MEDIA_PREVIEW_USER_LEVEL_VALUES, type MediaPreviewRoleSettings, type MediaPreviewRoleSettingsInput, type MediaPreviewUserLevel, type MessageLinkPart, type ResolveChatterProfileUrlWithResolversInput, buildChatMessageContent, codeMirrorlinterOptions, getMediaPreviewFromUrl, getNormalizedUserLevels, isMediaPreviewAllowedForUser, normalizeHttpUrl, normalizeMediaPreviewUserLevels, parseMessageLinks, resolveChatterProfileUrlWithResolvers, resolveMediaPreviewRoleSettings, resolveMediaPreviewSetting, resolvePlatformChatterProfileUrl, tokenizeChatMessage, variableCompletionOptions };
+type ModuleType = 'alert' | 'emotebox' | 'emotealert' | 'text' | 'image' | 'audio' | 'video' | 'camera' | 'slideshow' | 'shape' | 'svg' | 'colorbox' | 'goal' | 'timer' | 'gradientlight' | 'browsersource' | 'chatbox' | 'credits' | 'eventlist' | 'eventrotate' | 'hfx' | 'hfxalert' | 'clip' | 'youtube' | 'spinwheel' | 'raffle' | 'viewerqueue' | 'loyaltyleaderboard' | 'viewerprofiles' | 'achievements' | 'poll' | 'tournaments' | 'spotify' | 'nowplaying' | 'youtubemusic' | 'brbscreen' | 'vlc' | 'tts' | 'livecaption' | 'custom' | 'group';
+type OverlayLayerType = 'layer' | 'group';
+type OverlayLayerBounds = {
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+    scale: [number, number];
+    opacity?: number;
+    rotate?: number;
+    zIndex?: number;
+    matrix?: string;
+    clipPath?: string;
+};
+type OverlayLayerState = {
+    id: string;
+    group?: string | null;
+    type?: OverlayLayerType;
+    state: {
+        visible?: boolean;
+        locked?: boolean;
+        expanded?: boolean;
+    };
+    bounds: OverlayLayerBounds;
+};
+type OverlayModuleAlertState = {
+    events?: Record<string, unknown>;
+    [key: string]: unknown;
+};
+type OverlayModuleState = {
+    id?: string;
+    loaded?: boolean;
+    version?: number;
+    settings?: {
+        title?: string | null;
+        type?: ModuleType;
+        locked?: boolean;
+    };
+    lights?: unknown[];
+    css?: Record<string, string | number>;
+    content?: Record<string, unknown>;
+    variables?: Record<string, unknown>;
+    events?: Record<string, unknown>;
+    alert?: OverlayModuleAlertState;
+};
+type OverlaySettings = {
+    layers: OverlayLayerState[];
+    metadata: {
+        width: number;
+        height: number;
+    };
+    modules: Record<string, OverlayModuleState>;
+};
+type OverlayState = {
+    uuid: string;
+    listen_id: string;
+    name: string;
+    description?: string;
+    settings: OverlaySettings;
+    metadata?: {
+        width: number | null;
+        height: number | null;
+    } | null;
+    layers_count?: number | null;
+    hasFullSettings?: boolean;
+};
+
+interface SEBootstrapResponse {
+    overlay: SEOverlay;
+    session?: unknown;
+    tipping?: unknown;
+    channel?: unknown;
+    passport?: unknown;
+}
+interface SEOverlay {
+    _id: string;
+    channel?: string;
+    type?: string;
+    name?: string;
+    settings: {
+        width: number;
+        height: number;
+        name?: string;
+    };
+    widgets: SEWidget[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+interface SEWidget {
+    id: number | string;
+    group?: string | null;
+    version?: number | string | null;
+    type: string;
+    name?: string | null;
+    visible?: boolean;
+    locked?: boolean;
+    listener?: string | null;
+    listeners?: Record<string, boolean> | string[] | null;
+    provider?: string;
+    css: SECss;
+    text?: SEText;
+    image?: SEImage;
+    video?: SEVideo;
+    audio?: SEAudio;
+    variables?: Record<string, unknown>;
+}
+interface SECss {
+    'z-index'?: number;
+    width: string | number;
+    height: string | number;
+    opacity?: number;
+    top?: string | number;
+    left?: string | number;
+}
+interface SEText {
+    type?: string;
+    value?: string | null;
+    enableShadow?: boolean;
+    scrolling?: {
+        direction?: string;
+        speed?: number;
+    };
+    css?: Record<string, unknown>;
+}
+interface SEImage {
+    type?: string;
+    src?: string;
+    css?: Record<string, unknown>;
+}
+interface SEVideo {
+    type?: string;
+    src?: string;
+    volume?: number;
+    css?: Record<string, unknown>;
+}
+interface SEAudio {
+    src?: string;
+    volume?: number;
+}
+interface ImportCoverage {
+    totalWidgets: number;
+    mappings: Array<{
+        seType: string;
+        lumiaType: string;
+        status: 'direct' | 'partial' | 'template' | 'placeholder';
+        count: number;
+    }>;
+    notes: string[];
+}
+interface ReviewItem {
+    moduleId: string;
+    seWidget: SEWidget;
+    status: 'placeholder' | 'template';
+    reason: string;
+    flaggedOff?: boolean;
+}
+
+/** Distinct SE CDN URLs referenced anywhere inside the overlay's settings. */
+declare function findSEAssetURLs(overlay: OverlayState): string[];
+/** Return a new overlay with every `oldUrl → newUrl` replacement applied. */
+declare function rewriteAssetURLs(overlay: OverlayState, mapping: Record<string, string>): OverlayState;
+interface AssetMirrorProgress {
+    url: string;
+    state: 'pending' | 'fetching' | 'uploading' | 'done' | 'failed';
+    newUrl?: string;
+    error?: string;
+}
+/**
+ * Mirror a single SE asset to Lumia storage via the existing `/overlays/assets`
+ * upload endpoint. Returns the new Lumia URL on success.
+ *
+ * The host call site is responsible for retries and progress reporting; this
+ * function is intentionally single-shot. Pass `signal` (AbortSignal) to abort
+ * the source-side `fetch` when the modal closes mid-mirror — the upload itself
+ * is consumer-defined and the caller decides whether/how to short-circuit it.
+ */
+declare function mirrorOneAsset(url: string, upload: (file: File) => Promise<{
+    asset: {
+        url: string;
+    };
+} | {
+    url: string;
+} | unknown>, signal?: AbortSignal): Promise<string>;
+declare function filenameFromURL(url: string): string;
+
+interface TransplantedUnit {
+    layer: OverlayLayerState;
+    module: OverlayModuleState;
+    extras?: Array<{
+        layer: OverlayLayerState;
+        module: OverlayModuleState;
+    }>;
+}
+declare function transplantLayer(source: OverlayState, sourceLayerId: string): TransplantedUnit | null;
+declare function listTransplantableLayers(source: OverlayState): Array<{
+    id: string;
+    label: string;
+    type: string;
+}>;
+
+declare const SE_WIDGET_TO_MARKETPLACE_CANDIDATES: Record<string, number[]>;
+declare function getMarketplaceCandidates(seWidgetType: string): number[];
+declare function hasMarketplaceCandidates(seWidgetType: string): boolean;
+
+declare const SE_IMPORT_FLAGS: {
+    readonly IMPORT_MERCH_PRODUCTS: false;
+    readonly IMPORT_SEASONAL: false;
+};
+declare function isWidgetFlaggedOff(seType: string): boolean;
+declare const FLAG_OFF_REASONS: Record<string, string>;
+
+interface SEExistingAsset {
+    file_name?: string;
+    name?: string;
+    url: string;
+}
+interface SECustomEmbedProps {
+    codeId: string;
+    html: string;
+    css: string;
+    js: string;
+    data: unknown;
+}
+interface SEUploadAssetResult {
+    url: string;
+    file_name?: string;
+    name?: string;
+}
+interface SESaveOverlayBody {
+    name: string;
+    description?: string;
+    settings: OverlayState['settings'];
+}
+interface SEImportBindings {
+    fetchMarketplaceOverlay: (id: number) => Promise<OverlayState>;
+    generateAICustomCode: (prompt: string) => Promise<AIGeneratedCustomOverlay>;
+    uploadAsset: (file: File) => Promise<SEUploadAssetResult>;
+    existingAssets: SEExistingAsset[];
+    saveOverlay: (body: SESaveOverlayBody) => Promise<{
+        uuid: string;
+    }>;
+    onComplete: (result: {
+        overlayId: string;
+    }) => void;
+    onClose: () => void;
+    notify: {
+        success: (msg: string) => void;
+        error: (msg: string) => void;
+        warning: (msg: string) => void;
+    };
+    CustomEmbed?: ComponentType<SECustomEmbedProps>;
+    t?: (key: string) => string | undefined;
+}
+
+interface SEImportWizardProps {
+    bindings: SEImportBindings;
+}
+declare function SEImportWizard({ bindings }: SEImportWizardProps): react_jsx_runtime.JSX.Element;
+
+interface MarketplacePickerProps {
+    seWidgetType: string;
+    fetchMarketplaceOverlay: SEImportBindings['fetchMarketplaceOverlay'];
+    CustomEmbed?: SEImportBindings['CustomEmbed'];
+    onPick: (transplant: {
+        layer: OverlayLayerState;
+        module: OverlayModuleState;
+    }) => void;
+    onCancel: () => void;
+}
+declare function MarketplacePicker({ seWidgetType, fetchMarketplaceOverlay, CustomEmbed, onPick, onCancel }: MarketplacePickerProps): react_jsx_runtime.JSX.Element;
+
+interface ImportResult {
+    overlay: OverlayState;
+    coverage: ImportCoverage;
+    reviewItems: ReviewItem[];
+}
+declare function extractSEOverlayId(input: string): string | null;
+declare function extractSEPreviewParts(input: string): {
+    overlayId: string;
+    apikey: string;
+} | null;
+declare function buildBootstrapUrl(overlayId: string): string;
+declare function fetchSEBootstrap({ overlayId, apikey }: {
+    overlayId: string;
+    apikey: string;
+}): Promise<SEBootstrapResponse>;
+declare function isSEBootstrap(value: unknown): value is SEBootstrapResponse;
+declare function importSEBootstrap(bootstrap: SEBootstrapResponse): ImportResult;
+interface AIGeneratedCustomOverlay {
+    codeId?: string;
+    html?: string;
+    css?: string;
+    js?: string;
+    data?: unknown;
+    configs?: unknown;
+}
+declare function applyReviewAction(result: ImportResult, moduleId: string, action: 'keep' | 'skip' | 'ai' | 'marketplace', payload?: AIGeneratedCustomOverlay | {
+    layer: OverlayLayerState;
+    module: OverlayModuleState;
+    extras?: Array<{
+        layer: OverlayLayerState;
+        module: OverlayModuleState;
+    }>;
+}): ImportResult;
+declare function getAILandingBounds(widget: SEWidget, canvas?: {
+    width: number;
+    height: number;
+}): {
+    width: number;
+    height: number;
+};
+declare function buildAIPromptForSEWidget(widget: SEWidget, canvas?: {
+    width: number;
+    height: number;
+}): string;
+
+export { type AIGeneratedCustomOverlay, type AssetMirrorProgress, type BuildChatMessageContentOptions, type ChatMessageContentItem, type ChatMessageEmoteStore, type ChatMessageToken, type ChatMessageTokenizationOptions, type ChatboxMediaPreview, type ChatboxMediaPreviewKind, type ChatterProfileResolver, type ChatterProfileResolverPayload, type ChatterProfileUrlInput, FLAG_OFF_REASONS, type IVariables, type ImportCoverage, type ImportResult, LSButton, type LSButtonProps, LSCheckbox, LSCheckboxField, LSColorPicker, type LSColorPickerProps, LSFontPicker, LSInput, type LSInputProps$1 as LSInputProps, LSMultiSelect, LSRadio, LSRadioGroup, LSSelect, LSSliderInput, type LSInputProps as LSSliderInputProps, LSTextField, type LSTextFieldProps, type LSVariableInputContextValue, LSVariableInputField, type LSVariableInputFieldProps, LSVariableInputProvider, MEDIA_PREVIEW_USER_LEVEL_VALUES, MarketplacePicker, type MarketplacePickerProps, type MediaPreviewRoleSettings, type MediaPreviewRoleSettingsInput, type MediaPreviewUserLevel, type MessageLinkPart, type ModuleType, type OverlayLayerBounds, type OverlayLayerState, type OverlayLayerType, type OverlayModuleAlertState, type OverlayModuleState, type OverlaySettings, type OverlayState, type ResolveChatterProfileUrlWithResolversInput, type ReviewItem, type SEBootstrapResponse, type SECustomEmbedProps, type SEExistingAsset, type SEImportBindings, SEImportWizard, type SEImportWizardProps, type SESaveOverlayBody, type SEUploadAssetResult, type SEWidget, SE_IMPORT_FLAGS, SE_WIDGET_TO_MARKETPLACE_CANDIDATES, type TransplantedUnit, applyReviewAction, buildAIPromptForSEWidget, buildBootstrapUrl, buildChatMessageContent, codeMirrorlinterOptions, extractSEOverlayId, extractSEPreviewParts, fetchSEBootstrap, filenameFromURL, findSEAssetURLs, getAILandingBounds, getMarketplaceCandidates, getMediaPreviewFromUrl, getNormalizedUserLevels, hasMarketplaceCandidates, importSEBootstrap, isMediaPreviewAllowedForUser, isSEBootstrap, isWidgetFlaggedOff, listTransplantableLayers, mirrorOneAsset, normalizeHttpUrl, normalizeMediaPreviewUserLevels, parseMessageLinks, resolveChatterProfileUrlWithResolvers, resolveMediaPreviewRoleSettings, resolveMediaPreviewSetting, resolvePlatformChatterProfileUrl, rewriteAssetURLs, tokenizeChatMessage, transplantLayer, variableCompletionOptions };