@almadar/ui 5.157.0 → 5.159.0

package/dist/components/index.d.cts

@@ -3735,13 +3735,33 @@ interface FileTreeNode {
     /** Detected language for syntax highlighting */
     language?: string;
 }
+/** Flat tree row for `items` mode — nested at render time by `parentId`. */
+interface FileTreeItem {
+    /** Unique node id */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Id of this node's parent; empty/absent marks a root */
+    parentId?: string;
+    /** Icon name override (falls back to folder/file by presence of children) */
+    icon?: string;
+}
 interface FileTreeProps {
-    /** The tree data */
-    tree: FileTreeNode[];
+    /** The tree data (pre-nested). Ignored when `items` is provided. */
+    tree?: FileTreeNode[];
+    /** Flat node list, nested by `parentId` at render time — takes precedence
+     *  over `tree` when provided. A `parentId` with no matching row renders
+     *  that node as a root rather than dropping it. */
+    items?: FileTreeItem[];
     /** Currently selected file path */
     selectedPath?: string;
     /** Called when a file is clicked */
     onFileSelect?: (path: string) => void;
+    /** Called when a node is clicked, in flat `items` mode; carries the
+     *  selected node's id. Presence-gated: binding this prop is what turns on
+     *  the click-to-select affordance, mirroring Badge's `onRemove`.
+     *  @offByDefault */
+    onNodeSelect?: (id: string) => void;
     /** CSS class */
     className?: string;
     /** Indent size per level in px (default: 16) */
@@ -4789,6 +4809,11 @@ declare const OnboardingSpotlight: React__default.FC<OnboardingSpotlightProps>;
  * Composed from: Box, HStack, VStack, Input, Button, Spinner, Typography atoms
  */
 
+/** Relation cardinality vocabulary — mirrors `@almadar/core`'s
+ *  `RelationCardinality` (spelled inline: the pattern extractor resolves
+ *  components-tree aliases to `enumValues`, but treats core imports as
+ *  opaque). `many`/`one-to-many`/`many-to-many` drive multi-value pickers. */
+type RelationFieldCardinality = "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many";
 interface RelationOption {
     /** The value to store (typically the ID) */
     value: string;
@@ -10727,6 +10752,13 @@ declare const StatCard: React__default.FC<StatCardProps>;
  * Extends DisplayStateProps (see ./types.ts) and declares `entity?: EntityRow`.
  */
 
+/** Relation descriptor injected onto a display field — target entity +
+ *  cardinality, mirroring the `.lolo` `{type:"relation", relation:{...}}`
+ *  descriptor. */
+interface DetailRelationMeta {
+    entity: string;
+    cardinality?: RelationFieldCardinality;
+}
 interface DetailField {
     label: string;
     value: React__default.ReactNode;
@@ -10762,12 +10794,12 @@ type FieldDef$2 = string | {
     header?: string;
     type?: string;
     values?: readonly string[];
-    relation?: string;
+    relation?: DetailRelationMeta;
 } | {
     name: string;
     type: string;
     values?: readonly string[];
-    relation?: string;
+    relation?: DetailRelationMeta;
 };
 interface DetailPanelStatus {
     label: string;
@@ -10782,6 +10814,14 @@ interface DetailPanelProps extends DisplayStateProps {
     /** RECORD-cardinality: renders ONE record (see body collapse below). */
     entity?: EntityRow;
     title?: string;
+    /**
+     * When bound, the title becomes editable in place: clicking it swaps the
+     * heading for an input, Enter or blur commits, Escape reverts. Receives the
+     * committed title and the record's id so the host can persist a partial
+     * update. Unbound, the title stays a plain heading.
+     * @offByDefault
+     */
+    onTitleCommit?: (title: string, id: string) => void;
     subtitle?: string;
     status?: DetailPanelStatus;
     avatar?: React__default.ReactNode;
@@ -10895,8 +10935,10 @@ interface RelationConfig {
     entity: string;
     /** Field on target entity to display (defaults to 'name') */
     displayField?: string;
-    /** Cardinality: one-to-one or one-to-many */
-    cardinality?: "one" | "many";
+    /** Cardinality of the relation — many-valued spellings drive the
+     *  multi-select picker below; anything else (including absent) stays
+     *  single-select. */
+    cardinality?: RelationFieldCardinality;
 }
 /**
  * Validation-rule bundle for a schema field. Only `enum` is actually read

package/dist/components/index.d.ts

@@ -3735,13 +3735,33 @@ interface FileTreeNode {
     /** Detected language for syntax highlighting */
     language?: string;
 }
+/** Flat tree row for `items` mode — nested at render time by `parentId`. */
+interface FileTreeItem {
+    /** Unique node id */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Id of this node's parent; empty/absent marks a root */
+    parentId?: string;
+    /** Icon name override (falls back to folder/file by presence of children) */
+    icon?: string;
+}
 interface FileTreeProps {
-    /** The tree data */
-    tree: FileTreeNode[];
+    /** The tree data (pre-nested). Ignored when `items` is provided. */
+    tree?: FileTreeNode[];
+    /** Flat node list, nested by `parentId` at render time — takes precedence
+     *  over `tree` when provided. A `parentId` with no matching row renders
+     *  that node as a root rather than dropping it. */
+    items?: FileTreeItem[];
     /** Currently selected file path */
     selectedPath?: string;
     /** Called when a file is clicked */
     onFileSelect?: (path: string) => void;
+    /** Called when a node is clicked, in flat `items` mode; carries the
+     *  selected node's id. Presence-gated: binding this prop is what turns on
+     *  the click-to-select affordance, mirroring Badge's `onRemove`.
+     *  @offByDefault */
+    onNodeSelect?: (id: string) => void;
     /** CSS class */
     className?: string;
     /** Indent size per level in px (default: 16) */
@@ -4789,6 +4809,11 @@ declare const OnboardingSpotlight: React__default.FC<OnboardingSpotlightProps>;
  * Composed from: Box, HStack, VStack, Input, Button, Spinner, Typography atoms
  */
 
+/** Relation cardinality vocabulary — mirrors `@almadar/core`'s
+ *  `RelationCardinality` (spelled inline: the pattern extractor resolves
+ *  components-tree aliases to `enumValues`, but treats core imports as
+ *  opaque). `many`/`one-to-many`/`many-to-many` drive multi-value pickers. */
+type RelationFieldCardinality = "one" | "many" | "one-to-many" | "many-to-one" | "many-to-many";
 interface RelationOption {
     /** The value to store (typically the ID) */
     value: string;
@@ -10727,6 +10752,13 @@ declare const StatCard: React__default.FC<StatCardProps>;
  * Extends DisplayStateProps (see ./types.ts) and declares `entity?: EntityRow`.
  */
 
+/** Relation descriptor injected onto a display field — target entity +
+ *  cardinality, mirroring the `.lolo` `{type:"relation", relation:{...}}`
+ *  descriptor. */
+interface DetailRelationMeta {
+    entity: string;
+    cardinality?: RelationFieldCardinality;
+}
 interface DetailField {
     label: string;
     value: React__default.ReactNode;
@@ -10762,12 +10794,12 @@ type FieldDef$2 = string | {
     header?: string;
     type?: string;
     values?: readonly string[];
-    relation?: string;
+    relation?: DetailRelationMeta;
 } | {
     name: string;
     type: string;
     values?: readonly string[];
-    relation?: string;
+    relation?: DetailRelationMeta;
 };
 interface DetailPanelStatus {
     label: string;
@@ -10782,6 +10814,14 @@ interface DetailPanelProps extends DisplayStateProps {
     /** RECORD-cardinality: renders ONE record (see body collapse below). */
     entity?: EntityRow;
     title?: string;
+    /**
+     * When bound, the title becomes editable in place: clicking it swaps the
+     * heading for an input, Enter or blur commits, Escape reverts. Receives the
+     * committed title and the record's id so the host can persist a partial
+     * update. Unbound, the title stays a plain heading.
+     * @offByDefault
+     */
+    onTitleCommit?: (title: string, id: string) => void;
     subtitle?: string;
     status?: DetailPanelStatus;
     avatar?: React__default.ReactNode;
@@ -10895,8 +10935,10 @@ interface RelationConfig {
     entity: string;
     /** Field on target entity to display (defaults to 'name') */
     displayField?: string;
-    /** Cardinality: one-to-one or one-to-many */
-    cardinality?: "one" | "many";
+    /** Cardinality of the relation — many-valued spellings drive the
+     *  multi-select picker below; anything else (including absent) stays
+     *  single-select. */
+    cardinality?: RelationFieldCardinality;
 }
 /**
  * Validation-rule bundle for a schema field. Only `enum` is actually read