@almadar/ui 5.162.0 → 5.164.0

package/dist/components/index.d.cts

@@ -3755,6 +3755,14 @@ interface FileTreeProps {
     items?: FileTreeItem[];
     /** Currently selected file path */
     selectedPath?: string;
+    /** Currently selected node id, in flat `items` mode: the row highlights
+     *  and every ancestor auto-expands so the selection is always visible —
+     *  the "you are here" a navigation tree needs. */
+    selectedId?: string;
+    /** Visual treatment for flat `items` mode: `files` (default) keeps the
+     *  monospace file-browser look; `nav` renders a sidebar navigation tree —
+     *  regular font, document icons, roomier hit areas. */
+    look?: 'files' | 'nav';
     /** Called when a file is clicked */
     onFileSelect?: (path: string) => void;
     /** Called when a node is clicked, in flat `items` mode; carries the
@@ -3762,6 +3770,14 @@ interface FileTreeProps {
      *  the click-to-select affordance, mirroring Badge's `onRemove`.
      *  @offByDefault */
     onNodeSelect?: (id: string) => void;
+    /** Called from the row's hover action button, in flat `items` mode;
+     *  carries that node's id. Presence-gated: binding it renders the action.
+     *  @offByDefault */
+    onNodeAction?: (id: string) => void;
+    /** Icon for the row hover action (default: plus). */
+    nodeActionIcon?: string;
+    /** Accessible label/tooltip for the row hover action. */
+    nodeActionLabel?: string;
     /** CSS class */
     className?: string;
     /** Indent size per level in px (default: 16) */
@@ -8881,6 +8897,12 @@ interface DocumentPanelProps {
     title?: string;
     /** Muted byline under the title; hidden when empty */
     subtitle?: string;
+    /** Cover/hero image URL painted as a full-bleed banner above the header
+     *  row (Notion/article-hero shape); hidden when empty */
+    coverImage?: string;
+    /** Document icon rendered beside the title (a file glyph, a domain icon);
+     *  hidden when empty */
+    icon?: IconInput;
     /** The document body as rich-text HTML */
     value?: string;
     /** Header actions (settings, history, …). At most one explicit primary
@@ -8916,7 +8938,7 @@ interface DocumentPanelProps {
     placeholder?: string;
     className?: string;
 }
-declare function DocumentPanel({ id, title, subtitle, value, actions, maxInlineActions, editing, titleCommitEvent, contentChangeEvent, editEvent, doneEvent, editLabel, doneLabel, autosaveHint, placeholder, className, }: DocumentPanelProps): React__default.ReactElement;
+declare function DocumentPanel({ id, title, subtitle, coverImage, icon, value, actions, maxInlineActions, editing, titleCommitEvent, contentChangeEvent, editEvent, doneEvent, editLabel, doneLabel, autosaveHint, placeholder, className, }: DocumentPanelProps): React__default.ReactElement;
 
 /**
  * DocumentDetails Molecule
@@ -8945,19 +8967,24 @@ interface DocumentDetailsField {
     header?: string;
     /** Lucide icon name or component shown beside the label */
     icon?: IconInput;
-    /** How the property edits: text input, boolean switch, select, or display-only.
-     *  Inferred from the value when omitted (boolean → boolean, array → readonly, else text). */
-    kind?: 'text' | 'boolean' | 'select' | 'readonly';
+    /** How the property edits: text input, boolean switch, select, image
+     *  thumbnail, or display-only. Inferred from the value when omitted
+     *  (boolean → boolean, array → readonly, image-typed → image, else text). */
+    kind?: 'text' | 'boolean' | 'select' | 'readonly' | 'image';
     /** Options for kind: 'select' */
     options?: readonly string[];
     /** Display format for the read value */
     format?: 'date' | 'currency' | 'number' | 'boolean' | 'percent';
+    /** Entity-declared field type, injected by the display fields contract —
+     *  drives kind inference (e.g. `image` → thumbnail row). */
+    type?: string;
 }
 /**
  * DocumentDetails — the document's metadata as a compact settings card for
  * the rail beside a DocumentPanel, each property committing in place.
  *
  * @capabilities document settings, page details, post settings sidebar, metadata panel, document properties, publish settings
+ * @fieldsContract display
  */
 interface DocumentDetailsProps {
     /** The loaded record — supplies the id every commit carries and the
@@ -8971,11 +8998,19 @@ interface DocumentDetailsProps {
         id: string;
         patch: Record<string, FieldValue>;
     }>;
+    /** Makes relation chips clickable: emitted with { field, id, name } when a
+     *  hydrated relation value (or one row of a many-relation) is clicked —
+     *  the host routes it to the linked record's own surface. */
+    relationEvent?: EventEmit<{
+        field: string;
+        id: string;
+        name: string;
+    }>;
     /** Card heading (defaults to the localized "Details") */
     title?: string;
     className?: string;
 }
-declare function DocumentDetails({ entity, fields, metaCommitEvent, title, className, }: DocumentDetailsProps): React__default.ReactElement | null;
+declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, }: DocumentDetailsProps): React__default.ReactElement | null;
 
 /**
  * ReplyTree Organism Component
@@ -12631,6 +12666,10 @@ interface DashboardLayoutProps {
     /** Custom sidebar footer (optional). When omitted, the sidebar has
      *  no footer — apps that need Settings/etc. add them via navItems. */
     sidebarFooter?: React__default.ReactNode;
+    /** Optional content region rendered between the nav links and the footer —
+     *  a page tree or any consumer navigation surface; scrolls independently
+     *  and takes the sidebar's remaining height. Hidden in the collapsed rail. */
+    sidebarContent?: React__default.ReactNode;
     /** Active path used to highlight the matching nav item. Falls back
      *  to `useCurrentPagePath()` (set by `CurrentPagePathProvider`), then
      *  to `useLocation().pathname`. Production deploys can omit it; the

package/dist/components/index.d.ts

@@ -3755,6 +3755,14 @@ interface FileTreeProps {
     items?: FileTreeItem[];
     /** Currently selected file path */
     selectedPath?: string;
+    /** Currently selected node id, in flat `items` mode: the row highlights
+     *  and every ancestor auto-expands so the selection is always visible —
+     *  the "you are here" a navigation tree needs. */
+    selectedId?: string;
+    /** Visual treatment for flat `items` mode: `files` (default) keeps the
+     *  monospace file-browser look; `nav` renders a sidebar navigation tree —
+     *  regular font, document icons, roomier hit areas. */
+    look?: 'files' | 'nav';
     /** Called when a file is clicked */
     onFileSelect?: (path: string) => void;
     /** Called when a node is clicked, in flat `items` mode; carries the
@@ -3762,6 +3770,14 @@ interface FileTreeProps {
      *  the click-to-select affordance, mirroring Badge's `onRemove`.
      *  @offByDefault */
     onNodeSelect?: (id: string) => void;
+    /** Called from the row's hover action button, in flat `items` mode;
+     *  carries that node's id. Presence-gated: binding it renders the action.
+     *  @offByDefault */
+    onNodeAction?: (id: string) => void;
+    /** Icon for the row hover action (default: plus). */
+    nodeActionIcon?: string;
+    /** Accessible label/tooltip for the row hover action. */
+    nodeActionLabel?: string;
     /** CSS class */
     className?: string;
     /** Indent size per level in px (default: 16) */
@@ -8881,6 +8897,12 @@ interface DocumentPanelProps {
     title?: string;
     /** Muted byline under the title; hidden when empty */
     subtitle?: string;
+    /** Cover/hero image URL painted as a full-bleed banner above the header
+     *  row (Notion/article-hero shape); hidden when empty */
+    coverImage?: string;
+    /** Document icon rendered beside the title (a file glyph, a domain icon);
+     *  hidden when empty */
+    icon?: IconInput;
     /** The document body as rich-text HTML */
     value?: string;
     /** Header actions (settings, history, …). At most one explicit primary
@@ -8916,7 +8938,7 @@ interface DocumentPanelProps {
     placeholder?: string;
     className?: string;
 }
-declare function DocumentPanel({ id, title, subtitle, value, actions, maxInlineActions, editing, titleCommitEvent, contentChangeEvent, editEvent, doneEvent, editLabel, doneLabel, autosaveHint, placeholder, className, }: DocumentPanelProps): React__default.ReactElement;
+declare function DocumentPanel({ id, title, subtitle, coverImage, icon, value, actions, maxInlineActions, editing, titleCommitEvent, contentChangeEvent, editEvent, doneEvent, editLabel, doneLabel, autosaveHint, placeholder, className, }: DocumentPanelProps): React__default.ReactElement;
 
 /**
  * DocumentDetails Molecule
@@ -8945,19 +8967,24 @@ interface DocumentDetailsField {
     header?: string;
     /** Lucide icon name or component shown beside the label */
     icon?: IconInput;
-    /** How the property edits: text input, boolean switch, select, or display-only.
-     *  Inferred from the value when omitted (boolean → boolean, array → readonly, else text). */
-    kind?: 'text' | 'boolean' | 'select' | 'readonly';
+    /** How the property edits: text input, boolean switch, select, image
+     *  thumbnail, or display-only. Inferred from the value when omitted
+     *  (boolean → boolean, array → readonly, image-typed → image, else text). */
+    kind?: 'text' | 'boolean' | 'select' | 'readonly' | 'image';
     /** Options for kind: 'select' */
     options?: readonly string[];
     /** Display format for the read value */
     format?: 'date' | 'currency' | 'number' | 'boolean' | 'percent';
+    /** Entity-declared field type, injected by the display fields contract —
+     *  drives kind inference (e.g. `image` → thumbnail row). */
+    type?: string;
 }
 /**
  * DocumentDetails — the document's metadata as a compact settings card for
  * the rail beside a DocumentPanel, each property committing in place.
  *
  * @capabilities document settings, page details, post settings sidebar, metadata panel, document properties, publish settings
+ * @fieldsContract display
  */
 interface DocumentDetailsProps {
     /** The loaded record — supplies the id every commit carries and the
@@ -8971,11 +8998,19 @@ interface DocumentDetailsProps {
         id: string;
         patch: Record<string, FieldValue>;
     }>;
+    /** Makes relation chips clickable: emitted with { field, id, name } when a
+     *  hydrated relation value (or one row of a many-relation) is clicked —
+     *  the host routes it to the linked record's own surface. */
+    relationEvent?: EventEmit<{
+        field: string;
+        id: string;
+        name: string;
+    }>;
     /** Card heading (defaults to the localized "Details") */
     title?: string;
     className?: string;
 }
-declare function DocumentDetails({ entity, fields, metaCommitEvent, title, className, }: DocumentDetailsProps): React__default.ReactElement | null;
+declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, }: DocumentDetailsProps): React__default.ReactElement | null;
 
 /**
  * ReplyTree Organism Component
@@ -12631,6 +12666,10 @@ interface DashboardLayoutProps {
     /** Custom sidebar footer (optional). When omitted, the sidebar has
      *  no footer — apps that need Settings/etc. add them via navItems. */
     sidebarFooter?: React__default.ReactNode;
+    /** Optional content region rendered between the nav links and the footer —
+     *  a page tree or any consumer navigation surface; scrolls independently
+     *  and takes the sidebar's remaining height. Hidden in the collapsed rail. */
+    sidebarContent?: React__default.ReactNode;
     /** Active path used to highlight the matching nav item. Falls back
      *  to `useCurrentPagePath()` (set by `CurrentPagePathProvider`), then
      *  to `useLocation().pathname`. Production deploys can omit it; the