@almadar/ui 5.154.0 → 5.156.0

package/dist/components/index.d.cts

@@ -18,7 +18,7 @@ export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as S
 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, useMediaQuery, 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';
-export { a as NavStackApi, u as useNavStack } from '../NavStackContext-BoVV9nWb.cjs';
+export { a as NavStackApi, u as useNavStack } from '../NavStackContext-bw2nlBgT.cjs';
 import 'three';
 import 'clsx';
 import '@tanstack/react-query';
@@ -483,7 +483,8 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     /** When set, renders a small X button on the right of the badge that
      *  invokes this handler — turns the badge into a removable chip.
      *  Used by the TagInput molecule and other "list of removable values"
-     *  surfaces. */
+     *  surfaces.
+     *  @offByDefault */
     onRemove?: () => void;
     /** Accessible label for the remove button. Defaults to "Remove". */
     removeLabel?: string;
@@ -597,7 +598,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     label?: string | number;
     /** Lucide icon component or canonical kebab-case icon name string */
     icon?: IconInput;
-    /** Called when the user clicks the remove (×) button */
+    /** Called when the user clicks the remove (×) button
+     *  @offByDefault */
     onRemove?: () => void;
     /** Disable the remove button (renders without × control) */
     removable?: boolean;
@@ -607,7 +609,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     clickEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
-    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label } */
+    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
@@ -2268,9 +2271,11 @@ interface ControlGridProps {
     directionAssets?: Partial<Record<DPadDirection, Asset>>;
     size?: 'sm' | 'md' | 'lg';
     disabled?: boolean;
+    /** "auto" (default) renders only on coarse-pointer (touch) devices; "always" renders everywhere. */
+    visibility?: 'auto' | 'always';
     className?: string;
 }
-declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, className, }: ControlGridProps): React$1.JSX.Element;
+declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, visibility, className, }: ControlGridProps): React$1.JSX.Element | null;
 declare namespace ControlGrid {
     var displayName: string;
 }
@@ -2351,12 +2356,17 @@ interface GameHudProps {
     elements?: readonly GameHudElement[];
     /** Size variant */
     size?: "sm" | "md" | "lg";
+    /**
+     * Layout variant: "floating" (default) renders a compact pill cluster that hugs
+     * its content width; "bar" preserves the legacy full-width split bar.
+     */
+    variant?: "floating" | "bar";
     /** Additional CSS classes */
     className?: string;
     /** Whether to use a semi-transparent background */
     transparent?: boolean;
 }
-declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, className, transparent, }: GameHudProps): React$1.JSX.Element;
+declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, variant, className, transparent, }: GameHudProps): React$1.JSX.Element;
 declare namespace GameHud {
     var displayName: string;
 }
@@ -2924,13 +2934,15 @@ interface TraitSlotProps {
     feedback?: 'correct' | 'wrong' | null;
     /** Click handler */
     onClick?: () => void;
-    /** Remove handler */
+    /** Remove handler
+     *  @offByDefault */
     onRemove?: () => void;
     /** Emits UI:{clickEvent} with { slotNumber } */
     clickEvent?: EventEmit<{
         slotNumber: number;
     }>;
-    /** Emits UI:{removeEvent} with { slotNumber } */
+    /** Emits UI:{removeEvent} with { slotNumber }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         slotNumber: number;
     }>;
@@ -3450,13 +3462,13 @@ declare const ALL_PRESETS: PhysicsPreset[];
 interface GameShellProps {
     /** Application / game title shown as a floating chip */
     appName?: string;
-    /** Stat chips row — floats along the top edge */
+    /** Stat chips row — floats along the top edge. Legacy chrome surface: new behaviors emit HUD chrome via `render-ui "hud-top"` instead. */
     hud?: React__default.ReactNode;
-    /** Action cluster — floats bottom-right (End Turn, Fire, Reset, …) */
+    /** Action cluster — floats bottom-right (End Turn, Fire, Reset, …). Legacy chrome surface: new behaviors emit action chrome via `render-ui "hud-bottom"` or `"floating"` instead. */
     addons?: React__default.ReactNode;
-    /** Movement controls — floats bottom-left (d-pad / control-grid). */
+    /** Movement controls — floats bottom-left (d-pad / control-grid). Legacy chrome surface: new behaviors emit movement controls via `render-ui "hud-bottom"` instead. */
     controls?: React__default.ReactNode;
-    /** Centered overlay layer (victory/defeat banners, dialogs). */
+    /** Centered overlay layer (victory/defeat banners, dialogs). Legacy chrome surface: new behaviors emit overlays via `render-ui "overlay"` (clear with `render-ui "overlay" null` on every exit) instead. */
     overlay?: React__default.ReactNode;
     /** Extra class name on the root container */
     className?: string;
@@ -3468,7 +3480,7 @@ interface GameShellProps {
     backgroundAsset?: Asset;
     /** Per-call-site 9-sliced panel override. Chrome normally comes from the active theme; most callers leave this unset. */
     hudBackgroundAsset?: Asset;
-    /** Game font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. */
+    /** Game display-font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme. */
     fontFamily?: string;
     /** Scopes an `@almadar/ui` theme (e.g. "game-sci-fi-dark") to this shell's subtree. */
     "data-theme"?: string;
@@ -5487,6 +5499,11 @@ interface CalendarGridProps {
     titleField?: string;
     /** Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`. */
     startField?: string;
+    /** Row field holding the end timestamp (ISO or epoch). Defaults to `endTime`.
+     *  When a row carries an end, the event's chip renders in its start slot and
+     *  every further slot it covers shows a subdued continuation bar — without
+     *  this, multi-hour events silently collapsed to their first hour. */
+    endField?: string;
     /** Row field holding the chip's Tailwind colour class. Defaults to `color`. */
     colorField?: string;
     /**
@@ -5505,7 +5522,7 @@ interface CalendarGridProps {
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
 }
-declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
+declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, endField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
 declare namespace CalendarGrid {
     var displayName: string;
 }
@@ -10765,7 +10782,10 @@ interface DetailPanelProps extends DisplayStateProps {
     sections?: readonly DetailSection[];
     /** Unified actions array - first action with variant='primary' is the main action */
     actions?: readonly DetailPanelAction[];
-    /** Max inline action buttons before the rest collapse into a "⋯" overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline. */
+    /** Max inline action buttons before the rest collapse into a "⋯" overflow
+     *  menu (mirrors DataGrid's maxInlineActions). Defaults to 2 — primary +
+     *  secondary visible, the rest under the menu — so every detail panel
+     *  carries the same action pattern. */
     maxInlineActions?: number;
     /**
      * Navigation-back affordance. Renders top-LEFT before the title (OS/back
@@ -10789,7 +10809,8 @@ interface DetailPanelProps extends DisplayStateProps {
     width?: string;
     /** Display fields (alias for fields) */
     displayFields?: readonly string[];
-    /** Show actions flag */
+    /** When false, hides the action buttons + overflow menu (and the close ×).
+     *  Defaults to true. */
     showActions?: boolean;
     /** Relation display data: { fieldName: [{value, label}] } — injected
      *  server-side by the runtime (relation-option injection) or bound by
@@ -11607,7 +11628,7 @@ interface UISlotComponentProps {
  *
  * Handles different slot types with appropriate wrappers.
  */
-declare function UISlotComponent({ slot, portal, position, className, children, pattern, sourceTrait, }: UISlotComponentProps): React__default.ReactElement | null;
+declare function UISlotComponent(props: UISlotComponentProps): React__default.ReactElement | null;
 interface SlotContentRendererProps {
     content: SlotContent;
     onDismiss: () => void;

package/dist/components/index.d.ts

@@ -18,7 +18,7 @@ export { D as DEFAULT_SLOTS, S as SlotAnimation, a as SlotChangeCallback, c as S
 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, useMediaQuery, 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';
-export { a as NavStackApi, u as useNavStack } from '../NavStackContext-BoVV9nWb.js';
+export { a as NavStackApi, u as useNavStack } from '../NavStackContext-bw2nlBgT.js';
 import 'three';
 import 'clsx';
 import '@tanstack/react-query';
@@ -483,7 +483,8 @@ interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement> {
     /** When set, renders a small X button on the right of the badge that
      *  invokes this handler — turns the badge into a removable chip.
      *  Used by the TagInput molecule and other "list of removable values"
-     *  surfaces. */
+     *  surfaces.
+     *  @offByDefault */
     onRemove?: () => void;
     /** Accessible label for the remove button. Defaults to "Remove". */
     removeLabel?: string;
@@ -597,7 +598,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     label?: string | number;
     /** Lucide icon component or canonical kebab-case icon name string */
     icon?: IconInput;
-    /** Called when the user clicks the remove (×) button */
+    /** Called when the user clicks the remove (×) button
+     *  @offByDefault */
     onRemove?: () => void;
     /** Disable the remove button (renders without × control) */
     removable?: boolean;
@@ -607,7 +609,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     clickEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
-    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label } */
+    /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
@@ -2268,9 +2271,11 @@ interface ControlGridProps {
     directionAssets?: Partial<Record<DPadDirection, Asset>>;
     size?: 'sm' | 'md' | 'lg';
     disabled?: boolean;
+    /** "auto" (default) renders only on coarse-pointer (touch) devices; "always" renders everywhere. */
+    visibility?: 'auto' | 'always';
     className?: string;
 }
-declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, className, }: ControlGridProps): React$1.JSX.Element;
+declare function ControlGrid({ kind, buttons, layout, includeDiagonals, onAction, actionEvent, onDirection, directionEvent, directionEvents, directionReleaseEvents, directionAssets, size, disabled, visibility, className, }: ControlGridProps): React$1.JSX.Element | null;
 declare namespace ControlGrid {
     var displayName: string;
 }
@@ -2351,12 +2356,17 @@ interface GameHudProps {
     elements?: readonly GameHudElement[];
     /** Size variant */
     size?: "sm" | "md" | "lg";
+    /**
+     * Layout variant: "floating" (default) renders a compact pill cluster that hugs
+     * its content width; "bar" preserves the legacy full-width split bar.
+     */
+    variant?: "floating" | "bar";
     /** Additional CSS classes */
     className?: string;
     /** Whether to use a semi-transparent background */
     transparent?: boolean;
 }
-declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, className, transparent, }: GameHudProps): React$1.JSX.Element;
+declare function GameHud({ position: propPosition, stats: propStats, items, elements, size, variant, className, transparent, }: GameHudProps): React$1.JSX.Element;
 declare namespace GameHud {
     var displayName: string;
 }
@@ -2924,13 +2934,15 @@ interface TraitSlotProps {
     feedback?: 'correct' | 'wrong' | null;
     /** Click handler */
     onClick?: () => void;
-    /** Remove handler */
+    /** Remove handler
+     *  @offByDefault */
     onRemove?: () => void;
     /** Emits UI:{clickEvent} with { slotNumber } */
     clickEvent?: EventEmit<{
         slotNumber: number;
     }>;
-    /** Emits UI:{removeEvent} with { slotNumber } */
+    /** Emits UI:{removeEvent} with { slotNumber }
+     *  @offByDefault */
     removeEvent?: EventEmit<{
         slotNumber: number;
     }>;
@@ -3450,13 +3462,13 @@ declare const ALL_PRESETS: PhysicsPreset[];
 interface GameShellProps {
     /** Application / game title shown as a floating chip */
     appName?: string;
-    /** Stat chips row — floats along the top edge */
+    /** Stat chips row — floats along the top edge. Legacy chrome surface: new behaviors emit HUD chrome via `render-ui "hud-top"` instead. */
     hud?: React__default.ReactNode;
-    /** Action cluster — floats bottom-right (End Turn, Fire, Reset, …) */
+    /** Action cluster — floats bottom-right (End Turn, Fire, Reset, …). Legacy chrome surface: new behaviors emit action chrome via `render-ui "hud-bottom"` or `"floating"` instead. */
     addons?: React__default.ReactNode;
-    /** Movement controls — floats bottom-left (d-pad / control-grid). */
+    /** Movement controls — floats bottom-left (d-pad / control-grid). Legacy chrome surface: new behaviors emit movement controls via `render-ui "hud-bottom"` instead. */
     controls?: React__default.ReactNode;
-    /** Centered overlay layer (victory/defeat banners, dialogs). */
+    /** Centered overlay layer (victory/defeat banners, dialogs). Legacy chrome surface: new behaviors emit overlays via `render-ui "overlay"` (clear with `render-ui "overlay" null` on every exit) instead. */
     overlay?: React__default.ReactNode;
     /** Extra class name on the root container */
     className?: string;
@@ -3468,7 +3480,7 @@ interface GameShellProps {
     backgroundAsset?: Asset;
     /** Per-call-site 9-sliced panel override. Chrome normally comes from the active theme; most callers leave this unset. */
     hudBackgroundAsset?: Asset;
-    /** Game font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. */
+    /** Game display-font key (future | future-narrow | pixel | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme. */
     fontFamily?: string;
     /** Scopes an `@almadar/ui` theme (e.g. "game-sci-fi-dark") to this shell's subtree. */
     "data-theme"?: string;
@@ -5487,6 +5499,11 @@ interface CalendarGridProps {
     titleField?: string;
     /** Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`. */
     startField?: string;
+    /** Row field holding the end timestamp (ISO or epoch). Defaults to `endTime`.
+     *  When a row carries an end, the event's chip renders in its start slot and
+     *  every further slot it covers shows a subdued continuation bar — without
+     *  this, multi-hour events silently collapsed to their first hour. */
+    endField?: string;
     /** Row field holding the chip's Tailwind colour class. Defaults to `color`. */
     colorField?: string;
     /**
@@ -5505,7 +5522,7 @@ interface CalendarGridProps {
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
 }
-declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
+declare function CalendarGrid({ weekStart, timeSlots, events, onSlotClick, onDayClick, onEventClick, className, longPressEvent, longPressPayload, swipeLeftEvent, swipeRightEvent, dayWindow, titleField, startField, endField, colorField, children, renderItem, }: CalendarGridProps): React__default.JSX.Element;
 declare namespace CalendarGrid {
     var displayName: string;
 }
@@ -10765,7 +10782,10 @@ interface DetailPanelProps extends DisplayStateProps {
     sections?: readonly DetailSection[];
     /** Unified actions array - first action with variant='primary' is the main action */
     actions?: readonly DetailPanelAction[];
-    /** Max inline action buttons before the rest collapse into a "⋯" overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline. */
+    /** Max inline action buttons before the rest collapse into a "⋯" overflow
+     *  menu (mirrors DataGrid's maxInlineActions). Defaults to 2 — primary +
+     *  secondary visible, the rest under the menu — so every detail panel
+     *  carries the same action pattern. */
     maxInlineActions?: number;
     /**
      * Navigation-back affordance. Renders top-LEFT before the title (OS/back
@@ -10789,7 +10809,8 @@ interface DetailPanelProps extends DisplayStateProps {
     width?: string;
     /** Display fields (alias for fields) */
     displayFields?: readonly string[];
-    /** Show actions flag */
+    /** When false, hides the action buttons + overflow menu (and the close ×).
+     *  Defaults to true. */
     showActions?: boolean;
     /** Relation display data: { fieldName: [{value, label}] } — injected
      *  server-side by the runtime (relation-option injection) or bound by
@@ -11607,7 +11628,7 @@ interface UISlotComponentProps {
  *
  * Handles different slot types with appropriate wrappers.
  */
-declare function UISlotComponent({ slot, portal, position, className, children, pattern, sourceTrait, }: UISlotComponentProps): React__default.ReactElement | null;
+declare function UISlotComponent(props: UISlotComponentProps): React__default.ReactElement | null;
 interface SlotContentRendererProps {
     content: SlotContent;
     onDismiss: () => void;