@almadar/ui 5.133.0 → 5.135.0

package/dist/components/index.d.cts

@@ -8,9 +8,9 @@ export { A as AudioManifest, G as GameAudioContext, a as GameAudioContextValue,
 import { SExpr } from '@almadar/evaluator';
 import { U as UnitAnimationState, F as FacingDirection, S as SpriteSheetUrls, d as SpriteFrameDims, R as ResolvedFrame, a as IsometricUnit, C as CameraState, e as FieldInfo, f as OrbitalTraitInfo, g as OrbitalPageInfo, T as TraitLevelData, E as ExternalLink } from '../avl-schema-parser-B8Onmfsu.cjs';
 export { B as BoardTile, G as GameAction, h as GamePhase, i as GameState, j as GameUnit, b as IsometricFeature, I as IsometricTile, P as Position, k as UnitTrait, l as calculateAttackTargets, m as calculateValidMoves, n as createInitialGameState } from '../avl-schema-parser-B8Onmfsu.cjs';
-import { D as DrawableNode } from '../paintDispatch-BXJgISot.cjs';
-import { C as ContentSegment, b as DomLayoutData, d as DomStateNode, V as VisualizerConfig, e as DomTransitionLabel } from '../cn-D3H9UzCW.cjs';
-export { n as cn } from '../cn-D3H9UzCW.cjs';
+import { D as DrawableNode } from '../paintDispatch-Bl2sfRFb.cjs';
+import { C as ContentSegment, b as DomLayoutData, d as DomStateNode, V as VisualizerConfig, e as DomTransitionLabel } from '../cn-B8GXqrtp.cjs';
+export { n as cn } from '../cn-B8GXqrtp.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, 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';
@@ -1131,6 +1131,12 @@ interface TypographyProps {
     className?: string;
     /** Inline style */
     style?: React__default.CSSProperties;
+    /**
+     * Value formatting applied to string/number/Date content — `none` (the
+     * default) renders content as-is. Covers the raw-ISO-date class: a bound
+     * datetime renders human-readable via `format="date"|"time"|"datetime"`.
+     */
+    format?: "none" | "date" | "time" | "datetime" | "number" | "currency" | "percent";
     /** Text content (alternative to children) */
     content?: React__default.ReactNode;
     /** Children elements */
@@ -6436,7 +6442,9 @@ declare namespace DataGrid {
  *
  * A simplified, schema-driven list for iterating over entity data.
  * Extracted from the List organism with all complexity removed:
- * no built-in search, sort, filter, selection, bulk actions, or custom renderers.
+ * no built-in search, filter, selection, bulk actions, or custom renderers.
+ * Ordering is available via `sortBy`/`sortDirection`, but it orders only the
+ * rows handed in — a set larger than its `limit` must be ordered upstream.
  *
  * Accepts `fields` config for per-field rendering control (icon, variant, format)
  * and `itemActions` for per-item event bus wiring.
@@ -6503,8 +6511,20 @@ interface DataListProps extends DataDndProps {
     groupBy?: string;
     /** Field name identifying the sender (used with variant: "message") */
     senderField?: string;
+    /**
+     * Field holding the sender's human-readable name (used with variant: "message").
+     * Defaults to `senderField`. Set this when `senderField` holds an id — an
+     * id-keyed thread otherwise labels bubbles `staff-1` instead of `Sam Staff`.
+     */
+    senderLabelField?: string;
     /** Current user identifier; messages matching this value align right (used with variant: "message") */
     currentUser?: string;
+    /**
+     * Message shown when there are no rows. Falls back to the generic
+     * "no items" translation. `TableView` already exposes this; an agenda or an
+     * inbox wants to say what "empty" means in its own words.
+     */
+    emptyMessage?: string;
     /** Additional CSS classes */
     className?: string;
     /** Loading state */
@@ -6547,13 +6567,25 @@ interface DataListProps extends DataDndProps {
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
+    /**
+     * Field name to order rows by. Values are compared by their own type —
+     * numbers numerically, date-like strings chronologically, everything else
+     * alphabetically — never by what the field is called. Empty cells sort last.
+     * Unset leaves the incoming order untouched.
+     *
+     * Orders only the rows already fetched: a collection larger than its `limit`
+     * still needs ordering at the data layer.
+     */
+    sortBy?: string;
+    /** Direction for `sortBy`. Defaults to ascending. */
+    sortDirection?: "asc" | "desc";
     /**
      * Layer 2 visual treatment — mirrors the `entity-table` look enum so
      * data-grid / data-list / entity-table share one knob name from authors.
      */
     look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 }
-declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | React__default.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
+declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, senderLabelField, currentUser, emptyMessage, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, sortBy, sortDirection, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | React__default.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
 declare namespace DataList {
     var displayName: string;
 }
@@ -9034,6 +9066,14 @@ declare const DocumentViewer: React__default.FC<DocumentViewerProps>;
  * - className for external styling
  */
 
+type GraphNodeMark = {
+    kind: 'suggested';
+    suggestionId: string;
+} | {
+    kind: 'proposed';
+    suggestionId: string;
+    tint?: string;
+};
 type GraphNode = EventPayload & {
     id: string;
     label?: string;
@@ -9042,6 +9082,8 @@ type GraphNode = EventPayload & {
     size?: number;
     /** Merge-cluster count (drawn as a top-right badge; click expands). */
     badge?: number;
+    /** Overlay decoration: a suggestion/proposal target. undefined = ordinary committed node. */
+    mark?: GraphNodeMark;
     /** Position (optional, computed if missing) */
     x?: number;
     y?: number;
@@ -9079,6 +9121,8 @@ interface GraphCanvasProps {
     nodes?: readonly GraphNode[];
     /** Graph edges (the only rendered links) */
     edges?: readonly GraphEdge[];
+    /** Uncommitted proposal links — rendered dashed/faint in a separate pass, never folded into the layout springs. */
+    proposedEdges?: readonly GraphEdge[];
     /**
      * All-pairs similarity (cosine 0–1) used ONLY for layout, never drawn. It is the
      * secondary macro-layout: non-connected pairs get a weak spring (higher cosine ⇒
@@ -9098,6 +9142,8 @@ interface GraphCanvasProps {
     actions?: readonly GraphAction[];
     /** On node click */
     onNodeClick?: (node: GraphNode) => void;
+    /** On marked-node click (suggestion/proposal target). Takes priority over onNodeClick. */
+    onMarkClick?: (node: GraphNode) => void;
     /** On node double-click (e.g. to drill in) */
     onNodeDoubleClick?: (node: GraphNode) => void;
     /** On node badge click (e.g. to expand a merged cluster). */

package/dist/components/index.d.ts

@@ -8,9 +8,9 @@ export { A as AudioManifest, G as GameAudioContext, a as GameAudioContextValue,
 import { SExpr } from '@almadar/evaluator';
 import { U as UnitAnimationState, F as FacingDirection, S as SpriteSheetUrls, d as SpriteFrameDims, R as ResolvedFrame, a as IsometricUnit, C as CameraState, e as FieldInfo, f as OrbitalTraitInfo, g as OrbitalPageInfo, T as TraitLevelData, E as ExternalLink } from '../avl-schema-parser-B8Onmfsu.js';
 export { B as BoardTile, G as GameAction, h as GamePhase, i as GameState, j as GameUnit, b as IsometricFeature, I as IsometricTile, P as Position, k as UnitTrait, l as calculateAttackTargets, m as calculateValidMoves, n as createInitialGameState } from '../avl-schema-parser-B8Onmfsu.js';
-import { D as DrawableNode } from '../paintDispatch-BXJgISot.js';
-import { C as ContentSegment, b as DomLayoutData, d as DomStateNode, V as VisualizerConfig, e as DomTransitionLabel } from '../cn-Dm0VrLRG.js';
-export { n as cn } from '../cn-Dm0VrLRG.js';
+import { D as DrawableNode } from '../paintDispatch-Bl2sfRFb.js';
+import { C as ContentSegment, b as DomLayoutData, d as DomStateNode, V as VisualizerConfig, e as DomTransitionLabel } from '../cn-CZq0uJLA.js';
+export { n as cn } from '../cn-CZq0uJLA.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, 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';
@@ -1131,6 +1131,12 @@ interface TypographyProps {
     className?: string;
     /** Inline style */
     style?: React__default.CSSProperties;
+    /**
+     * Value formatting applied to string/number/Date content — `none` (the
+     * default) renders content as-is. Covers the raw-ISO-date class: a bound
+     * datetime renders human-readable via `format="date"|"time"|"datetime"`.
+     */
+    format?: "none" | "date" | "time" | "datetime" | "number" | "currency" | "percent";
     /** Text content (alternative to children) */
     content?: React__default.ReactNode;
     /** Children elements */
@@ -6436,7 +6442,9 @@ declare namespace DataGrid {
  *
  * A simplified, schema-driven list for iterating over entity data.
  * Extracted from the List organism with all complexity removed:
- * no built-in search, sort, filter, selection, bulk actions, or custom renderers.
+ * no built-in search, filter, selection, bulk actions, or custom renderers.
+ * Ordering is available via `sortBy`/`sortDirection`, but it orders only the
+ * rows handed in — a set larger than its `limit` must be ordered upstream.
  *
  * Accepts `fields` config for per-field rendering control (icon, variant, format)
  * and `itemActions` for per-item event bus wiring.
@@ -6503,8 +6511,20 @@ interface DataListProps extends DataDndProps {
     groupBy?: string;
     /** Field name identifying the sender (used with variant: "message") */
     senderField?: string;
+    /**
+     * Field holding the sender's human-readable name (used with variant: "message").
+     * Defaults to `senderField`. Set this when `senderField` holds an id — an
+     * id-keyed thread otherwise labels bubbles `staff-1` instead of `Sam Staff`.
+     */
+    senderLabelField?: string;
     /** Current user identifier; messages matching this value align right (used with variant: "message") */
     currentUser?: string;
+    /**
+     * Message shown when there are no rows. Falls back to the generic
+     * "no items" translation. `TableView` already exposes this; an agenda or an
+     * inbox wants to say what "empty" means in its own words.
+     */
+    emptyMessage?: string;
     /** Additional CSS classes */
     className?: string;
     /** Loading state */
@@ -6547,13 +6567,25 @@ interface DataListProps extends DataDndProps {
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
     /** Max items to show before "Show More" button. Defaults to 5. Set to 0 to disable. */
     pageSize?: number;
+    /**
+     * Field name to order rows by. Values are compared by their own type —
+     * numbers numerically, date-like strings chronologically, everything else
+     * alphabetically — never by what the field is called. Empty cells sort last.
+     * Unset leaves the incoming order untouched.
+     *
+     * Orders only the rows already fetched: a collection larger than its `limit`
+     * still needs ordering at the data layer.
+     */
+    sortBy?: string;
+    /** Direction for `sortBy`. Defaults to ascending. */
+    sortDirection?: "asc" | "desc";
     /**
      * Layer 2 visual treatment — mirrors the `entity-table` look enum so
      * data-grid / data-list / entity-table share one knob name from authors.
      */
     look?: "dense" | "spacious" | "striped" | "borderless" | "card-rows";
 }
-declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, currentUser, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | React__default.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
+declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, senderField, senderLabelField, currentUser, emptyMessage, className, isLoading, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, sortBy, sortDirection, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, }: DataListProps): string | number | bigint | boolean | React__default.JSX.Element | Iterable<React__default.ReactNode> | Promise<string | number | bigint | boolean | React__default.ReactPortal | React__default.ReactElement<unknown, string | React__default.JSXElementConstructor<any>> | Iterable<React__default.ReactNode> | null | undefined> | null | undefined;
 declare namespace DataList {
     var displayName: string;
 }
@@ -9034,6 +9066,14 @@ declare const DocumentViewer: React__default.FC<DocumentViewerProps>;
  * - className for external styling
  */
 
+type GraphNodeMark = {
+    kind: 'suggested';
+    suggestionId: string;
+} | {
+    kind: 'proposed';
+    suggestionId: string;
+    tint?: string;
+};
 type GraphNode = EventPayload & {
     id: string;
     label?: string;
@@ -9042,6 +9082,8 @@ type GraphNode = EventPayload & {
     size?: number;
     /** Merge-cluster count (drawn as a top-right badge; click expands). */
     badge?: number;
+    /** Overlay decoration: a suggestion/proposal target. undefined = ordinary committed node. */
+    mark?: GraphNodeMark;
     /** Position (optional, computed if missing) */
     x?: number;
     y?: number;
@@ -9079,6 +9121,8 @@ interface GraphCanvasProps {
     nodes?: readonly GraphNode[];
     /** Graph edges (the only rendered links) */
     edges?: readonly GraphEdge[];
+    /** Uncommitted proposal links — rendered dashed/faint in a separate pass, never folded into the layout springs. */
+    proposedEdges?: readonly GraphEdge[];
     /**
      * All-pairs similarity (cosine 0–1) used ONLY for layout, never drawn. It is the
      * secondary macro-layout: non-connected pairs get a weak spring (higher cosine ⇒
@@ -9098,6 +9142,8 @@ interface GraphCanvasProps {
     actions?: readonly GraphAction[];
     /** On node click */
     onNodeClick?: (node: GraphNode) => void;
+    /** On marked-node click (suggestion/proposal target). Takes priority over onNodeClick. */
+    onMarkClick?: (node: GraphNode) => void;
     /** On node double-click (e.g. to drill in) */
     onNodeDoubleClick?: (node: GraphNode) => void;
     /** On node badge click (e.g. to expand a merged cluster). */