@almadar/ui 5.121.2 → 5.121.4

package/dist/components/index.d.cts

@@ -13,7 +13,7 @@ import { C as ContentSegment, b as DomLayoutData, d as DomStateNode, V as Visual
 export { n as cn } from '../cn-D3H9UzCW.cjs';
 import { b as SlotContent } from '../useUISlots-BesZYMks.cjs';
 export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BesZYMks.cjs';
-export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryChangeSummary, HistoryTimelineItem, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, RevertResult, SelectedFile, SharedEntityStore, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.cjs';
+export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryChangeSummary, HistoryTimelineItem, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, RevertResult, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.cjs';
 export { u as useEmitEvent, a as useEventBus, b as useEventListener } from '../useEventBus-Ckr4wqW3.cjs';
 export { E as EventBusContextType } from '../event-bus-types-Bl78kokd.cjs';
 import 'clsx';
@@ -309,7 +309,13 @@ interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputEl
     disabled?: boolean;
     /** Declarative event name for trait dispatch */
     action?: EventKey;
-    /** Input type - supports 'select' and 'textarea' in addition to standard types */
+    /**
+     * Input type — selects the field's data mode. Use 'password' for masked
+     * credentials / secret / passphrase entry (there is no separate password
+     * pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time'
+     * for their respective values; and 'select' / 'textarea' for choice and
+     * multi-line entry in addition to the standard single-line types.
+     */
     inputType?: "text" | "email" | "password" | "number" | "tel" | "url" | "search" | "date" | "datetime-local" | "time" | "checkbox" | "select" | "textarea";
     label?: string;
     helperText?: string;
@@ -1487,6 +1493,8 @@ interface AnimatedCounterProps {
     prefix?: string;
     /** Text to display after the number */
     suffix?: string;
+    /** Display format: "number" (locale grouping), "currency" ($x.xx), "percent" (rounded %). Unset preserves the value's own decimals. */
+    format?: string;
     /** Additional class names */
     className?: string;
 }
@@ -3585,6 +3593,8 @@ interface LoadingStateProps {
     title?: string;
     message?: string;
     className?: string;
+    /** Center over the whole viewport (fix: inset-0 overlay) instead of inline. */
+    fullPage?: boolean;
 }
 declare const LoadingState: React__default.FC<LoadingStateProps>;
 
@@ -4873,7 +4883,12 @@ interface WizardProgressProps {
     compact?: boolean;
     /** Additional CSS classes */
     className?: string;
-    /** Declarative step click event — emits UI:{stepClickEvent} with { stepIndex } */
+    /**
+     * Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }.
+     * Setting it requires declaring that event (with a `{ stepIndex }` payload)
+     * and a transition handling it in the same trait; omit this prop for
+     * non-clickable progress indicators.
+     */
     stepClickEvent?: EventEmit<{
         stepIndex: number;
     }>;
@@ -5209,7 +5224,7 @@ interface RepeatableFormSectionProps {
     title: string;
     /** Items in the section */
     items: RepeatableItem[];
-    /** Render function for each item */
+    /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem: (item: RepeatableItem, index: number) => React__default.ReactNode;
     /** Minimum items required */
     minItems?: number;
@@ -6237,6 +6252,7 @@ interface DataGridProps extends DataDndProps {
      * Per-item render function (schema-level alias for children render prop).
      * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
      * The compiler converts this to the children render prop.
+     * In .lolo, author the per-item renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -6363,6 +6379,7 @@ interface DataListProps extends DataDndProps {
      * Per-item render function (schema-level alias for children render prop).
      * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
      * The compiler converts this to the children render prop.
+     * In .lolo, author the per-item renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -6473,6 +6490,7 @@ interface TableViewProps extends DataDndProps {
     /**
      * Per-row render function (schema alias). In .orb: ["fn","item",{...}].
      * The compiler converts this to the children render prop.
+     * In .lolo, author the per-row renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.
      * @deprecated Use children in React code; exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -6630,6 +6648,7 @@ declare const SwipeableRow: React__default.FC<SwipeableRowProps>;
 
 interface SortableListProps {
     items: readonly EntityRow[];
+    /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem: (item: EntityRow, index: number) => React__default.ReactNode;
     reorderEvent: EventKey;
     reorderPayload?: EventPayload;
@@ -6656,7 +6675,7 @@ interface CarouselItem {
 interface CarouselProps<T = CarouselItem> {
     /** Array of items to display as slides */
     items: T[];
-    /** Render function for each slide */
+    /** Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem?: (item: T, index: number) => React__default.ReactNode;
     /** Children-as-function fallback for renderItem (compiler compatibility) */
     children?: (item: T, index: number) => React__default.ReactNode;
@@ -9533,6 +9552,7 @@ interface ListProps extends DisplayStateProps {
     showDividers?: boolean;
     variant?: "default" | "card";
     emptyMessage?: string;
+    /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem?: (item: ListItem, index: number) => React__default.ReactNode;
     children?: React__default.ReactNode;
     /** Fields to display - accepts string[] or {key, header}[] for unified interface */

package/dist/components/index.d.ts

@@ -13,7 +13,7 @@ import { C as ContentSegment, b as DomLayoutData, d as DomStateNode, V as Visual
 export { n as cn } from '../cn-Dm0VrLRG.js';
 import { b as SlotContent } from '../useUISlots-BesZYMks.js';
 export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BesZYMks.js';
-export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryChangeSummary, HistoryTimelineItem, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, RevertResult, SelectedFile, SharedEntityStore, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
+export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, HistoryChangeSummary, HistoryTimelineItem, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, RevertResult, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseOrbitalHistoryOptions, UseOrbitalHistoryResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
 export { u as useEmitEvent, a as useEventBus, b as useEventListener } from '../useEventBus-CQWyAWpK.js';
 export { E as EventBusContextType } from '../event-bus-types-Bl78kokd.js';
 import 'clsx';
@@ -309,7 +309,13 @@ interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputEl
     disabled?: boolean;
     /** Declarative event name for trait dispatch */
     action?: EventKey;
-    /** Input type - supports 'select' and 'textarea' in addition to standard types */
+    /**
+     * Input type — selects the field's data mode. Use 'password' for masked
+     * credentials / secret / passphrase entry (there is no separate password
+     * pattern); 'email', 'tel', 'url', 'number', 'search', 'date', and 'time'
+     * for their respective values; and 'select' / 'textarea' for choice and
+     * multi-line entry in addition to the standard single-line types.
+     */
     inputType?: "text" | "email" | "password" | "number" | "tel" | "url" | "search" | "date" | "datetime-local" | "time" | "checkbox" | "select" | "textarea";
     label?: string;
     helperText?: string;
@@ -1487,6 +1493,8 @@ interface AnimatedCounterProps {
     prefix?: string;
     /** Text to display after the number */
     suffix?: string;
+    /** Display format: "number" (locale grouping), "currency" ($x.xx), "percent" (rounded %). Unset preserves the value's own decimals. */
+    format?: string;
     /** Additional class names */
     className?: string;
 }
@@ -3585,6 +3593,8 @@ interface LoadingStateProps {
     title?: string;
     message?: string;
     className?: string;
+    /** Center over the whole viewport (fix: inset-0 overlay) instead of inline. */
+    fullPage?: boolean;
 }
 declare const LoadingState: React__default.FC<LoadingStateProps>;
 
@@ -4873,7 +4883,12 @@ interface WizardProgressProps {
     compact?: boolean;
     /** Additional CSS classes */
     className?: string;
-    /** Declarative step click event — emits UI:{stepClickEvent} with { stepIndex } */
+    /**
+     * Declarative step click event — emits UI:{stepClickEvent} with { stepIndex }.
+     * Setting it requires declaring that event (with a `{ stepIndex }` payload)
+     * and a transition handling it in the same trait; omit this prop for
+     * non-clickable progress indicators.
+     */
     stepClickEvent?: EventEmit<{
         stepIndex: number;
     }>;
@@ -5209,7 +5224,7 @@ interface RepeatableFormSectionProps {
     title: string;
     /** Items in the section */
     items: RepeatableItem[];
-    /** Render function for each item */
+    /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem: (item: RepeatableItem, index: number) => React__default.ReactNode;
     /** Minimum items required */
     minItems?: number;
@@ -6237,6 +6252,7 @@ interface DataGridProps extends DataDndProps {
      * Per-item render function (schema-level alias for children render prop).
      * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
      * The compiler converts this to the children render prop.
+     * In .lolo, author the per-item renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -6363,6 +6379,7 @@ interface DataListProps extends DataDndProps {
      * Per-item render function (schema-level alias for children render prop).
      * In .orb schemas: ["fn", "item", { pattern tree with @item.field bindings }]
      * The compiler converts this to the children render prop.
+     * In .lolo, author the per-item renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -6473,6 +6490,7 @@ interface TableViewProps extends DataDndProps {
     /**
      * Per-row render function (schema alias). In .orb: ["fn","item",{...}].
      * The compiler converts this to the children render prop.
+     * In .lolo, author the per-row renderer as renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field.
      * @deprecated Use children in React code; exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
@@ -6630,6 +6648,7 @@ declare const SwipeableRow: React__default.FC<SwipeableRowProps>;
 
 interface SortableListProps {
     items: readonly EntityRow[];
+    /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem: (item: EntityRow, index: number) => React__default.ReactNode;
     reorderEvent: EventKey;
     reorderPayload?: EventPayload;
@@ -6656,7 +6675,7 @@ interface CarouselItem {
 interface CarouselProps<T = CarouselItem> {
     /** Array of items to display as slides */
     items: T[];
-    /** Render function for each slide */
+    /** Render function for each slide. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem?: (item: T, index: number) => React__default.ReactNode;
     /** Children-as-function fallback for renderItem (compiler compatibility) */
     children?: (item: T, index: number) => React__default.ReactNode;
@@ -9533,6 +9552,7 @@ interface ListProps extends DisplayStateProps {
     showDividers?: boolean;
     variant?: "default" | "card";
     emptyMessage?: string;
+    /** Render function for each item. In .lolo: renderItem: (fn item <Component …={@item.field}/>), binding per-item fields via @item.field. */
     renderItem?: (item: ListItem, index: number) => React__default.ReactNode;
     children?: React__default.ReactNode;
     /** Fields to display - accepts string[] or {key, header}[] for unified interface */