@almadar/ui 4.34.0 → 4.35.0

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

@@ -0,0 +1,23 @@
+import React from 'react';
+export interface BranchingQuestion {
+    id: string;
+    label: string;
+    optionValues?: string[];
+}
+export type BranchingOperator = 'equals' | 'not-equals' | 'contains' | 'in';
+export declare const END_OF_SURVEY = "end-of-survey";
+export interface BranchingRule {
+    id: string;
+    sourceQuestionId: string;
+    operator: BranchingOperator;
+    value: string | string[];
+    targetQuestionId: string | typeof END_OF_SURVEY;
+}
+export interface BranchingLogicBuilderProps {
+    questions: BranchingQuestion[];
+    rules: BranchingRule[];
+    onRulesChange?: (rules: BranchingRule[]) => void;
+    readOnly?: boolean;
+    className?: string;
+}
+export declare const BranchingLogicBuilder: React.FC<BranchingLogicBuilderProps>;

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

@@ -0,0 +1,29 @@
+import React from "react";
+export type LikertScaleSize = "sm" | "md" | "lg";
+export type LikertScaleVariant = "radios" | "buttons";
+export interface LikertOption {
+    /** Underlying value bound to the option */
+    value: number | string;
+    /** Visible label below (radios) or inside (buttons) the control */
+    label: string;
+}
+export interface LikertScaleProps {
+    /** Optional row prompt above the scale */
+    question?: string;
+    /** Scale points (defaults to a 5-point agree/disagree set) */
+    options?: LikertOption[];
+    /** Selected value (controlled) */
+    value?: number | string | null;
+    /** Change callback */
+    onChange?: (value: number | string) => void;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Size variant */
+    size?: LikertScaleSize;
+    /** Visual variant: classic radios or pill segmented buttons */
+    variant?: LikertScaleVariant;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare const DEFAULT_LIKERT_OPTIONS: LikertOption[];
+export declare const LikertScale: React.ForwardRefExoticComponent<LikertScaleProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -11,9 +11,31 @@ export interface MapMarkerData {
     /** Optional category for styling */
     category?: string;
 }
+export interface MapRouteWaypoint {
+    lat: number;
+    lng: number;
+}
+export interface MapRouteData {
+    /** Unique route identifier */
+    id: string | number;
+    /** Ordered waypoints rendered as a polyline */
+    waypoints: MapRouteWaypoint[];
+    /** Stroke color (CSS color). Defaults to a theme-aware accent. */
+    color?: string;
+    /** Stroke weight in pixels (default 4) */
+    weight?: number;
+    /** Stroke opacity 0..1 (default 0.8) */
+    opacity?: number;
+    /** Optional dashed pattern (e.g. "8 4") */
+    dashArray?: string;
+    /** Label shown in a popup at the midpoint */
+    label?: string;
+}
 export interface MapViewProps {
     /** Array of markers to display */
     markers?: MapMarkerData[];
+    /** Routes (polylines with optional popups) drawn over the tile layer */
+    routes?: MapRouteData[];
     /** Map center latitude */
     centerLat?: number;
     /** Map center longitude */

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

@@ -0,0 +1,29 @@
+import React from "react";
+export interface MatrixRow {
+    id: string;
+    label: string;
+}
+export interface MatrixColumn {
+    value: number | string;
+    label: string;
+}
+export interface MatrixQuestionProps {
+    /** Optional title rendered above the matrix */
+    title?: string;
+    /** Question rows */
+    rows: MatrixRow[];
+    /** Column definitions; defaults to 5-point Likert */
+    columns?: MatrixColumn[];
+    /** Selected value per row, keyed by rowId */
+    values?: Record<string, number | string>;
+    /** Change handler invoked with rowId and selected column value */
+    onChange?: (rowId: string, value: number | string) => void;
+    /** Disable all inputs */
+    disabled?: boolean;
+    /** Visual size */
+    size?: 'sm' | 'md';
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare const DEFAULT_MATRIX_COLUMNS: MatrixColumn[];
+export declare const MatrixQuestion: React.FC<MatrixQuestionProps>;

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

@@ -0,0 +1,38 @@
+/**
+ * OptionConstraintGroup Molecule Component
+ *
+ * Generic constrained option selector (radio for "single", checkbox for "multi") with required/optional/multi
+ * constraints. Renders radio inputs for `single` constraint and checkboxes for
+ * `multi`. Reports validation errors inline when the current selection
+ * violates the constraint.
+ *
+ * **Atomic Design**: Composed using Typography atom and native form controls.
+ */
+import React from 'react';
+export interface OptionConstraintOption {
+    id: string;
+    label: string;
+    priceDelta?: number;
+    disabled?: boolean;
+    outOfStock?: boolean;
+}
+export type OptionConstraint = {
+    type: 'single';
+    required?: boolean;
+} | {
+    type: 'multi';
+    min?: number;
+    max?: number;
+};
+export interface OptionConstraintGroupProps {
+    groupId: string;
+    title: string;
+    description?: string;
+    options: OptionConstraintOption[];
+    constraint: OptionConstraint;
+    selected?: string[];
+    onChange?: (selected: string[]) => void;
+    size?: 'sm' | 'md';
+    className?: string;
+}
+export declare const OptionConstraintGroup: React.FC<OptionConstraintGroupProps>;

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

@@ -0,0 +1,32 @@
+import React from "react";
+import type { EventPayloadValue } from "@almadar/core";
+export type CanvasItemStatus = 'empty' | 'seated' | 'ordered' | 'awaiting-bill' | 'cleaning';
+export type CanvasItemShape = 'round' | 'rectangle' | 'square';
+export interface CanvasItem {
+    id: string;
+    label: string;
+    x: number;
+    y: number;
+    shape?: CanvasItemShape;
+    capacity: number;
+    status?: CanvasItemStatus;
+    partySize?: number;
+    serverName?: string;
+}
+export interface PositionedCanvasProps {
+    /**
+     * Items to render. Accepts either a typed array (direct consumers) or the
+     * runtime payload shape from a render-ui binding (`@payload.data`). The
+     * molecule narrows non-array values to `[]` and validates element shape at
+     * render time via the `id` / `x` / `y` guards.
+     */
+    items: readonly CanvasItem[] | EventPayloadValue;
+    width?: number;
+    height?: number;
+    selectedId?: string | null;
+    editable?: boolean;
+    onSelect?: (id: string | null) => void;
+    onMove?: (id: string, x: number, y: number) => void;
+    className?: string;
+}
+export declare const PositionedCanvas: React.FC<PositionedCanvasProps>;

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

@@ -0,0 +1,17 @@
+import React from "react";
+export interface QrScanResult {
+    text: string;
+    format: string;
+    timestamp: number;
+}
+export interface QrScannerProps {
+    onScan?: (result: QrScanResult) => void;
+    onError?: (error: Error) => void;
+    facingMode?: 'environment' | 'user';
+    paused?: boolean;
+    showOverlay?: boolean;
+    showCameraControls?: boolean;
+    fallback?: React.ReactNode;
+    className?: string;
+}
+export declare const QrScanner: React.FC<QrScannerProps>;

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

@@ -0,0 +1,29 @@
+/**
+ * ReplyTree Organism Component
+ *
+ * Recursive nested-thread reply renderer with collapse, per-node mod actions, and vote.
+ * Composes the VoteStack molecule + Avatar/Typography/Button atoms.
+ */
+import React from "react";
+export interface ReplyNode {
+    id: string;
+    authorName: string;
+    authorAvatarUrl?: string;
+    content: string;
+    postedAt: string;
+    voteCount?: number;
+    userVote?: 'up' | 'down' | null;
+    replies?: ReplyNode[];
+    collapsed?: boolean;
+}
+export interface ReplyTreeProps {
+    nodes: ReplyNode[];
+    maxDepth?: number;
+    onVote?: (nodeId: string, vote: 'up' | 'down' | null) => void;
+    onReply?: (parentNodeId: string) => void;
+    onFlag?: (nodeId: string) => void;
+    onContinueThread?: (nodeId: string) => void;
+    showActions?: boolean;
+    className?: string;
+}
+export declare const ReplyTree: React.FC<ReplyTreeProps>;

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

@@ -0,0 +1,27 @@
+/**
+ * RichBlockEditor Organism Component
+ *
+ * Notion / Lexical-style block authoring editor. Internal state owns the
+ * block tree; contentEditable spans flow updates back through onInput.
+ *
+ * TODO(phase-11): collaboration / undo-redo / markdown export are out of
+ * scope for the Phase 10 scaffold.
+ */
+import React from "react";
+export type BlockType = "paragraph" | "heading-1" | "heading-2" | "heading-3" | "bullet-list" | "numbered-list" | "quote" | "code" | "divider" | "image";
+export interface RichBlock {
+    id: string;
+    type: BlockType;
+    content?: string;
+    metadata?: Record<string, string | number | boolean>;
+    children?: RichBlock[];
+}
+export interface RichBlockEditorProps {
+    initialBlocks?: RichBlock[];
+    onChange?: (blocks: RichBlock[]) => void;
+    readOnly?: boolean;
+    placeholder?: string;
+    showToolbar?: boolean;
+    className?: string;
+}
+export declare const RichBlockEditor: React.FC<RichBlockEditorProps>;

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

@@ -0,0 +1,44 @@
+/**
+ * VersionDiff Organism Component
+ *
+ * Side-by-side or inline diff render with line-level highlights and
+ * a revision picker. Composes atoms for layout. Computes a minimal
+ * LCS-based line diff inline (no external diff library).
+ */
+import React from "react";
+export interface DiffRevision {
+    id: string;
+    label: string;
+    author?: string;
+    timestamp?: string;
+    content: string;
+}
+export type DiffLineType = "added" | "removed" | "unchanged" | "context";
+export interface DiffLine {
+    type: DiffLineType;
+    beforeLineNumber?: number;
+    afterLineNumber?: number;
+    content: string;
+}
+export type VersionDiffView = "side-by-side" | "inline";
+export interface VersionDiffProps {
+    /** All available revisions (at least 2). */
+    revisions: DiffRevision[];
+    /** Currently selected "before" revision id. */
+    beforeId?: string;
+    /** Currently selected "after" revision id. */
+    afterId?: string;
+    /** Display mode. */
+    view?: VersionDiffView;
+    /** Called when the user picks a different "before" revision. */
+    onSelectBefore?: (id: string) => void;
+    /** Called when the user picks a different "after" revision. */
+    onSelectAfter?: (id: string) => void;
+    /** Called when the user clicks the revert button (passes the "before" id). */
+    onRevert?: (id: string) => void;
+    /** Language label (informational). */
+    language?: string;
+    /** Additional CSS classes. */
+    className?: string;
+}
+export declare const VersionDiff: React.FC<VersionDiffProps>;

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

@@ -0,0 +1,23 @@
+import React from "react";
+export type VoteStackSize = "sm" | "md" | "lg";
+export type VoteStackVariant = "vertical" | "horizontal";
+export type VoteValue = "up" | "down" | null;
+export interface VoteStackProps {
+    /** Current tally */
+    count: number;
+    /** Current user's vote (null = no vote cast) */
+    userVote?: VoteValue;
+    /** Toggle handler. Clicking the same arrow clears (emits null). */
+    onVote?: (next: VoteValue) => void;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Size variant */
+    size?: VoteStackSize;
+    /** Layout orientation. `vertical` = forum/Q&A column; `horizontal` = compact row. */
+    variant?: VoteStackVariant;
+    /** Additional CSS classes */
+    className?: string;
+    /** Accessible label for the group */
+    label?: string;
+}
+export declare const VoteStack: React.FC<VoteStackProps>;

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

@@ -45,7 +45,7 @@ export { LineChart, type LineChartProps, type ChartDataPoint } from './LineChart
 export { ProgressDots, type ProgressDotsProps, type DotState, type DotSize } from './ProgressDots';
 export * from './game';
 export { GraphView, type GraphViewProps, type GraphViewNode, type GraphViewEdge } from './GraphView';
-export { MapView, type MapViewProps, type MapMarkerData } from './MapView';
+export { MapView, type MapViewProps, type MapMarkerData, type MapRouteData, type MapRouteWaypoint } from './MapView';
 export { NumberStepper, type NumberStepperProps, type NumberStepperSize } from './NumberStepper';
 export { StarRating, type StarRatingProps, type StarRatingSize, type StarRatingPrecision } from './StarRating';
 export { UploadDropZone, type UploadDropZoneProps } from './UploadDropZone';
@@ -79,3 +79,13 @@ export { TeamCard, type TeamCardProps } from './TeamCard';
 export { ShowcaseCard, type ShowcaseCardProps } from './ShowcaseCard';
 export { GeometricPattern, type GeometricPatternProps } from './GeometricPattern';
 export { EdgeDecoration, type EdgeDecorationProps, type EdgeVariant, type EdgeSide } from './EdgeDecoration';
+export { VoteStack, type VoteStackProps } from './VoteStack';
+export { LikertScale, type LikertScaleProps, type LikertOption, DEFAULT_LIKERT_OPTIONS } from './LikertScale';
+export { MatrixQuestion, type MatrixQuestionProps, type MatrixRow, type MatrixColumn, DEFAULT_MATRIX_COLUMNS } from './MatrixQuestion';
+export { QrScanner, type QrScannerProps, type QrScanResult } from './QrScanner';
+export { OptionConstraintGroup, type OptionConstraintGroupProps, type OptionConstraintOption, type OptionConstraint } from './OptionConstraintGroup';
+export { PositionedCanvas, type PositionedCanvasProps, type CanvasItem, type CanvasItemStatus, type CanvasItemShape } from './PositionedCanvas';
+export { RichBlockEditor, type RichBlockEditorProps, type RichBlock, type BlockType } from './RichBlockEditor';
+export { ReplyTree, type ReplyTreeProps, type ReplyNode } from './ReplyTree';
+export { BranchingLogicBuilder, type BranchingLogicBuilderProps, type BranchingQuestion, type BranchingRule } from './BranchingLogicBuilder';
+export { VersionDiff, type VersionDiffProps, type DiffRevision, type DiffLine as VersionDiffLine, type DiffLineType } from './VersionDiff';

package/dist/components/templates/DashboardLayout.d.ts

@@ -88,6 +88,13 @@ export interface DashboardLayoutProps {
     /** Custom sidebar footer (optional). When omitted, the sidebar has
      *  no footer — apps that need Settings/etc. add them via navItems. */
     sidebarFooter?: React.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
+     *  studio preview passes the in-frame `?page=` value so highlighting
+     *  works inside the embedded playground where `pathname` would be
+     *  the studio route. */
+    currentPath?: string;
     /** Callback when user clicks sign out (optional - uses auth context signOut if not provided) */
     onSignOut?: () => void;
     /** Page content rendered inside the main area */

package/dist/context/CurrentPagePathContext.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+declare const CurrentPagePathContext: React.Context<string | undefined>;
+export interface CurrentPagePathProviderProps {
+    value: string | undefined;
+    children: React.ReactNode;
+}
+export declare const CurrentPagePathProvider: React.FC<CurrentPagePathProviderProps>;
+export declare const useCurrentPagePath: () => string | undefined;
+export { CurrentPagePathContext };

package/dist/context/index.cjs

@@ -675,6 +675,13 @@ function useDesignTheme() {
     availableThemes: availableThemes.map((t) => t.name)
   };
 }
+var CurrentPagePathContext = react.createContext(void 0);
+var CurrentPagePathProvider = ({
+  value,
+  children
+}) => /* @__PURE__ */ jsxRuntime.jsx(CurrentPagePathContext.Provider, { value, children });
+CurrentPagePathProvider.displayName = "CurrentPagePathProvider";
+var useCurrentPagePath = () => react.useContext(CurrentPagePathContext);
 var ANONYMOUS_USER = {
   id: "anonymous",
   role: "anonymous",
@@ -776,6 +783,8 @@ function useUserForEvaluation() {
 
 exports.ANONYMOUS_USER = ANONYMOUS_USER;
 exports.BUILT_IN_THEMES = BUILT_IN_THEMES;
+exports.CurrentPagePathContext = CurrentPagePathContext;
+exports.CurrentPagePathProvider = CurrentPagePathProvider;
 exports.DesignThemeProvider = DesignThemeProvider;
 exports.ThemeContext = ThemeContext_default;
 exports.ThemeProvider = ThemeProvider;
@@ -783,6 +792,7 @@ exports.UISlotContext = UISlotContext;
 exports.UISlotProvider = UISlotProvider;
 exports.UserContext = UserContext;
 exports.UserProvider = UserProvider;
+exports.useCurrentPagePath = useCurrentPagePath;
 exports.useDesignTheme = useDesignTheme;
 exports.useHasPermission = useHasPermission;
 exports.useHasRole = useHasRole;

package/dist/context/index.d.ts

@@ -5,4 +5,5 @@ export { UISlotProvider, useUISlots, useSlotContent, useSlotHasContent, UISlotCo
 export { ThemeProvider, useTheme, BUILT_IN_THEMES, type ThemeDefinition, type ThemeProviderProps, type ColorMode, type ResolvedMode, type DesignTheme, } from "./ThemeContext";
 export { default as ThemeContext } from "./ThemeContext";
 export { DesignThemeProvider, useDesignTheme } from "./DesignThemeContext";
+export { CurrentPagePathProvider, CurrentPagePathContext, useCurrentPagePath, type CurrentPagePathProviderProps, } from "./CurrentPagePathContext";
 export { UserProvider, UserContext, useUser, useHasRole, useHasPermission, useUserForEvaluation, ANONYMOUS_USER, type UserData, type UserContextValue, type UserProviderProps, } from "./UserContext";

package/dist/context/index.js

@@ -673,6 +673,13 @@ function useDesignTheme() {
     availableThemes: availableThemes.map((t) => t.name)
   };
 }
+var CurrentPagePathContext = createContext(void 0);
+var CurrentPagePathProvider = ({
+  value,
+  children
+}) => /* @__PURE__ */ jsx(CurrentPagePathContext.Provider, { value, children });
+CurrentPagePathProvider.displayName = "CurrentPagePathProvider";
+var useCurrentPagePath = () => useContext(CurrentPagePathContext);
 var ANONYMOUS_USER = {
   id: "anonymous",
   role: "anonymous",
@@ -772,4 +779,4 @@ function useUserForEvaluation() {
   return isLoggedIn && user ? user : void 0;
 }
 
-export { ANONYMOUS_USER, BUILT_IN_THEMES, DesignThemeProvider, ThemeContext_default as ThemeContext, ThemeProvider, UISlotContext, UISlotProvider, UserContext, UserProvider, useDesignTheme, useHasPermission, useHasRole, useSlotContent, useSlotHasContent, useTheme, useUISlots, useUser, useUserForEvaluation };
+export { ANONYMOUS_USER, BUILT_IN_THEMES, CurrentPagePathContext, CurrentPagePathProvider, DesignThemeProvider, ThemeContext_default as ThemeContext, ThemeProvider, UISlotContext, UISlotProvider, UserContext, UserProvider, useCurrentPagePath, useDesignTheme, useHasPermission, useHasRole, useSlotContent, useSlotHasContent, useTheme, useUISlots, useUser, useUserForEvaluation };