@llmnative/react 1.0.0 → 1.2.0

package/dist/types/src/components/ui/Table.d.ts

@@ -26,7 +26,9 @@ export interface TableProps extends UIProps {
     onRowClick?: (record: RecordProps) => void;
     onReorder?: TableReorderHandler;
     onSelectionChange?: TableSelectionChangeHandler;
+    /** Selection mode: `"single"` or `"multiple"`. */
     selection?: TableSelectionMode;
+    /** Enable sorting, optionally with a default sort config. */
     sortable?: boolean | OrderConfig;
     pagination?: PaginationParams;
     activeKey?: string | null;
@@ -38,6 +40,7 @@ export interface TableProps extends UIProps {
     heightClassName?: string;
     scrollClassName?: string;
     selectedClassName?: string;
+    /** Custom cell renderer. Receives the record, column key, and absolute row index. */
     renderCell?: (record: RecordProps, key: string, absoluteIndex: number) => React.ReactNode;
 }
 declare function Table({ columns, records, footer, onRowClick, onReorder, onSelectionChange, selection, sortable, pagination, activeKey, selectedKeys, groupBy, before, after, wrapperClassName, className, headerClassName, bodyClassName, footerClassName, heightClassName, scrollClassName, selectedClassName, renderCell }: TableProps): React.JSX.Element;

package/dist/types/src/components/ui/fields/CodeEditor.d.ts

@@ -1,6 +1,8 @@
 import React from 'react';
 import { FormFieldProps } from '../../widgets/Form';
+import { type EditorHeight } from '../../../libs/editorHeight';
 import type { FieldValue } from '../../../providers/data/DataProvider';
+import { type EditorCommand } from './ContextMenu';
 export type CodeEditorLanguage = 'liquid' | 'html' | 'json' | 'js' | 'ts' | 'css';
 export interface CodeSyntaxErrorDetails {
     language: CodeEditorLanguage;
@@ -28,7 +30,11 @@ export declare const getCodeValidationResult: (code: string, language: CodeEdito
 export interface CodeEditorProps extends FormFieldProps {
     language?: CodeEditorLanguage;
     placeholder?: string;
-    minHeight?: number;
+    /** A pixel value, or `'fill'` to stretch to the parent container's height (with the
+     * editor's own internal scroll) instead of a fixed size — see `EditorHeight`. The
+     * parent must actually provide a real height (e.g. a flex column with `flex-1 min-h-0`)
+     * for `'fill'` to have any effect. */
+    minHeight?: EditorHeight;
     maxHeight?: number;
     label?: string;
     required?: boolean;
@@ -38,6 +44,8 @@ export interface CodeEditorProps extends FormFieldProps {
     validateSyntax?: boolean;
     validator?: (value: FieldValue) => string | undefined | Promise<string | undefined>;
     extensions?: unknown[];
+    commands?: EditorCommand[];
+    commandsTrigger?: string;
 }
 export declare const CodeEditor: React.FC<CodeEditorProps>;
 export default CodeEditor;

package/dist/types/src/components/ui/fields/ContextMenu.d.ts

@@ -4,16 +4,64 @@ export interface ContextMenuItem {
     label: string;
     value: string;
     icon?: string;
+    /** Secondary muted text under the label — e.g. a variable's description/type. */
+    description?: string;
 }
 export interface EditorContext {
+    value: string;
     textBeforeCaret: string;
     textAfterCaret: string;
+    trigger: string;
+    query: string;
+    triggerRange: {
+        start: number;
+        end: number;
+    };
     insert: (text: string) => void;
     replace: (start: number, end: number, text: string) => void;
 }
+export interface TextCommandContext {
+    value: string;
+    textBeforeCaret: string;
+    textAfterCaret: string;
+    trigger: string;
+    query: string;
+}
+export interface EditorCommand {
+    name: string;
+    description?: string;
+    icon?: string;
+    /** Groups commands under a `ContextMenu.Heading` in menu order — commands sharing the
+     * same `group` string render contiguously under one heading (see CodeEditor.tsx's
+     * `commandMenuItems`/render logic, which does the grouping/heading-insertion). Commands
+     * without a `group` render ungrouped, in their original order. */
+    group?: string;
+    /** Optional auto-closed suffix to consume when replacing the active trigger. Useful when
+     * a command changes syntactic family, for example from `{{ ... }}` to `{% ... %}`. */
+    consumeSuffix?: string;
+    handler?: (context: TextCommandContext) => string | Promise<string>;
+}
+export interface ContextMenuControlledState {
+    open: boolean;
+    anchorPosition: {
+        top: number;
+        left: number;
+    } | null;
+    query: string;
+    editorContext: EditorContext;
+    onClose: () => void;
+}
+export interface ContextMenuHandle {
+    moveNext: () => void;
+    movePrev: () => void;
+    selectActive: () => void;
+    close: () => void;
+}
+export declare const CONTEXT_MENU_SEARCH_THRESHOLD = 10;
 interface ContextMenuProps extends UIProps {
     trigger: string;
     searchable?: boolean;
+    controlled?: ContextMenuControlledState;
     onSelect?: (item: ContextMenuItem, context: EditorContext) => void;
     children: React.ReactNode;
 }
@@ -21,6 +69,8 @@ interface ContextMenuItemProps extends UIProps {
     label: string;
     value: string;
     icon?: string;
+    /** Secondary muted text under the label — e.g. a variable's description/type. */
+    description?: string;
 }
 interface ContextMenuHeadingProps {
     children: React.ReactNode;
@@ -29,10 +79,33 @@ interface ContextMenuHeadingProps {
 interface ContextMenuSeparatorProps {
     className?: string;
 }
-type ContextMenuComponent = React.FC<ContextMenuProps> & {
+type ContextMenuComponent = React.ForwardRefExoticComponent<ContextMenuProps & React.RefAttributes<ContextMenuHandle>> & {
     Item: React.FC<ContextMenuItemProps>;
     Heading: React.FC<ContextMenuHeadingProps>;
     Separator: React.FC<ContextMenuSeparatorProps>;
 };
+type QueryMatch = {
+    query: string;
+    start: number;
+    end: number;
+};
+type CommandTriggerMatchOptions = {
+    queryPattern?: RegExp;
+    requireWhitespacePrefix?: boolean;
+};
+/**
+ * Whether `textAfterCaret` (from `TextCommandContext`/`EditorContext`) already starts with
+ * `closer`, optionally preceded by whitespace — typically because the editor's own
+ * bracket/quote auto-closing inserted it when the user typed the opening one. A command
+ * `handler` that would otherwise insert a closer of its own (e.g. `"{{ x }}"`) should check
+ * this first and omit its own closer when true, to avoid a duplicate
+ * (`"{{ x }}}}"` instead of the intended `"{{ x }}"`).
+ */
+export declare const hasAutoClosedSuffix: (textAfterCaret: string, closer: string) => boolean;
+/** Returns the number of characters occupied by an auto-closed suffix, including whitespace
+ * before it, or zero when the requested suffix is not present. */
+export declare const getAutoClosedSuffixLength: (textAfterCaret: string, closer: string) => number;
+export declare const matchCommandTrigger: (value: string, caret: number, trigger: string, options?: CommandTriggerMatchOptions) => QueryMatch | null;
+export declare const buildTextCommandContext: (context: EditorContext) => TextCommandContext;
 declare const ContextMenu: ContextMenuComponent;
 export { ContextMenu };

package/dist/types/src/components/ui/fields/RichText.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { FormFieldProps } from '../../widgets/Form';
 import type { FieldValue } from '../../../providers/data/DataProvider';
+import { type EditorCommand } from './ContextMenu';
 export type ToolbarCommand = 'bold' | 'italic' | 'underline' | 'strike' | 'headings' | 'heading1' | 'heading2' | 'heading3' | 'bulletList' | 'orderedList' | 'blockquote' | 'code' | 'codeBlock' | 'link' | 'table' | 'imageUpload' | 'documentUpload' | 'sourceCode' | 'undo' | 'redo' | 'clearFormat' | '|';
 export interface StatusBarConfig {
     /** Show the DOM ancestor tag breadcrumb at the cursor (e.g. p › strong). Default: true. */
@@ -81,6 +82,8 @@ export interface RichTextProps extends FormFieldProps {
     documentUpload?: RichTextDocumentUploadConfig;
     labelClassName?: string;
     validator?: (value: FieldValue) => string | undefined;
+    commands?: EditorCommand[];
+    commandsTrigger?: string;
 }
-export declare const RichText: ({ name, onChange, defaultValue, label, required, placeholder, disabled, feedback, toolbar, toolbarCommands, outputFormat, statusBar, minHeight, maxHeight, imageUpload, documentUpload, labelClassName, inheritWrapperClassName, wrapperClassName, className, before, after, validator, }: RichTextProps) => React.JSX.Element;
+export declare const RichText: ({ name, onChange, defaultValue, label, required, placeholder, disabled, feedback, toolbar, toolbarCommands, outputFormat, statusBar, minHeight, maxHeight, imageUpload, documentUpload, labelClassName, inheritWrapperClassName, wrapperClassName, className, before, after, validator, commands, commandsTrigger, }: RichTextProps) => React.JSX.Element;
 export default RichText;

package/dist/types/src/components/ui/fields/Select.d.ts

@@ -36,6 +36,6 @@ export interface ChecklistProps extends BaseProps {
     itemClassName?: string;
 }
 export declare const Select: ({ name, onChange, defaultValue, required, readOnlyAfterSet, disabled, placeholderOption, label, title, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, validator, }: SelectProps) => React.JSX.Element;
-export declare const Autocomplete: ({ name, defaultValue, minItems, maxItems, onChange, required, readOnlyAfterSet, disabled, label, title, placeholder, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, creatable, onCreate, }: AutocompleteProps) => React.JSX.Element;
-export declare const Checklist: ({ name, defaultValue, onChange, required, readOnlyAfterSet, disabled, label, title, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, itemClassName, }: ChecklistProps) => React.JSX.Element;
+export declare const Autocomplete: ({ name, defaultValue, minItems, maxItems, onChange, required, readOnlyAfterSet, disabled, label, title, placeholder, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, validator, creatable, onCreate, }: AutocompleteProps) => React.JSX.Element;
+export declare const Checklist: ({ name, defaultValue, onChange, required, readOnlyAfterSet, disabled, label, title, before, after, feedback, options, optionsSource, order, inheritWrapperClassName, wrapperClassName, className, validator, itemClassName, }: ChecklistProps) => React.JSX.Element;
 export {};

package/dist/types/src/components/ui/fields/Upload.d.ts

@@ -1,5 +1,6 @@
 import React from "react";
 import { FormFieldProps } from "../../widgets/Form";
+import type { StorageProviderAdapter } from "../../../providers/storage/StorageProvider";
 export interface FileProps {
     key: string;
     fileName: string;
@@ -28,11 +29,19 @@ export interface UseFileUploadCoreOptions {
     srcsetWidths?: number[];
     /** Initial file list (e.g. from a form record on load). */
     initialFiles?: FileProps[];
+    /** Named storage provider slot to upload through — omit for the default. */
+    storageKey?: string;
+    /**
+     * Direct adapter instance — takes priority over `storageKey` when set. For callers that
+     * already computed the right adapter themselves (e.g. a per-record bucket resolved from
+     * that record's own fields, not from a registry key) rather than one registered globally.
+     */
+    storageProvider?: StorageProviderAdapter | null;
 }
-export declare const useFileUploadCore: ({ onFilesChange, onFileReady, uploadPath, srcsetWidths, initialFiles, }: UseFileUploadCoreOptions) => {
+export declare const useFileUploadCore: ({ onFilesChange, onFileReady, uploadPath, srcsetWidths, initialFiles, storageKey, storageProvider, }: UseFileUploadCoreOptions) => {
     files: FileProps[];
     setFiles: React.Dispatch<React.SetStateAction<FileProps[]>>;
-    fileInputRef: React.MutableRefObject<HTMLInputElement | null>;
+    fileInputRef: React.RefObject<HTMLInputElement | null>;
     updateFile: (key: string, updates: Partial<FileProps>) => void;
     handleFiles: (selectedFiles: File[]) => void;
     handleUpload: () => void | undefined;
@@ -46,6 +55,10 @@ export interface UploadDocumentProps extends FormFieldProps {
     max?: number;
     /** StorageProvider path — when set, files are auto-uploaded on selection. */
     uploadPath?: string;
+    /** Named storage provider slot to upload through — omit for the default. */
+    storageKey?: string;
+    /** Direct adapter instance — takes priority over `storageKey` when set. */
+    storageProvider?: StorageProviderAdapter | null;
 }
 export interface UploadImageProps extends UploadDocumentProps {
     previewHeight?: number;
@@ -56,5 +69,5 @@ export interface UploadImageProps extends UploadDocumentProps {
     srcsetWidths?: number[];
 }
 export declare const getFileUrl: (file: FileProps, suffix?: string) => string;
-export declare const UploadDocument: ({ name, onChange, label, required, editable, multiple, max, accept, uploadPath, before, after, wrapperClassName, className, }: UploadDocumentProps) => React.JSX.Element;
-export declare const UploadImage: ({ name, onChange, label, feedback, editable, multiple, accept, required, max, previewHeight, previewWidth, uploadPath, srcsetWidths, before, after, wrapperClassName, className, }: UploadImageProps) => React.JSX.Element;
+export declare const UploadDocument: ({ name, onChange, label, required, editable, multiple, max, accept, uploadPath, storageKey, storageProvider, before, after, wrapperClassName, className, }: UploadDocumentProps) => React.JSX.Element;
+export declare const UploadImage: ({ name, onChange, label, feedback, editable, multiple, accept, required, max, previewHeight, previewWidth, uploadPath, srcsetWidths, storageKey, storageProvider, before, after, wrapperClassName, className, }: UploadImageProps) => React.JSX.Element;

package/dist/types/src/components/widgets/Form.d.ts

@@ -118,11 +118,14 @@ interface BaseFormProps {
     log?: boolean;
     /** Show the inline save/delete notice banner. Defaults to `true`. */
     showNotice?: boolean;
-    /** Persist unsaved changes locally and offer restore/discard on re-entry. Defaults to `false`. */
-    persistDraft?: boolean;
+    /**
+     * Stable bucket that isolates this form's local draft. Omit to disable draft persistence.
+     * The Form appends its own path/route identity, so one bucket safely serves many forms.
+     */
+    draftBucket?: string;
     /** When provided, the save/delete notice is rendered sticky at the top of this container
      *  instead of inline in the form footer. Ideal for full-page forms outside a modal. */
-    noticeAnchorRef?: React.RefObject<HTMLElement>;
+    noticeAnchorRef?: React.RefObject<HTMLElement | null>;
     /** Render a Back navigation button in the footer. */
     showBack?: boolean;
     /** CSS classes on the outermost wrapper element. */
@@ -133,6 +136,14 @@ interface BaseFormProps {
     className?: string;
     /** CSS classes on the footer container. */
     footerClassName?: string;
+    /**
+     * CSS classes on the native `<form>` element itself — distinct from `wrapperClassName`
+     * (the outer `Wrapper` div) and `className` ("card" appearance's body). Needed whenever
+     * a layout must cascade real height/flex context through the form (e.g. a full-height
+     * field like `CodeEditor`'s `minHeight="fill"`) instead of reaching in via an arbitrary
+     * `[&>form]:` child selector on `wrapperClassName`.
+     */
+    formClassName?: string;
 }
 interface FormDefaultProps extends BaseFormProps {
     children: React.ReactNode | ((fields: FormTree) => React.ReactNode) | ((args: {

package/dist/types/src/components/widgets/Prompt.d.ts

@@ -1,17 +1,13 @@
 import React from 'react';
 import { PromptVariables } from '../../conf/Prompt';
 import { type AIProviderAdapter, type AIRequestOptions, type AIAttachment } from '../../providers/ai/AIProvider';
+import { RecordProps } from '../../providers/data/DataProvider';
+import { type EditorCommand } from '../ui/fields/ContextMenu';
 import { FormFieldProps } from './Form';
 export declare enum PromptMode {
     EDIT = "edit",
     RUN = "run"
 }
-export type PromptCommand = {
-    name: string;
-    description?: string;
-    icon?: string;
-    handler?: (currentValue: string) => string | Promise<string>;
-};
 export type PromptAction = {
     key: string;
     icon: string;
@@ -33,6 +29,9 @@ export type PromptRunStats = {
 type PromptOptions = AIRequestOptions & {
     value: string;
 };
+type PromptConfig = Partial<PromptOptions> & {
+    enabled?: boolean;
+};
 type OnRunPrompt = (prompt: string, options: AIRequestOptions, data?: PromptVariables) => Promise<string>;
 type PromptDefaultValue = {
     value?: string;
@@ -51,26 +50,47 @@ type RenderAIUnavailable = (props: {
     reason?: string;
     configured: boolean;
 }) => React.ReactNode;
-type PromptSharedProps = FormFieldProps & {
+interface PromptFieldBase {
+    name: string;
+    label?: string;
+    required?: boolean;
+    onChange?: FormFieldProps["onChange"];
+    before?: React.ReactNode;
+    after?: React.ReactNode;
+    wrapperClassName?: string;
+    className?: string;
     minHeight?: number;
     maxHeight?: number;
+}
+interface PromptWithAI extends PromptFieldBase {
     defaultValue?: PromptDefaultValue;
     renderAIUnavailable?: RenderAIUnavailable;
+}
+interface PromptEditorProps extends PromptWithAI {
+    value?: RecordProps & {
+        prompt?: PromptConfig;
+    };
+}
+interface PromptRunProps extends PromptWithAI {
+    value?: RecordProps & {
+        prompt?: PromptConfig;
+    };
     variables?: PromptVariables;
-};
-type PromptEditProps = PromptSharedProps & {
-    mode?: PromptMode.EDIT;
-};
-type PromptRunProps = PromptSharedProps & {
-    mode: PromptMode.RUN;
     onRunPrompt?: OnRunPrompt;
     renderFallback?: RenderPlainFallback;
-    commands?: PromptCommand[];
+    commands?: EditorCommand[];
+    commandsTrigger?: string;
     attachments?: boolean;
     actions?: PromptAction[];
     statusItems?: PromptStatusItem[];
+}
+type PromptEditBranch = PromptEditorProps & {
+    mode?: PromptMode.EDIT;
+};
+type PromptRunBranch = PromptRunProps & {
+    mode: PromptMode.RUN;
 };
-export type PromptProps = PromptEditProps | PromptRunProps;
+export type PromptProps = PromptEditBranch | PromptRunBranch;
 export declare const Prompt: ({ mode, ...props }: PromptProps) => React.JSX.Element;
 export declare const runPrompt: (options: PromptOptions, data?: PromptVariables, onRunPrompt?: OnRunPrompt, provider?: AIProviderAdapter, attachments?: AIAttachment[], messages?: {
     noProvider?: string;

package/dist/types/src/components/widgets/grid-core/GridCore.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
 import { type RecordProps } from "../../../providers/data/DataProvider";
 import { type GridCoreProps } from "./types";
-declare function GridCore<TRecord extends RecordProps>({ records, recordId, sourcePath, columns, actions, form, editDeepLink, header, footer, view, sticky, wrapperClassName, loading, title, before, after, sortable, pagination, selection, onRowClick, reorderable, onReorder, groupBy, onSave, onDelete, onComplete, audit, onLoad, }: GridCoreProps<TRecord>): React.JSX.Element;
+declare function GridCore<TRecord extends RecordProps>({ records, recordId, sourcePath, columns, actions, form, editDeepLink, header, footer, view, views, sticky, wrapperClassName, loading, title, before, after, sortable, pagination, selection, onRowClick, reorderable, onReorder, groupBy, onSave, onDelete, onComplete, audit, onLoad, }: GridCoreProps<TRecord>): React.JSX.Element;
 export default GridCore;

package/dist/types/src/components/widgets/grid-core/GridGalleryView.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
 import { type RecordProps } from "../../../providers/data/DataProvider";
 import { type GridGalleryViewProps } from "./types";
-declare function GridGalleryView<TRecord extends RecordProps>({ records, recordId, sortable, pagination, selection, selectedKeys, onSelectionChange, onRowClick, groupBy, wrapperClassName, before, after, }: GridGalleryViewProps<TRecord>): React.JSX.Element;
+declare function GridGalleryView<TRecord extends RecordProps>({ records, recordId, sortable, pagination, selection, selectedKeys, onSelectionChange, onRowClick, groupBy, wrapperClassName, before, after, columns, overlays, }: GridGalleryViewProps<TRecord>): React.JSX.Element;
 export default GridGalleryView;

package/dist/types/src/components/widgets/grid-core/types.d.ts

@@ -1,11 +1,70 @@
 import React from "react";
 import { type OrderConfig } from "../../../libs/order";
 import { type PaginationParams } from "../../ui/Pagination";
+import { type GalleryOverlay } from "../../ui/Gallery";
 import { type DatabaseOptions, type RecordProps } from "../../../providers/data/DataProvider";
 export type GridLayout = "table" | "gallery";
 export type GridSticky = "top" | "bottom";
 export type GridSelectionMode = false | "single" | "multiple";
 export type GridRecordKey<TRecord> = keyof TRecord | ((record: TRecord) => string);
+/**
+ * Declarative field shown as an overlay on a gallery card — distinct from `GridColumn`
+ * (which drives table columns): a card doesn't need the same fields as a table row,
+ * and has its own visibility picker (`views.gallery.fieldPicker`) separate from the
+ * table's `views.table.columnPicker`.
+ */
+export type GridGalleryField<TRecord> = {
+    /** Record field to read. Accepts dot-notation strings for nested fields. */
+    key: keyof TRecord | string;
+    /** Label shown in the field picker (not on the card itself — the card shows the value only). */
+    label: string;
+    /** Where on the card this field's value is overlaid. Defaults to `"bottomLeft"`. */
+    position?: "topLeft" | "topRight" | "bottomLeft" | "bottomRight" | "middleLeft" | "middleRight";
+    /** Whether this field is shown by default when `fieldPicker` is enabled. Defaults to `true`. */
+    defaultVisible?: boolean;
+    /** Custom render — defaults to the raw field value as text. */
+    render?: (value: unknown, record: TRecord) => React.ReactNode;
+};
+/** Table-specific view options, grouped under `views.table`. */
+export type GridTableViewConfig = {
+    /** Show a built-in "Columns" dropdown letting the user show/hide table columns. Default `false`. */
+    columnPicker?: boolean;
+};
+/** Gallery-specific view options, grouped under `views.gallery`. */
+export type GridGalleryViewConfig<TRecord> = {
+    /** Cards per row — one of `1|2|3|4|6` (the only values the underlying `Gallery` component supports). */
+    columns?: 1 | 2 | 3 | 4 | 6;
+    /**
+     * Declarative fields overlaid on each card (see `GridGalleryField`). Generates the
+     * overlays automatically and, combined with `fieldPicker`, a "Fields" dropdown
+     * analogous to the table's "Columns" picker — but a separate one, since a card
+     * typically shows fewer/different fields than a table row.
+     */
+    fields?: GridGalleryField<TRecord>[];
+    /** Show the built-in "Fields" dropdown for `fields` above. Default `false`. */
+    fieldPicker?: boolean;
+    /**
+     * Escape hatch: fully custom overlay renderers (forwarded to `<Gallery overlays>`),
+     * for anything `fields` can't express (e.g. an action button, not just a label).
+     * ADDITIVE to the overlays generated from `fields` — a caller commonly needs both at
+     * once (e.g. a Delete button plus checkable label fields); positions shared by both
+     * simply stack, with the custom overlay rendered first.
+     */
+    overlays?: GalleryOverlay[];
+};
+/**
+ * Groups every Table/Gallery-view-switching concern under one input, instead of a flat
+ * spray of booleans on `<Grid>` — `toggle` decides whether the switch exists at all,
+ * `table`/`gallery` hold the options specific to each view (column picker vs. field
+ * picker are deliberately two different controls, since a gallery card and a table row
+ * don't need to show the same fields).
+ */
+export type GridViewsConfig<TRecord> = {
+    /** Show the built-in Table/Gallery switch in the header, letting the user change the active view at runtime. Default `false` — `view` behaves as a fixed initial mode when omitted, same as before this existed. */
+    toggle?: boolean;
+    table?: GridTableViewConfig;
+    gallery?: GridGalleryViewConfig<TRecord>;
+};
 export type GridFormat = "text" | "email" | "date" | "datetime" | "badge" | "image" | "boolean" | "json";
 export type GridCellContext<TRecord> = {
     record: TRecord;
@@ -30,6 +89,8 @@ export type GridColumn<TRecord> = {
     className?: string;
     /** Built-in format name or custom render function. */
     render?: GridFormat | ((ctx: GridCellContext<TRecord>) => React.ReactNode);
+    /** Whether this column is shown by default when `views.table.columnPicker` is enabled. Defaults to `true`. */
+    defaultVisible?: boolean;
 };
 export type GridSelectionState<TRecord> = {
     keys: string[];
@@ -150,9 +211,11 @@ export type GridAfterActionArgs<TRecord> = {
 };
 export type GridAfterActionHandler<TRecord> = (args: GridAfterActionArgs<TRecord>) => Promise<boolean>;
 /** Visual / layout props for `<Grid>`. */
-export type GridPresentation = {
-    /** Display mode: `"table"` (default) or `"gallery"` card layout. */
+export type GridPresentation<TRecord> = {
+    /** Display mode: `"table"` (default) or `"gallery"` card layout. Acts as the initial/default view — see `views.toggle` to let the user switch at runtime. */
     view?: GridLayout;
+    /** Table/Gallery switch + per-view options (column picker, gallery field picker, cards-per-row, …) — see `GridViewsConfig`. Omit entirely to keep the pre-existing fixed-`view` behavior. */
+    views?: GridViewsConfig<TRecord>;
     /** Stick the header (`"top"`) or footer (`"bottom"`) while scrolling. */
     sticky?: GridSticky;
     /** CSS classes on the outermost wrapper element. */
@@ -198,7 +261,7 @@ export type GridPersistence<TRecord> = {
  * Full prop surface shared by all `<Grid>` variants.
  * Combines presentation, behaviour, and persistence with a few top-level hooks.
  */
-export type GridBaseProps<TRecord> = GridPresentation & GridBehavior<TRecord> & GridPersistence<TRecord> & {
+export type GridBaseProps<TRecord> = GridPresentation<TRecord> & GridBehavior<TRecord> & GridPersistence<TRecord> & {
     /** Transform the record array after loading (filter, sort, enrich). */
     onLoad?: (records: TRecord[]) => TRecord[] | Promise<TRecord[]>;
     /** Column definitions. Omit to auto-generate from record keys. */
@@ -222,6 +285,15 @@ export type GridCoreProps<TRecord extends RecordProps> = GridBaseProps<TRecord>
 export type GridArrayProps<TRecord extends RecordProps> = GridBaseProps<TRecord> & {
     records: TRecord[];
     recordId: GridRecordKey<TRecord>;
+    /**
+     * Base path the `records` were sourced from (e.g. `/components`) — enables the built-in
+     * "delete" action's `db.remove(\`${sourcePath}/${recordKey}\`)` when the caller fetched
+     * its own records (e.g. via `db.subscribe()`) instead of letting Grid fetch them itself
+     * (`GridDBProps.path` does the equivalent there). Already threaded through to `GridCore`
+     * — this was just missing from the public prop surface for the `records` variant.
+     * Omit if delete is handled entirely via a custom `actions.delete`/`onDelete`.
+     */
+    sourcePath?: string;
 };
 export type GridDBQuery = Pick<DatabaseOptions, "where" | "order" | "fieldMap">;
 export type GridDBPath = string;
@@ -273,5 +345,9 @@ export type GridGalleryViewProps<TRecord extends RecordProps> = {
     wrapperClassName?: string;
     before?: React.ReactNode;
     after?: React.ReactNode;
+    /** Cards per row — forwarded to `<Gallery columns>`. */
+    columns?: 1 | 2 | 3 | 4 | 6;
+    /** Overlay badges/render-props for each card — forwarded to `<Gallery overlays>`. */
+    overlays?: GalleryOverlay[];
 };
 export {};

package/dist/types/src/components/widgets/grid-core/useGridActions.d.ts

@@ -31,7 +31,7 @@ declare function useGridActions<TRecord extends RecordProps>({ actions, form, ed
     normalizedActions: Record<string, GridAction<TRecord>>;
     activeAction: GridActiveAction<TRecord> | null;
     activeActionConfig: GridAction<TRecord> | undefined;
-    activeActionBody: string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+    activeActionBody: string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
     activeKey: string | null;
     runAction: (actionKey: string, record?: TRecord) => Promise<void>;
     runModalAction: (actionKey: string) => Promise<void>;

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

@@ -2,7 +2,7 @@ import './globals.css';
 export { default as App, AppProvider } from './App';
 export { useMenu } from './App';
 export type { AppProps, AppProviderProps, AppProvidersConfig, MenuConfig } from './App';
-export type { AIConfig } from './Config';
+export type { AIConfig, FirebaseConfig } from './Config';
 export type { ServicesConfig, SupabaseProviderConfig, GoogleProviderConfig, MockProviderConfig, DataDriverName, StorageDriverName, AuthDriverName, EmailDriverName, AIDriverName, } from './providers/manifest';
 export type { ProxyConfig } from './Config';
 export { Head, HeadProvider, DEFAULT_DOCUMENT_HEAD, DEFAULT_HEAD_APP_NAME, DEFAULT_LANGUAGE_HEAD, useAssetsHead, useDocumentHead, useHead, useHeadLinks, useLanguageHead, usePaginationHead, usePwaHead, useSchemaOrgHead, useSocialHead, } from './Head';
@@ -18,10 +18,10 @@ export type { DataProviderAdapter, FieldValue, RecordProps, RecordArray, Databas
 export type { OrderConfig, OrderDirection } from './libs/order';
 export { Order } from './libs/order';
 export { PromptUtils } from './libs/promptUtils';
-export type { PromptCommand, PromptAction, PromptStatusItem, PromptRunStats } from './components/widgets/Prompt';
+export type { PromptAction, PromptStatusItem, PromptRunStats } from './components/widgets/Prompt';
 export type { TableHeaderProp, TableReorderHandler, TableReorderMeta, TableSelectionChangeHandler, TableSelectionState } from './components/ui/Table';
 export type { GalleryRecord, GallerySelectionChangeHandler, GallerySelectionState } from './components/ui/Gallery';
-export type { GridAction, GridActions, GridAfterActionArgs, GridAfterActionHandler, GridArrayProps, GridColumn, GridCoreProps, GridDBPath, GridDBQuery, GridDBProps, GridFooterContext, GridFormContext, GridGalleryViewProps, GridHeaderContext, GridLayout, GridMutationDeleteArgs, GridMutationDeleteHandler, GridMutationSaveArgs, GridMutationSaveHandler, GridReorderHandler, GridReorderMeta, GridRecordKey, GridProps, GridSelectionChangeHandler, GridSelectionMode, GridSelectionState, GridSticky, GridTableViewProps, GridCellContext, } from './components/widgets/Grid';
+export type { GridAction, GridActions, GridAfterActionArgs, GridAfterActionHandler, GridArrayProps, GridColumn, GridCoreProps, GridDBPath, GridDBQuery, GridDBProps, GridFooterContext, GridFormContext, GridGalleryField, GridGalleryViewProps, GridGalleryViewConfig, GridHeaderContext, GridLayout, GridMutationDeleteArgs, GridMutationDeleteHandler, GridMutationSaveArgs, GridMutationSaveHandler, GridReorderHandler, GridReorderMeta, GridRecordKey, GridProps, GridSelectionChangeHandler, GridSelectionMode, GridSelectionState, GridSticky, GridTableViewProps, GridTableViewConfig, GridViewsConfig, GridCellContext, } from './components/widgets/Grid';
 export type { ProviderConfigurable, ProviderConfigurationState } from './providers/ProviderConfiguration';
 export { getProviderConfigurationState } from './providers/ProviderConfiguration';
 export type { ProviderAdapterMap, ProviderService, SetProviderFn, ProviderRegistrySnapshot } from './providers/ProviderRegistryContext';
@@ -41,23 +41,32 @@ export type { MotionEffect, MotionReference, MotionRegistry, MotionStyle, Motion
 export { createMotionTransition, resolveMotionEffect, useEnterMotion, useMotionEffect, useMotionState, usePressMotion } from './motion';
 export { FirebaseDataProvider } from './providers/data/firebase';
 export { FirestoreDataProvider } from './providers/data/firestore';
+export type { FirestoreDataProviderConfig } from './providers/data/firestore';
 export { SupabaseDataProvider } from './providers/data/supabase';
 export { MockDataProvider } from './providers/data/mock';
 export { useDataProvider, DataProvider } from './providers/data/DataProviderContext';
 export type { StorageProviderAdapter, UploadOptions, StorageOptions, DeleteOptions, MoveOptions, ListOptions, StorageFileInfo, UploadHandle } from './providers/storage/StorageProvider';
 export { FirebaseStorageProvider } from './providers/storage/firebase';
+export type { FirebaseStorageProviderConfig } from './providers/storage/firebase';
 export { SupabaseStorageProvider } from './providers/storage/supabase';
 export { useStorageProvider, StorageProvider } from './providers/storage/StorageProviderContext';
 export type { AuthProviderAdapter, AuthIntent, AuthSignInOptions, UserProfile } from './providers/auth/AuthProvider';
 export { useAuthProvider, AuthProvider } from './providers/auth/AuthProviderContext';
 export { GoogleAuthProvider } from './providers/auth/google/GoogleAuthProvider';
+export type { FirebaseAuthProviderOptions, FirebaseSignInOptions } from './providers/auth/firebase/FirebaseAuthProvider';
 export { FirebaseAuthProvider } from './providers/auth/firebase/FirebaseAuthProvider';
+export { callFirebaseFunction } from './providers/firebase-init';
 export { SupabaseAuthProvider } from './providers/auth/supabase/SupabaseAuthProvider';
 export { DropboxAuthProvider } from './providers/auth/dropbox/DropboxAuthProvider';
 export type { CredentialsAdapter } from './providers/credentials/CredentialsProvider';
 export { useCredentialsProvider } from './providers/credentials/CredentialsProviderContext';
 export { GoogleServiceAccountProvider } from './providers/credentials/google/GoogleServiceAccountProvider';
 export type { EmailProviderAdapter, EmailSendParams } from './providers/email/EmailProvider';
+export type { EmailProviderId } from './providers/email/definitions';
+export { EMAIL_PROVIDER_DEFINITIONS } from './providers/email/definitions';
+export type { BuildManifest, BuildArtifacts, DeployOptions, DeployResult, Deployment, PublishProviderAdapter } from './providers/publish/PublishProvider';
+export type { PublishProviderId } from './providers/publish/definitions';
+export { PUBLISH_PROVIDER_DEFINITIONS } from './providers/publish/definitions';
 export type { IconProviderAdapter, IconComponentProps } from './providers/icon/IconProvider';
 export { LucideIconProvider } from './providers/icon/LucideIconProvider';
 export { PhosphorIconProvider } from './providers/icon/PhosphorIconProvider';
@@ -66,8 +75,9 @@ export { IconProvider, useIconProvider, useIconController } from './providers/ic
 export type { AppIconProviderConfig, IconController } from './providers/icon/IconProviderContext';
 export { useEmailProvider, EmailProvider } from './providers/email/EmailProviderContext';
 export { GmailEmailProvider } from './providers/email/google/GmailEmailProvider';
-export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIModelCatalog } from './providers/ai';
-export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef } from './providers/ai';
+export type { AIRequestOptions, AIAttachment, AIProviderAdapter, AIKeyValidationResult, AIModelDescriptor, AIProviderCapabilities, AIModelCatalog, AIProviderDefinition, AICompleteRequest, AICompleteResult, AIConversationTurn, AIToolDefinition, AIToolCall, AIToolResult, } from './providers/ai';
+export { createAIProviderRegistry, getAIModelCatalog, formatAIModelRef, parseAIModelRef, AI_PROVIDER_DEFINITIONS, AI_PROVIDER_DESCRIPTORS, OPENAI_COMPATIBLE_PROVIDER_DESCRIPTOR, toProviderDescriptor } from './providers/ai';
+export type { ProviderDescriptor, ProviderCredentialField } from './providers/ProviderDescriptor';
 export { useAIProvider, useAIProviderRegistry, AIProvider } from './providers/ai/AIProviderContext';
 export { proxyFetch, useProxy, configureProxy, isProxyEnabled } from './providers/proxy';
 export { googleGetAccessToken } from './providers/auth/google/GoogleAuth';

package/dist/types/src/libs/editorHeight.d.ts

@@ -1,9 +1,19 @@
+/**
+ * `'fill'` means "stretch to the height of whatever parent container you're placed in,
+ * instead of a fixed pixel height" — the parent must actually provide a real height (e.g.
+ * a flex column with `flex-1 min-h-0`) for this to have any effect; on an auto-height
+ * parent it resolves to the same as not being there.
+ */
+export type EditorHeight = number | 'fill';
 export interface EditorHeightOptions {
-    minHeight?: number;
+    minHeight?: EditorHeight;
     maxHeight?: number;
     paddingOffset?: number;
 }
 export interface EditorHeightResult {
+    /** True when `minHeight === 'fill'` — the editor stretches to its parent's height with
+     * its own internal scroll, instead of using a fixed pixel min-height. */
+    fill: boolean;
     adjustedMinHeight: number;
     wrapperStyle: React.CSSProperties;
     resolvedMinHeight: number;

package/dist/types/src/libs/fetch.d.ts

@@ -2,6 +2,8 @@ interface FetchOptions {
     method?: "GET" | "POST" | "PUT" | "DELETE" | "HEAD" | "PATCH";
     headers?: Record<string, string>;
     body?: Record<string, unknown> | string;
+    /** Lets a caller cancel an in-flight request (e.g. a "stop" button on a long AI call). */
+    signal?: AbortSignal;
 }
 export declare function fetchRest(url: string, options?: FetchOptions | null, fetchFn?: typeof fetch): Promise<any>;
 export declare function fetchJson(url: string, options?: FetchOptions | null, fetchFn?: typeof fetch): Promise<any>;

package/dist/types/src/providers/ProviderDescriptor.d.ts

@@ -0,0 +1,18 @@
+export type ProviderCredentialField = {
+    key: string;
+    label: string;
+    type: 'text' | 'password' | 'textarea';
+    placeholder?: string;
+};
+export type ProviderDescriptor = {
+    id: string;
+    label: string;
+    description: string;
+    credentialFields: ProviderCredentialField[];
+    /** Where to go find/generate this credential (the provider's own dashboard/API keys page). */
+    credentialsUrl?: string;
+    /** Short guidance on where in that dashboard to look, when the URL alone isn't obvious. */
+    credentialsHint?: string;
+    /** Numbered walkthrough for setups too involved for a one-line hint (e.g. multi-console flows). Rendered instead of credentialsHint when present. */
+    credentialsSteps?: string[];
+};