@llmnative/react 0.1.1 → 1.0.0

package/dist/types/src/I18n.d.ts

@@ -0,0 +1,185 @@
+import React from 'react';
+export interface I18nDict {
+    common: {
+        save: string;
+        cancel: string;
+        delete: string;
+        close: string;
+        back: string;
+        search: string;
+        loading: string;
+        noDataFound: string;
+        pageNavigation: string;
+        previous: string;
+        next: string;
+        notFoundMessage: string;
+        goHome: string;
+    };
+    auth: {
+        signIn: string;
+        signOut: string;
+        connect: string;
+        connected: string;
+        authenticated: string;
+        notConfigured: string;
+        notImplemented: string;
+    };
+    form: {
+        headerAdd: string;
+        headerEdit: string;
+        buttonSave: string;
+        buttonDelete: string;
+        buttonBack: string;
+        requiredField: string;
+        requiredFieldGeneric: string;
+        saveSuccess: string;
+        deleteSuccess: string;
+        noticeRequiredFields: string;
+        noChangesToSave?: string;
+        draftRestoreTitle?: string;
+        draftRestoreMessage?: string;
+        draftRestoreAction?: string;
+        draftDiscardAction?: string;
+        draftRestoredTitle?: string;
+        draftRestoredMessage?: string;
+    };
+    grid: {
+        buttonAdd: string;
+        deleteConfirm: string;
+        emptyState: string;
+    };
+    select: {
+        placeholder: string;
+    };
+    modal: {
+        save: string;
+        delete: string;
+        cancel: string;
+        close: string;
+    };
+    upload: {
+        clickOrDrag: string;
+        dropToUpload: string;
+        uploadMore: string;
+        editFileName: string;
+        editorImage: string;
+        loaded: string;
+        removeFile: string;
+        uploadAnother: string;
+        dropToParse: string;
+    };
+    notifications: {
+        title: string;
+        seeAll: string;
+    };
+    code: {
+        copyCode: string;
+        copy: string;
+        copied: string;
+        codeLanguageDefault: string;
+    };
+    table: {
+        noDataFound: string;
+        selectAllRows: string;
+        sortBy: string;
+        sortByCurrent: string;
+        selectRow: string;
+        reorderRow: string;
+    };
+    gallery: {
+        selectItem: string;
+    };
+    crop: {
+        enableCrop: string;
+        variants: string;
+        outputFile: string;
+        active: string;
+        removeVariant: string;
+        fileName: string;
+    };
+    imageEditor: {
+        title: string;
+        save: string;
+        undo: string;
+        redo: string;
+        zoomOut: string;
+        zoomIn: string;
+        crop: string;
+        flipHorizontal: string;
+        flipVertical: string;
+        rotate: string;
+        freeDrawing: string;
+        arrow: string;
+        text: string;
+        rectangle: string;
+        circle: string;
+        triangle: string;
+    };
+    prompt: {
+        noProviders: string;
+        aiNotConfiguredEdit: string;
+        aiNotConfiguredRun: string;
+        aiNotConfiguredShort: string;
+        toggleOnTitle: string;
+        toggleOffTitle: string;
+        closeEditor: string;
+        editSettings: string;
+        attachFiles: string;
+        attachmentsNotSupported: string;
+        run: string;
+        runFailed: string;
+        noMatchingCommands: string;
+        tokenUsage: string;
+        tokenInput: string;
+        tokenOutput: string;
+        tokenContext: string;
+        tokenCost: string;
+        tokenTime: string;
+        tokenUsageEmpty: string;
+        hidePreview: string;
+        showPreview: string;
+        noProvider: string;
+        noResponse: string;
+        promptLabel: string;
+        defaultOption: string;
+    };
+    layout: {
+        maxElements: string;
+        noSpace: string;
+        dragToMove: string;
+        remove: string;
+        dragToResize: string;
+        dragHere: string;
+    };
+}
+type DeepPartial<T> = {
+    [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K];
+};
+export type I18nLocale = DeepPartial<I18nDict>;
+type DotNestedKeyOf<T> = T extends object ? {
+    [K in Extract<keyof T, string>]: T[K] extends object ? `${K}` | `${K}.${DotNestedKeyOf<T[K]>}` : `${K}`;
+}[Extract<keyof T, string>] : never;
+type PathValue<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? PathValue<T[K], Rest> : never : P extends keyof T ? T[P] : never;
+export type I18nTranslations = Partial<Record<string, I18nLocale>>;
+export interface I18nConfig {
+    locale?: string;
+    translations?: I18nTranslations;
+}
+export interface I18nController {
+    dict: I18nDict;
+    locale: string;
+    availableLocales: string[];
+    setLocale: (locale: string) => void;
+    registerTranslations: (locale: string, translations: I18nLocale) => void;
+}
+export declare function defineLocaleMessages<T extends I18nLocale>(locale: T): T;
+export declare function createTranslations<T extends I18nTranslations>(translations: T): T;
+export declare function interpolate(template: string, vars: Record<string, string | number>): string;
+interface I18nProviderProps {
+    children: React.ReactNode;
+    config?: I18nConfig;
+}
+export declare const I18nProvider: ({ children, config }: I18nProviderProps) => React.JSX.Element;
+export declare function useI18n(): I18nController;
+export declare function useI18n<P extends DotNestedKeyOf<I18nDict>>(namespace: P): PathValue<I18nDict, P>;
+export {};

package/dist/types/src/Theme.d.ts

@@ -39,56 +39,124 @@ export interface ColorScale {
     ring?: string;
 }
 export interface MenuTheme {
-    wrapClass?: string;
+    wrapperClassName?: string;
     className?: string;
-    headerClass?: string;
-    itemClass?: string;
-    linkClass?: string;
-    iconClass?: string;
-    textClass?: string;
-    badgeClass?: string;
-    arrowClass?: string;
-    submenuClass?: string;
+    headerClassName?: string;
+    itemClassName?: string;
+    linkClassName?: string;
+    iconClassName?: string;
+    textClassName?: string;
+    badgeClassName?: string;
+    arrowClassName?: string;
+    submenuClassName?: string;
+}
+export interface SideNavTheme {
+    wrapperClassName?: string;
+    shellClassName?: string;
+    overlayClassName?: string;
+    headerClassName?: string;
+    navClassName?: string;
+    footerClassName?: string;
+    groupLabelClassName?: string;
+    groupDividerClassName?: string;
+    itemClassName?: string;
+    itemActiveClassName?: string;
+    itemChildActiveClassName?: string;
+    itemInactiveClassName?: string;
+    itemIconClassName?: string;
+    itemTextClassName?: string;
+    itemBadgeClassName?: string;
+    itemCollapsedBadgeClassName?: string;
+    itemToggleClassName?: string;
+    subItemClassName?: string;
+    subItemActiveClassName?: string;
+    subItemInactiveClassName?: string;
+    collapseButtonClassName?: string;
+}
+export interface ToolbarTheme {
+    wrapperClassName?: string;
+    stickyClassName?: string;
+    restingClassName?: string;
+    scrolledClassName?: string;
+    innerClassName?: string;
+    leadingClassName?: string;
+    centerClassName?: string;
+    trailingClassName?: string;
+}
+export interface ListCardTheme {
+    wrapperClassName?: string;
+    className?: string;
+    activeClassName?: string;
+    inactiveClassName?: string;
+    disabledClassName?: string;
+    dashedClassName?: string;
+    compactClassName?: string;
+    leadingClassName?: string;
+    bodyClassName?: string;
+    headerClassName?: string;
+    titleClassName?: string;
+    descriptionClassName?: string;
+    metaClassName?: string;
+    badgeClassName?: string;
+    trailingClassName?: string;
+    footerClassName?: string;
+    motion?: {
+        press?: MotionReference;
+    };
+}
+export interface ProviderSwitcherTheme {
+    wrapperClassName?: string;
+    className?: string;
+    triggerClassName?: string;
+    disabledClassName?: string;
+    iconWrapperClassName?: string;
+    labelClassName?: string;
+    captionClassName?: string;
+    chevronClassName?: string;
+    itemClassName?: string;
+    itemActiveClassName?: string;
+    itemInactiveClassName?: string;
+    itemMetaClassName?: string;
+    checkClassName?: string;
 }
 export interface CardTheme {
-    wrapClass?: string;
+    wrapperClassName?: string;
     className?: string;
-    headerClass?: string;
-    bodyClass?: string;
-    footerClass?: string;
-    showLoader?: boolean;
-    showArrow?: boolean;
+    headerClassName?: string;
+    bodyClassName?: string;
+    footerClassName?: string;
+    loading?: boolean;
 }
 export interface TableTheme {
-    wrapClass?: string;
+    wrapperClassName?: string;
     className?: string;
-    headerClass?: string;
-    bodyClass?: string;
-    footerClass?: string;
-    scrollClass?: string;
-    selectedClass?: string;
+    headerClassName?: string;
+    bodyClassName?: string;
+    footerClassName?: string;
+    scrollClassName?: string;
+    selectedClassName?: string;
 }
 export interface GalleryTheme {
-    wrapClass?: string;
+    wrapperClassName?: string;
     className?: string;
-    scrollClass?: string;
-    headerClass?: string;
-    bodyClass?: string;
-    footerClass?: string;
-    selectedClass?: string;
-    gutterSize?: 0 | 1 | 2 | 3 | 4 | 5;
+    scrollClassName?: string;
+    headerClassName?: string;
+    bodyClassName?: string;
+    footerClassName?: string;
+    selectedClassName?: string;
+    gap?: 0 | 1 | 2 | 3 | 4 | 5;
     rowCols?: 1 | 2 | 3 | 4 | 6;
 }
 export interface ModalTheme {
     size?: "sm" | "md" | "lg" | "xl" | "fullscreen";
     position?: "center" | "top" | "left" | "right" | "bottom";
-    wrapClass?: string;
+    wrapperClassName?: string;
     className?: string;
-    headerClass?: string;
-    titleClass?: string;
-    subTitleClass?: string;
-    bodyClass?: string;
-    footerClass?: string;
+    headerClassName?: string;
+    titleClassName?: string;
+    subtitleClassName?: string;
+    bodyClassName?: string;
+    footerClassName?: string;
     iconExpand?: string;
     iconCollapse?: string;
     motion?: {
@@ -113,18 +181,13 @@ export interface ThemeConfig {
         Modal?: ModalTheme & {
             mode?: 'form' | 'empty';
         };
-        i18n?: {
-            headerAdd?: string;
-            headerEdit?: string;
-            buttonAdd?: string;
-        };
     };
     Table?: TableTheme;
     Gallery?: GalleryTheme;
     Pagination?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
-        stickyClass?: string;
+        stickyClassName?: string;
         scrollToTop?: boolean;
         scrollBehavior?: ScrollBehavior;
         maxItems?: number;
@@ -135,12 +198,16 @@ export interface ThemeConfig {
         showIndicators?: boolean;
         showControls?: boolean;
         showCaption?: boolean;
-        layoutDark?: boolean;
-        autoPlay?: any;
+        dark?: boolean;
+        autoPlay?: boolean | {
+            interval: number;
+            pause: "hover" | "false" | "true";
+            wrap: boolean;
+        };
     };
     Card?: CardTheme;
     Loader?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
         icon?: string;
         title?: string;
@@ -148,14 +215,14 @@ export interface ThemeConfig {
     };
     ActionButton?: {
         className?: string;
-        badgeClass?: string;
+        badgeClassName?: string;
         motion?: {
             press?: MotionReference;
         };
     };
     LoadingButton?: {
         className?: string;
-        badgeClass?: string;
+        badgeClassName?: string;
         motion?: {
             press?: MotionReference;
         };
@@ -171,16 +238,16 @@ export interface ThemeConfig {
     };
     Modal?: ModalTheme;
     Dropdown?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
-        buttonClass?: string;
-        badgeClass?: string;
-        menuClass?: string;
+        triggerClassName?: string;
+        badgeClassName?: string;
+        menuClassName?: string;
         menuHeaderClass?: string;
         menuItemClass?: string;
         menuDividerClass?: string;
-        headerClass?: string;
-        footerClass?: string;
+        headerClassName?: string;
+        footerClassName?: string;
         Menu?: MenuTheme;
         motion?: {
             open?: MotionReference;
@@ -189,54 +256,49 @@ export interface ThemeConfig {
         };
     };
     Notifications?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         Dropdown?: {
             className?: string;
-            buttonClass?: string;
-            menuClass?: string;
+            triggerClassName?: string;
+            menuClassName?: string;
         };
     };
     Select?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
     };
     Autocomplete?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
     };
     Form?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         buttonSaveClass?: string;
         buttonDeleteClass?: string;
         buttonBackClass?: string;
         Card?: {
-            headerClass?: string;
-            bodyClass?: string;
-            footerClass?: string;
-        };
-        i18n?: {
-            headerAdd?: string;
-            headerEdit?: string;
-            headerNewRecord?: string;
-            buttonSave?: string;
-            buttonDelete?: string;
-            buttonBack?: string;
-            noticeRequiredFields?: string;
+            headerClassName?: string;
+            bodyClassName?: string;
+            footerClassName?: string;
         };
     };
     Menu?: MenuTheme;
+    SideNav?: SideNavTheme;
+    Toolbar?: ToolbarTheme;
+    ListCard?: ListCardTheme;
+    ProviderSwitcher?: ProviderSwitcherTheme;
     Brand?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
-        logoClass?: string;
-        labelClass?: string;
+        logoClassName?: string;
+        labelClassName?: string;
     };
     SignIn?: {
         className?: string;
         avatarClass?: string;
     };
     Image?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
         motion?: {
             enter?: MotionReference;
@@ -244,7 +306,7 @@ export interface ThemeConfig {
         };
     };
     ImageAvatar?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
         motion?: {
             enter?: MotionReference;
@@ -252,27 +314,37 @@ export interface ThemeConfig {
         };
     };
     Percentage?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
     };
     Tab?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
+        menuClassName?: string;
+        itemClassName?: string;
+        contentClassName?: string;
+        triggerClassName?: string;
+        activeTriggerClassName?: string;
+        inactiveTriggerClassName?: string;
         motion?: {
             enter?: MotionReference;
         };
     };
     Code?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
+        className?: string;
+    };
+    CodeEditor?: {
+        wrapperClassName?: string;
         className?: string;
     };
     Prompt?: {
-        wrapClass?: string;
+        wrapperClassName?: string;
         className?: string;
     };
 }
 type DeepRequired<T> = {
-    [K in keyof T]-?: NonNullable<T[K]> extends (...args: any[]) => any ? NonNullable<T[K]> : NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
+    [K in keyof T]-?: NonNullable<T[K]> extends (...args: unknown[]) => unknown ? NonNullable<T[K]> : NonNullable<T[K]> extends object ? DeepRequired<NonNullable<T[K]>> : NonNullable<T[K]>;
 };
 export type Theme = DeepRequired<ThemeConfig> & {};
 export interface ThemePresetConfig {
@@ -295,7 +367,7 @@ export interface ThemeDefinition {
     components: Theme;
 }
 /** IDs of built-in themes. Extend by adding entries to BUILT_IN_THEMES. */
-export declare const BUILT_IN_THEME_IDS: readonly ["default", "flat", "cyber"];
+export declare const BUILT_IN_THEME_IDS: readonly ["default", "flat", "cyber", "vscode-dark-plus", "vscode-light-plus", "tokyo-night", "tokyo-night-light"];
 export type BuiltInThemeId = (typeof BUILT_IN_THEME_IDS)[number];
 export type AppThemeProviderConfig = BuiltInThemeId | ThemeDefinition | {
     defaultMode?: ThemeMode;

package/dist/types/src/auth.d.ts

@@ -1,6 +1,18 @@
 import React from 'react';
 import { type IButton } from './components/ui/Buttons';
 import type { AuthIntent } from './providers/auth/AuthProvider';
+interface IAuthResponse {
+    iat: number;
+    access_token: string;
+    expires_in: number;
+    token_type: string;
+    scope: string;
+    refresh_token: string;
+    account_id: string;
+    uid: string;
+    server?: string;
+    client_id?: string;
+}
 export declare const AUTH_REDIRECT_URI = "/__/authorize";
 export declare function redirectToAuthPage({ authServer, clientID, scopes, refreshParamName, }: {
     authServer: string;
@@ -10,7 +22,7 @@ export declare function redirectToAuthPage({ authServer, clientID, scopes, refre
 }): void;
 declare const Authorize: () => React.JSX.Element;
 export declare const useAccessToken: (clientID: string, renew?: boolean) => boolean;
-export declare const getAuthSession: (clientID: string) => any;
+export declare const getAuthSession: (clientID: string) => IAuthResponse | undefined;
 export declare const clearAccessToken: (clientID: string) => void;
 export declare const getAccessToken: (clientID: string) => Promise<string | null>;
 export type AuthButtonAspect = 'button' | 'avatar';

package/dist/types/src/components/Component.d.ts

@@ -1,23 +1,20 @@
 import React from "react";
-type Primitive = string | number | boolean | undefined;
-interface FieldRenderProps {
-    name: string;
-    defaultValue?: any;
+export interface FieldRenderProps {
+    name?: string;
     label?: string;
-    onChange?: (value: any) => void;
+    onChange?: (value: unknown) => void;
+    [key: string]: unknown;
 }
-interface FieldAdapter<TProps = any> {
-    getDefaults: (name: string) => Record<string, any>;
+type Defaults = Record<string, unknown>;
+export interface FieldAdapter<TProps = Record<string, unknown>> {
+    getDefaults: (name: string) => Defaults;
     render: (props?: FieldRenderProps & TProps) => React.ReactNode;
     __props: TProps;
 }
-export type FieldFactory<TProps = {}> = (props?: TProps) => FieldAdapter;
+export type FieldFactory<TProps = Record<string, unknown>> = (props?: TProps) => FieldAdapter;
 interface ComponentProps {
-    [key: string]: any;
+    [key: string]: unknown;
 }
-type Defaults = {
-    [key: string]: Primitive | Primitive[];
-};
 export type ModelProps = {
     [key: string]: FieldAdapter | React.ReactNode | ModelProps;
 };
@@ -27,8 +24,9 @@ export type FormTree = {
 export declare const Component: {
     layout: import("../types/Layout").ComponentLayoutMap;
     input: import("../types/FormFields").ComponentFormFieldsMap;
-    block: import("../types/Block").ComponentBlockMap;
-    section: import("../types/Section").ComponentSectionMap;
+    schema: import(".").ComponentFormSchemaMap;
+    block: {};
+    section: {};
 };
 export declare abstract class ComponentBlock {
     abstract model: ModelProps;
@@ -36,20 +34,8 @@ export declare abstract class ComponentBlock {
     abstract form(props?: ComponentProps): React.ReactNode;
     protected verifyRequiredMethods(): void;
     static default(this: new () => ComponentBlock, options?: {
-        dataStoragePath?: string;
+        path?: string;
     }): React.FC;
 }
 export declare function buildFormFields(model: ModelProps): [FormTree, Defaults];
-export declare function ComponentBlockSave(blockClass: new () => ComponentBlock, dbStoragePath: string): Promise<void>;
-export declare class ComponentTemplate {
-    private template?;
-    constructor(path: string);
-    loadTemplate(path: string): Promise<void>;
-    render(dataPath: string): Promise<{
-        html: () => React.ReactNode;
-        form: () => React.ReactNode;
-    }>;
-    private renderTemplate;
-    private parseTemplate;
-}
 export default Component;

package/dist/types/src/components/ErrorBoundary.d.ts

@@ -0,0 +1,30 @@
+import React from 'react';
+export interface ErrorBoundaryProps {
+    children: React.ReactNode;
+    /** Custom fallback. Function receives (error, reset). */
+    fallback?: React.ReactNode | ((error: Error, reset: () => void) => React.ReactNode);
+    /** POST endpoint for error reports. If set, a "Send report" button appears. */
+    reportUrl?: string;
+    /** Show full debug panel (stack trace, component tree, browser context). Auto-enabled in DEV builds. */
+    debug?: boolean;
+    /** Render as a full-page error screen (min-h-screen, centered). Use at the app root level. */
+    fullPage?: boolean;
+}
+interface State {
+    error: Error | null;
+    errorInfo: React.ErrorInfo | null;
+    detailsOpen: boolean;
+    debugOpen: boolean;
+    copied: boolean;
+    reportState: 'idle' | 'sending' | 'sent' | 'failed';
+}
+declare class ErrorBoundary extends React.Component<ErrorBoundaryProps, State> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): Partial<State>;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    reset: () => void;
+    copy: () => void;
+    sendReport: () => void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+}
+export default ErrorBoundary;

package/dist/types/src/components/blocks/Brand.d.ts

@@ -5,10 +5,10 @@ type BrandProps = {
     logo?: string;
     width?: number;
     height?: number;
-    wrapClass?: string;
+    wrapperClassName?: string;
     className?: string;
-    logoClass?: string;
-    labelClass?: string;
+    logoClassName?: string;
+    labelClassName?: string;
 };
-declare const Brand: ({ url, label, logo, width, height, wrapClass, className, logoClass, labelClass }: BrandProps) => React.JSX.Element;
+declare const Brand: ({ url, label, logo, width, height, wrapperClassName, className, logoClassName, labelClassName }: BrandProps) => React.JSX.Element;
 export default Brand;