@almadar/ui 4.36.0 → 4.38.0

package/dist/components/molecules/BranchingLogicBuilder.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { EventEmit, EventPayload, EventPayloadValue } from '@almadar/core';
 export interface BranchingQuestion {
     id: string;
     label: string;
@@ -6,7 +7,7 @@ export interface BranchingQuestion {
 }
 export type BranchingOperator = 'equals' | 'not-equals' | 'contains' | 'in';
 export declare const END_OF_SURVEY = "end-of-survey";
-export interface BranchingRule {
+export interface BranchingRule extends EventPayload {
     id: string;
     sourceQuestionId: string;
     operator: BranchingOperator;
@@ -14,9 +15,18 @@ export interface BranchingRule {
     targetQuestionId: string | typeof END_OF_SURVEY;
 }
 export interface BranchingLogicBuilderProps {
-    questions: BranchingQuestion[];
-    rules: BranchingRule[];
+    questions: readonly BranchingQuestion[] | EventPayloadValue;
+    /**
+     * Rules. Accepts either a typed array (direct consumers) or the runtime
+     * payload shape from a render-ui binding (`@payload.data`). Narrowed to
+     * `[]` internally when the value isn't an array.
+     */
+    rules: readonly BranchingRule[] | EventPayloadValue;
     onRulesChange?: (rules: BranchingRule[]) => void;
+    /** Event name dispatched via event bus when rules change. Payload: `{ rules }`. */
+    rulesChangeEvent?: EventEmit<{
+        rules: BranchingRule[];
+    }>;
     readOnly?: boolean;
     className?: string;
 }

package/dist/components/molecules/LikertScale.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export type LikertScaleSize = "sm" | "md" | "lg";
 export type LikertScaleVariant = "radios" | "buttons";
 export interface LikertOption {
@@ -16,6 +17,10 @@ export interface LikertScaleProps {
     value?: number | string | null;
     /** Change callback */
     onChange?: (value: number | string) => void;
+    /** Event name dispatched via event bus on change. Payload: { value: number | string } */
+    changeEvent?: EventEmit<{
+        value: number | string;
+    }>;
     /** Disabled state */
     disabled?: boolean;
     /** Size variant */

package/dist/components/molecules/MatrixQuestion.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import type { EventEmit } from '@almadar/core';
 export interface MatrixRow {
     id: string;
     label: string;
@@ -18,6 +19,11 @@ export interface MatrixQuestionProps {
     values?: Record<string, number | string>;
     /** Change handler invoked with rowId and selected column value */
     onChange?: (rowId: string, value: number | string) => void;
+    /** Event name dispatched via event bus when a row's value changes. Payload: { rowId, value } */
+    changeEvent?: EventEmit<{
+        rowId: string;
+        value: number | string;
+    }>;
     /** Disable all inputs */
     disabled?: boolean;
     /** Visual size */

package/dist/components/molecules/OptionConstraintGroup.d.ts

@@ -9,6 +9,7 @@
  * **Atomic Design**: Composed using Typography atom and native form controls.
  */
 import React from 'react';
+import type { EventEmit } from '@almadar/core';
 export interface OptionConstraintOption {
     id: string;
     label: string;
@@ -32,6 +33,9 @@ export interface OptionConstraintGroupProps {
     constraint: OptionConstraint;
     selected?: string[];
     onChange?: (selected: string[]) => void;
+    changeEvent?: EventEmit<{
+        selected: string[];
+    }>;
     size?: 'sm' | 'md';
     className?: string;
 }

package/dist/components/molecules/PositionedCanvas.d.ts

@@ -1,5 +1,5 @@
 import React from "react";
-import type { EventPayloadValue } from "@almadar/core";
+import type { EventEmit, EventPayloadValue } from "@almadar/core";
 export type CanvasItemStatus = 'empty' | 'seated' | 'ordered' | 'awaiting-bill' | 'cleaning';
 export type CanvasItemShape = 'round' | 'rectangle' | 'square';
 export interface CanvasItem {
@@ -27,6 +27,14 @@ export interface PositionedCanvasProps {
     editable?: boolean;
     onSelect?: (id: string | null) => void;
     onMove?: (id: string, x: number, y: number) => void;
+    selectEvent?: EventEmit<{
+        id: string | null;
+    }>;
+    moveEvent?: EventEmit<{
+        id: string;
+        x: number;
+        y: number;
+    }>;
     className?: string;
 }
 export declare const PositionedCanvas: React.FC<PositionedCanvasProps>;

package/dist/components/molecules/QrScanner.d.ts

@@ -1,11 +1,18 @@
 import React from "react";
-export interface QrScanResult {
+import type { EventEmit, EventPayload } from "@almadar/core";
+/**
+ * QR scan callback payload. Extends `EventPayload` (string-indexed
+ * `EventPayloadValue` map) so the result is directly assignable to a
+ * render-ui dispatched event payload without re-shaping.
+ */
+export interface QrScanResult extends EventPayload {
     text: string;
     format: string;
     timestamp: number;
 }
 export interface QrScannerProps {
     onScan?: (result: QrScanResult) => void;
+    scanEvent?: EventEmit<QrScanResult>;
     onError?: (error: Error) => void;
     facingMode?: 'environment' | 'user';
     paused?: boolean;

package/dist/components/molecules/ReplyTree.d.ts

@@ -5,6 +5,8 @@
  * Composes the VoteStack molecule + Avatar/Typography/Button atoms.
  */
 import React from "react";
+import type { EventEmit } from "@almadar/core";
+import { type VoteValue } from "../molecules/VoteStack";
 export interface ReplyNode {
     id: string;
     authorName: string;
@@ -12,17 +14,30 @@ export interface ReplyNode {
     content: string;
     postedAt: string;
     voteCount?: number;
-    userVote?: 'up' | 'down' | null;
+    userVote?: VoteValue;
     replies?: ReplyNode[];
     collapsed?: boolean;
 }
 export interface ReplyTreeProps {
     nodes: ReplyNode[];
     maxDepth?: number;
-    onVote?: (nodeId: string, vote: 'up' | 'down' | null) => void;
+    onVote?: (nodeId: string, vote: VoteValue) => void;
     onReply?: (parentNodeId: string) => void;
     onFlag?: (nodeId: string) => void;
     onContinueThread?: (nodeId: string) => void;
+    voteEvent?: EventEmit<{
+        nodeId: string;
+        vote: VoteValue;
+    }>;
+    replyEvent?: EventEmit<{
+        parentNodeId: string;
+    }>;
+    flagEvent?: EventEmit<{
+        nodeId: string;
+    }>;
+    continueThreadEvent?: EventEmit<{
+        nodeId: string;
+    }>;
     showActions?: boolean;
     className?: string;
 }

package/dist/components/molecules/RichBlockEditor.d.ts

@@ -8,6 +8,7 @@
  * scope for the Phase 10 scaffold.
  */
 import React from "react";
+import type { EventEmit, EventPayloadValue } from '@almadar/core';
 export type BlockType = "paragraph" | "heading-1" | "heading-2" | "heading-3" | "bullet-list" | "numbered-list" | "quote" | "code" | "divider" | "image";
 export interface RichBlock {
     id: string;
@@ -15,10 +16,14 @@ export interface RichBlock {
     content?: string;
     metadata?: Record<string, string | number | boolean>;
     children?: RichBlock[];
+    [key: string]: EventPayloadValue;
 }
 export interface RichBlockEditorProps {
     initialBlocks?: RichBlock[];
     onChange?: (blocks: RichBlock[]) => void;
+    changeEvent?: EventEmit<{
+        blocks: RichBlock[];
+    }>;
     readOnly?: boolean;
     placeholder?: string;
     showToolbar?: boolean;

package/dist/components/molecules/VersionDiff.d.ts

@@ -6,6 +6,7 @@
  * LCS-based line diff inline (no external diff library).
  */
 import React from "react";
+import type { EventPayloadValue, EventEmit } from "@almadar/core";
 export interface DiffRevision {
     id: string;
     label: string;
@@ -22,8 +23,13 @@ export interface DiffLine {
 }
 export type VersionDiffView = "side-by-side" | "inline";
 export interface VersionDiffProps {
-    /** All available revisions (at least 2). */
-    revisions: DiffRevision[];
+    /**
+     * All available revisions (at least 2). Accepts either a typed array (direct
+     * consumers) or the runtime payload shape from a render-ui binding
+     * (`@payload.revisions`). Narrowed to `[]` internally when the value isn't
+     * an array.
+     */
+    revisions: readonly DiffRevision[] | EventPayloadValue;
     /** Currently selected "before" revision id. */
     beforeId?: string;
     /** Currently selected "after" revision id. */
@@ -36,6 +42,18 @@ export interface VersionDiffProps {
     onSelectAfter?: (id: string) => void;
     /** Called when the user clicks the revert button (passes the "before" id). */
     onRevert?: (id: string) => void;
+    /** Event name dispatched via event bus when the "before" revision changes. Payload: { id }. */
+    selectBeforeEvent?: EventEmit<{
+        id: string;
+    }>;
+    /** Event name dispatched via event bus when the "after" revision changes. Payload: { id }. */
+    selectAfterEvent?: EventEmit<{
+        id: string;
+    }>;
+    /** Event name dispatched via event bus when the user clicks revert. Payload: { id }. */
+    revertEvent?: EventEmit<{
+        id: string;
+    }>;
     /** Language label (informational). */
     language?: string;
     /** Additional CSS classes. */

package/dist/components/molecules/VoteStack.d.ts

@@ -1,7 +1,15 @@
 import React from "react";
+import type { EventEmit } from "@almadar/core";
 export type VoteStackSize = "sm" | "md" | "lg";
 export type VoteStackVariant = "vertical" | "horizontal";
-export type VoteValue = "up" | "down" | null;
+/**
+ * Current vote state. Both `null` (typical "cleared" sentinel for direct
+ * consumers) and the string `"none"` (the .lolo enum spelling — `direction:
+ * "up" | "down" | "none"`) are accepted; the component treats them
+ * identically. Keeping both accommodates render-ui bindings without forcing
+ * std atoms to drop their string sentinel.
+ */
+export type VoteValue = "up" | "down" | "none" | null;
 export interface VoteStackProps {
     /** Current tally */
     count: number;
@@ -9,6 +17,10 @@ export interface VoteStackProps {
     userVote?: VoteValue;
     /** Toggle handler. Clicking the same arrow clears (emits null). */
     onVote?: (next: VoteValue) => void;
+    /** Event name dispatched on the bus when a vote is cast. Payload: { next: VoteValue }. */
+    voteEvent?: EventEmit<{
+        next: VoteValue;
+    }>;
     /** Disabled state */
     disabled?: boolean;
     /** Size variant */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.36.0",
+  "version": "4.38.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [