@dataverse-kit/form-runtime 0.1.0

package/dist/v8.d.cts

@@ -0,0 +1,730 @@
+import { x as ControlDefinition, z as ControlType, al as SubgridColumn, aq as TextFormat } from './control-DFOg_pc_.cjs';
+import React from 'react';
+import { k as GridColumnDefinition, m as GridCustomizerDefinition, w as NestedSidePanelSize, N as NestedDisplayConfig, f as FocusedViewConfig } from './gridCustomizer-mJO-kmQ4.cjs';
+import { F as FormRuntimeCapabilities } from './runtime-capabilities-BdGDdu0d.cjs';
+import './theme-BfeZIxmZ.cjs';
+
+/**
+ * Common props every per-type control file accepts.
+ *
+ * The dispatcher (Phase 1 Task 7's `<FormRuntime>`) resolves a control's
+ * value once — pulling from the controlled prop, the bound record, or
+ * mock data — and hands the per-type component an `effectiveValue` /
+ * `displayValue` pair. Per-type files stay focused on rendering the
+ * field shell; label positioning, full-width wrapping, and dispatch all
+ * live in the wrapper.
+ *
+ * `interactive` replaces the form-builder editor's `designMode` boolean.
+ * When `false` the field is disabled and ignores input — the previous
+ * editor convention of `(designMode && !isInteractive)` collapses to a
+ * single explicit flag here, matching what a generated host (or the
+ * runtime.html entry) would pass.
+ */
+interface ControlPartProps {
+    control: ControlDefinition;
+    /**
+     * Resolved value (controlled value wins; falls back to record-bound
+     * value; falls back to `undefined`). The dispatcher computes this so
+     * per-type files don't each repeat the precedence rule.
+     */
+    effectiveValue: unknown;
+    /** `String(effectiveValue ?? '')` — pre-computed for convenience. */
+    displayValue: string;
+    /** `true` when either `effectiveValue` was supplied or a record bound a value. */
+    hasValue: boolean;
+    /** `true` when the caller passed an explicit controlled value (vs. record-bound only). */
+    hasControlledValue: boolean;
+    /** When `false`, the field is disabled and ignores input. */
+    interactive: boolean;
+    /** Bubble user edits up to the caller. Per-type files normalize the FluentUI event signature. */
+    onChange?: (next: unknown) => void;
+    /** Forwarded from the dispatcher for components that emit click-handled UI (buttons, links). */
+    onButtonClick?: (action: unknown) => void;
+}
+/** Convenience helper: derive the v8 `disabled` flag from `interactive` + read-only. */
+declare function isDisabled(control: ControlDefinition, interactive: boolean): boolean;
+
+/**
+ * `spacer` control — empty vertical gap.
+ *
+ * Lifted from ControlRenderer.tsx case 'spacer'. The editor used
+ * `designMode` to draw a dashed outline that hints at the gap; the
+ * runtime keeps that affordance behind the dispatcher-owned
+ * `interactive=false` flag (design time → outline; live → transparent).
+ */
+declare const SpacerControl: React.FC<ControlPartProps>;
+
+declare const LabelControl: React.FC<ControlPartProps>;
+
+/**
+ * `formlink` control — a link/button that opens another form or URL.
+ *
+ * Lifted from ControlRenderer.tsx case 'formlink'. Navigation modes
+ * (projectForm vs recordUrl) live on `control.properties`; the runtime
+ * stays neutral on the navigation handler — the dispatcher can supply
+ * an `onButtonClick(action)` callback to intercept project-form clicks
+ * via the editor's navigation store.
+ */
+declare const FormLinkControl: React.FC<ControlPartProps>;
+
+declare const UnknownControl: React.FC<ControlPartProps>;
+
+/**
+ * `text` control — single-line text field with optional format
+ * (text/email/url/phone/password). Renders via `TextFieldWithFormat`
+ * which carries the action-button + password-toggle plumbing.
+ *
+ * Lifted from ControlRenderer.tsx case 'text'.
+ */
+declare const TextControl: React.FC<ControlPartProps>;
+
+/**
+ * `textarea` control — multi-line text field.
+ *
+ * Lifted from ControlRenderer.tsx line 1567 (case 'textarea'). The
+ * editor's branching on `designMode` collapses to the dispatcher-owned
+ * `interactive` prop; everything else is byte-identical.
+ *
+ * No store reads, no editor-specific sub-components — this is the
+ * cleanest of the 22 switch branches and serves as the proof-of-pattern
+ * for the rest. Follow-on extractions (text, number, date, dropdown, ...)
+ * share the same `ControlPartProps` shape and the same dispatcher hand-off.
+ */
+declare const TextareaControl: React.FC<ControlPartProps>;
+
+/**
+ * `number` / `decimal` / `currency` controls — share a SpinButton
+ * renderer with a per-type step (1 for integer `number`, 0.01 for
+ * decimal/currency).
+ *
+ * Lifted from ControlRenderer.tsx cases 'number'/'decimal'/'currency'.
+ */
+declare const NumberControl: React.FC<ControlPartProps>;
+
+/**
+ * `date` / `datetime` controls — Fluent UI DatePicker bound to a
+ * parsed Date value.
+ *
+ * Lifted from ControlRenderer.tsx cases 'date'/'datetime'.
+ */
+declare const DateControl: React.FC<ControlPartProps>;
+
+/**
+ * `checkbox` control. The dispatcher swaps the label position when
+ * `properties.boxSide === 'start'`; this leaf renders the box only.
+ *
+ * Lifted from ControlRenderer.tsx case 'checkbox'.
+ */
+declare const CheckboxControl: React.FC<ControlPartProps>;
+
+/**
+ * `toggle` control — Fluent UI v8 Toggle with configurable on/off labels.
+ *
+ * Lifted from ControlRenderer.tsx case 'toggle'.
+ */
+declare const ToggleControl: React.FC<ControlPartProps>;
+
+/**
+ * `slider` control — Fluent UI v8 Slider.
+ *
+ * Lifted from ControlRenderer.tsx case 'slider'. The legacy editor
+ * branch didn't wire `value` / `onChange` (designer-only preview), but
+ * the dispatcher now passes them through so generated runtimes get a
+ * controlled slider.
+ */
+declare const SliderControl: React.FC<ControlPartProps>;
+
+/**
+ * `rating` control — Fluent UI Rating (stars) or `EmojiRating`
+ * (icon-based).
+ *
+ * Lifted from ControlRenderer.tsx case 'rating'.
+ */
+declare const RatingControl: React.FC<ControlPartProps>;
+
+/**
+ * `spinbutton` control — Fluent UI SpinButton with min/max/step/precision.
+ *
+ * Lifted from ControlRenderer.tsx case 'spinbutton'.
+ */
+declare const SpinButtonControl: React.FC<ControlPartProps>;
+
+declare const DropdownControl: React.FC<ControlPartProps>;
+
+declare const ComboBoxControl: React.FC<ControlPartProps>;
+
+/**
+ * `choicegroup` control — radio-button group that supports custom or
+ * attribute-bound option-set sources. Layout (vertical/horizontal/
+ * icon-cards/image-cards) is forwarded to the runtime
+ * `ChoiceGroupControl` sub-component.
+ *
+ * Lifted from ControlRenderer.tsx case 'choicegroup'.
+ */
+declare const ChoiceGroupBranch: React.FC<ControlPartProps>;
+
+/**
+ * `lookup` control — dispatcher branch that wires the editor-controlled
+ * value/disabled/onChange triplet into the runtime `LookupControl`
+ * sub-component. Sub-component handles `searchLookup` + persona avatars
+ * itself via the runtime context.
+ *
+ * Lifted from ControlRenderer.tsx case 'lookup'.
+ */
+declare const LookupBranch: React.FC<ControlPartProps>;
+
+/**
+ * `webresource` control — dispatcher branch. The renderer pulls its own
+ * `connection`, `previewContext`, and `fetchWebResource` from the runtime
+ * context; there's nothing per-control to plumb. `interactive` is
+ * carried so the dispatcher can pass `designMode` for parity, even
+ * though the current renderer ignores it.
+ *
+ * Lifted from ControlRenderer.tsx case 'webresource'.
+ */
+declare const WebResourceBranch: React.FC<ControlPartProps>;
+
+/**
+ * Phase 1b — designer/preview placeholder for chart-category controls.
+ *
+ * Moved from apps/form-builder/src/components/form-designer/canvas/
+ * ChartRenderer.tsx in Phase 6.5b. The form-builder original is now a
+ * thin adapter that injects the `entry` prop from `controlMetadata` (the
+ * registry hasn't moved to form-runtime yet — pending follow-up).
+ *
+ * The form-builder designer is locked to Fluent UI v8 (per CLAUDE.md);
+ * real chart rendering belongs to the generated output. At authoring
+ * time we show a labelled card with the chart icon, title, and a short
+ * data-source summary so users can confirm the tile is configured
+ * correctly without us pulling in the full v8 chart library as a
+ * designer dependency.
+ *
+ * v9-only charts (funnel, scatter) carry an additional badge so the user
+ * understands they will only render in v9-export targets.
+ */
+
+/**
+ * Minimal subset of `ControlRegistryEntry` that ChartRenderer reads.
+ * Decoupled here so form-runtime doesn't depend on the form-builder's
+ * `controlMetadata` registry. The caller (designer or runtime
+ * dispatcher) resolves the full entry from its own metadata source and
+ * passes the slice down.
+ */
+interface ChartRendererEntry {
+    /** Display label shown in the card body and the aria-label fallback. */
+    label?: string;
+    /** v8 Fluent icon name (e.g. 'BarChartVertical'). */
+    icon?: string;
+    /** Marks the v9-only badge when true. */
+    requiresV9?: boolean;
+}
+interface ChartRendererProps {
+    control: ControlDefinition;
+    /**
+     * Optional lookup of data source id → display label. Caller (canvas or
+     * preview) reads from `form.settings.dataSources`. We don't import the
+     * form here to keep this component pure + testable.
+     */
+    dataSourceLabelById?: Record<string, string>;
+    /**
+     * Optional registry slice for the control's type (icon, label,
+     * v9-required flag). When omitted, ChartRenderer renders with
+     * defaults — defaults match the form-builder editor's behavior when
+     * `getControlEntry` returns undefined.
+     */
+    entry?: ChartRendererEntry;
+}
+declare const ChartRenderer: React.FC<ChartRendererProps>;
+/** Test whether a control type belongs to the chart category. */
+declare function isChartControlType(type: ControlType | string): boolean;
+
+/**
+ * Chart-category controls — `barchart`, `linechart`, `areachart`,
+ * `piechart`, `donutchart`, `horizontalbarchart`, `gaugechart`,
+ * `sparkline`, `heatmapchart`, `kpicard`, `funnelchart`, `scatterchart`.
+ *
+ * The dispatcher routes all 12 chart types here. `dataSourceLabelById`
+ * and the registry-derived `entry` (icon/label/v9-required flag) flow
+ * in via optional editor-supplied props; the runtime renders sensible
+ * defaults when either is missing.
+ *
+ * Lifted from ControlRenderer.tsx cases 'barchart'…'scatterchart'.
+ */
+interface ChartBranchProps extends ControlPartProps {
+    /**
+     * Optional editor-supplied lookup of data source id → display label.
+     * The canvas / preview reads from `form.settings.dataSources`.
+     */
+    dataSourceLabelById?: Record<string, string>;
+    /**
+     * Optional editor-supplied registry slice (icon, label, requiresV9)
+     * for this chart type. Forwarded as-is to `ChartRenderer`.
+     */
+    entry?: ChartRendererEntry;
+}
+declare const ChartBranch: React.FC<ChartBranchProps>;
+
+declare const PersonaControl: React.FC<ControlPartProps>;
+
+/**
+ * `button` control — variants: default, primary (legacy), compound,
+ * icon, action, command (CommandBar), split (with menu), toggle.
+ *
+ * Lifted from ControlRenderer.tsx case 'button'. Each sub-variant
+ * preserves its specific Fluent UI rendering. `onButtonClick(action)`
+ * routes click events to the dispatcher's action handler — when
+ * omitted (preview/no-op), clicks are inert. In design mode
+ * (`!interactive`) the button is force-disabled and a small variant
+ * badge renders in the top-right corner.
+ */
+declare const ButtonControl: React.FC<ControlPartProps>;
+
+/**
+ * `subgrid` control — standard mode renderer. The editor's branch
+ * additionally handles focused-view layouts, card-list views,
+ * grid-customizer integration, and mock-data fallbacks; those stay
+ * inline in `ControlRenderer.tsx` and migrate in a follow-up — the
+ * runtime focus here is the deployed-runtime path: a Fluent v8
+ * `DetailsList` rendered from records fetched via `fetchLiveData`.
+ *
+ * Lifted (partial) from ControlRenderer.tsx case 'subgrid'.
+ */
+interface SubgridBranchProps extends ControlPartProps {
+    /**
+     * Optional pre-fetched records. When omitted, the runtime calls
+     * `useLiveData(control)` to source records from the surrounding
+     * `FormRuntimeContext`. The editor passes mock data via this prop
+     * during designer-time rendering.
+     */
+    records?: Record<string, unknown>[];
+    /**
+     * Optional column override. Falls back to
+     * `control.properties.columns` (the legacy inline definition).
+     */
+    columns?: SubgridColumn[];
+}
+declare const SubgridBranch: React.FC<SubgridBranchProps>;
+
+declare const TimelineControl: React.FC<ControlPartProps>;
+
+/**
+ * Enhanced TextField with format-specific features (email/url/phone/password).
+ *
+ * Moved from apps/form-builder/src/components/form-designer/canvas/
+ * TextFieldWithFormat.tsx in Phase 6.5b. The form-builder original is
+ * now a re-export shim. Per `feedback_v1_migrations`, this lives in the
+ * runtime so the form-builder's canvas path, the runtime's `text` control
+ * branch (extracted in 6.5f), and generated host code all consume the
+ * same implementation.
+ */
+
+interface TextFieldWithFormatProps {
+    /** Text format type */
+    textFormat: TextFormat;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Whether the field is disabled */
+    disabled?: boolean;
+    /** Current value */
+    value?: string;
+    /** Max character length */
+    maxLength?: number;
+    /** Change handler */
+    onChange?: (event: React.FormEvent<HTMLInputElement | HTMLTextAreaElement>, newValue?: string) => void;
+    /** Show action button for email/url/phone */
+    showActionButton?: boolean;
+    /** Allow password visibility toggle */
+    allowPasswordToggle?: boolean;
+    /** Icon name to show as prefix */
+    iconName?: string;
+}
+declare const TextFieldWithFormat: React.FC<TextFieldWithFormatProps>;
+
+/**
+ * EmojiRating — sentiment-style rating using emoji icons.
+ *
+ * Extracted from the inline `EmojiRating` in
+ * apps/form-builder/src/components/form-designer/canvas/ControlRenderer.tsx
+ * in Phase 6.5b. The rating-control branch (extracted in 6.5f) will
+ * delegate to this implementation; the form-builder ControlRenderer
+ * imports it from here in the meantime.
+ *
+ * Stateless except for local hover/selection — no store reads, no
+ * editor-specific behavior. Safe to render in any host.
+ */
+
+interface EmojiRatingProps {
+    /** Number of emoji buckets (2–5). Values outside the range clamp. */
+    max: number;
+    /** Icon size (small/medium/large). */
+    size: string;
+    /** When true, emoji uses the per-bucket sentiment color (red→green). */
+    useColor: boolean;
+    /** Override color for ALL buckets (takes precedence over the sentiment palette). */
+    customEmojiColor: string;
+    /** When true, the rating ignores clicks and renders muted. */
+    disabled: boolean;
+}
+declare const EmojiRating: React.FC<EmojiRatingProps>;
+
+/**
+ * ChoiceGroupControl — three-layout radio group (standard / icon-cards /
+ * image-cards) with optional per-option colors and labels.
+ *
+ * Extracted from the inline `ChoiceGroupControl` in
+ * apps/form-builder/src/components/form-designer/canvas/ControlRenderer.tsx
+ * in Phase 6.5b. The `choicegroup` control branch (extracted in 6.5f)
+ * delegates to this implementation.
+ *
+ * Pure: no store reads, no editor-specific behavior. Safe in any host.
+ */
+
+interface ChoiceGroupControlProps {
+    options: Array<{
+        key: number;
+        text: string;
+        color?: string;
+        icon?: string;
+        imageSrc?: string;
+    }>;
+    showColors: boolean;
+    showLabels: boolean;
+    layout: string;
+    disabled: boolean;
+    initialSelectedKey?: string;
+    onChange?: (value: string | number | boolean | Date | null) => void;
+}
+declare const ChoiceGroupControl: React.FC<ChoiceGroupControlProps>;
+
+/**
+ * Grid Cell Renderers
+ *
+ * Shared cell renderer functions for grid customizer preview.
+ * Used by GridPreview (grid customizer mode) and ControlRenderer (form canvas subgrids).
+ * All renderers use Fluent UI v8.
+ *
+ * Moved from apps/form-builder/src/utils/gridCellRenderers.tsx in Phase 6.5c.
+ * The form-builder file is now a thin re-export shim.
+ */
+
+/**
+ * Render a cell value using the grid customizer column definition's renderer type and config.
+ * @param rowData Optional full row data — used by composite renderer for cross-field slot bindings.
+ */
+declare function renderGridCell(value: unknown, colDef: GridColumnDefinition, rowData?: Record<string, unknown>): React.ReactNode;
+/**
+ * Signature for a function that generates mock grid rows from a set of
+ * grid columns. The runtime components don't compute mock data themselves
+ * — callers in the editor inject this so the runtime stays free of any
+ * editor-only dependencies (e.g. `@dataverse-kit/export-engine`). When
+ * the prop is omitted, the runtime renders zero rows.
+ */
+type GridMockDataGenerator = (columns: GridColumnDefinition[], rowCount: number) => Record<string, unknown>[];
+
+/**
+ * NestedRecordsSidePanel
+ *
+ * Side-panel host for a nested grid's child records. Used when a parent grid's
+ * `nestedDisplay.mode` is `'side-panel'` — the parent surface (focused-view
+ * detail pane, card-list card, or any explicit "View related" trigger) opens
+ * this panel with the selected parent row's children.
+ *
+ * Renders the child grid as a Fluent UI v8 DetailsList using mock data sized
+ * to the configured page. The export generators emit a near-identical Panel
+ * + DetailsList runtime so the designer preview matches the deployed UX.
+ *
+ * Moved from apps/form-builder/src/components/grid-customizer/preview/ in
+ * Phase 6.5c. The mock-data generator is injected via the optional
+ * `generateMockData` prop rather than imported from
+ * `@dataverse-kit/export-engine` — keeps the runtime independent of the
+ * editor-only export-engine package. When the prop is omitted (e.g. in a
+ * deployed runtime), the panel renders zero rows.
+ */
+
+interface NestedRecordsSidePanelProps {
+    /** Whether the panel is open. */
+    isOpen: boolean;
+    /** Close handler. */
+    onDismiss: () => void;
+    /** The child grid definition whose rows should render in the panel. */
+    childGridDef: GridCustomizerDefinition | null;
+    /**
+     * Display name of the parent row (e.g. "Acme Corp"). Surfaced in the panel
+     * header so the user knows which parent these children belong to.
+     */
+    parentLabel?: string;
+    /** Panel size. Defaults to 'medium'. */
+    panelSize?: NestedSidePanelSize;
+    /**
+     * Optional override for how many child rows to render. Falls back to the
+     * child grid's `pageSize` so the side-panel preview matches the embedded
+     * grid by default.
+     */
+    rowCount?: number;
+    /**
+     * Optional mock-data generator. When provided (typically by the editor's
+     * shim wrapper), the panel renders a mocked DetailsList for preview. When
+     * omitted, the panel renders zero rows.
+     */
+    generateMockData?: GridMockDataGenerator;
+}
+declare const NestedRecordsSidePanel: React.FC<NestedRecordsSidePanelProps>;
+
+/**
+ * NestedRecordsCallout
+ *
+ * Hover-triggered compact preview of a nested grid's child records. Used when
+ * a parent grid's `nestedDisplay.mode` is `'hover-callout'`. Pairs with
+ * `NestedRecordsSidePanel` — the callout footer escalates to the full panel.
+ *
+ * Pattern mirrors `GridCellCallout.tsx` (LookupPreviewCallout): hover delay,
+ * `Callout` with `DirectionalHint`, fixed width, light dismiss.
+ *
+ * Moved from apps/form-builder/src/components/grid-customizer/preview/ in
+ * Phase 6.5c. The mock-data generator is injected via the optional
+ * `generateMockData` prop rather than imported from
+ * `@dataverse-kit/export-engine`.
+ */
+
+interface NestedRecordsCalloutProps {
+    /** The child grid definition whose rows should preview. */
+    childGridDef: GridCustomizerDefinition | null;
+    /** Hover delay in ms before showing. Defaults to 300. */
+    hoverDelay?: number;
+    /** Max child rows to show. Defaults to 5. */
+    maxRows?: number;
+    /**
+     * Click escalation handler — when present, the callout footer renders a
+     * "View all N →" link that opens the full side panel.
+     */
+    onViewAll?: () => void;
+    /** The trigger element (badge / button / icon) that owns the hover surface. */
+    children: React.ReactElement;
+    /**
+     * Optional mock-data generator. When omitted, the callout shows the
+     * "No related records to preview." empty state.
+     */
+    generateMockData?: GridMockDataGenerator;
+}
+declare const NestedRecordsCallout: React.FC<NestedRecordsCalloutProps>;
+
+/**
+ * NestedRecordsTrigger
+ *
+ * Renders the "view related records" affordance for a parent row when the
+ * parent grid type can't show inline children (focused-view, card-list).
+ * Switches on `nestedDisplay.mode`:
+ *   - side-panel    → DefaultButton that toggles NestedRecordsSidePanel
+ *   - hover-callout → small badge wrapped in NestedRecordsCallout (with
+ *                     "View all" escalation that opens the side panel)
+ *   - detail-pane   → renders a compact inline child grid below the parent
+ *
+ * Designed to be dropped into a focused-view card or a card-list card without
+ * affecting layout — wraps itself in a div with margin-top so callers can stay
+ * unaware of the trigger's exact shape.
+ *
+ * Moved from apps/form-builder/src/components/grid-customizer/preview/ in
+ * Phase 6.5c. The mock-data generator is injected via the optional
+ * `generateMockData` prop rather than imported from
+ * `@dataverse-kit/export-engine`.
+ */
+
+interface NestedRecordsTriggerProps {
+    /** The child grid definition. */
+    childGridDef: GridCustomizerDefinition | null;
+    /** Display config from the parent grid. */
+    config: NestedDisplayConfig;
+    /** Parent record label surfaced in the side panel header. */
+    parentLabel?: string;
+    /**
+     * Number of related records to advertise in the trigger label and to render
+     * in mock previews. Falls back to the child grid's pageSize when unset.
+     */
+    childCount?: number;
+    /**
+     * When true, the component does not auto-mount any panel/callout — used by
+     * the focused-view mode that wants to control its own detail-pane container.
+     * Currently unused but reserved for future composition.
+     */
+    inlineOnly?: boolean;
+    /**
+     * Optional mock-data generator forwarded to the sub-components
+     * (NestedRecordsSidePanel, NestedRecordsCallout, NestedDetailPaneList).
+     * When omitted, all child surfaces render zero rows.
+     */
+    generateMockData?: GridMockDataGenerator;
+}
+declare const NestedRecordsTrigger: React.FC<NestedRecordsTriggerProps>;
+
+/**
+ * FocusedViewMasterDetailPreview
+ *
+ * Designer-side preview for `gridType: 'focused-view'` with a configured
+ * nested grid. Mirrors the runtime layout the form-code generator emits:
+ * left rail of persona cards (the focused list of parent records) + right
+ * pane that hosts the child grid for the currently selected parent.
+ *
+ * Replaces the "left rail + per-card View N related button" preview so
+ * what users see in the designer matches the export.
+ *
+ * Moved from apps/form-builder/src/components/grid-customizer/preview/ in
+ * Phase 6.5c. The mock-data generator is injected via the optional
+ * `generateMockData` prop rather than imported from
+ * `@dataverse-kit/export-engine`.
+ */
+
+interface FocusedCardRow {
+    primaryValue: string;
+    secondaryValue?: string;
+    iconName?: string;
+    isFirst: boolean;
+}
+interface FocusedCardData {
+    id: string;
+    rows: FocusedCardRow[];
+}
+interface FocusedViewMasterDetailPreviewProps {
+    /** Parent records rendered in the left rail. */
+    cards: FocusedCardData[];
+    /** Field configuration for the cards (used to resolve labels per row). */
+    focusedViewConfig: FocusedViewConfig;
+    /** Header text — typically the parent entity name. */
+    entityName: string;
+    /** Whether to render the "Related" pill next to the header. */
+    showRelatedRecords?: boolean;
+    /** Whether to hide the search box (controlled by the subgrid's `hideSearchBox`). */
+    hideSearchBox?: boolean;
+    /** Live-data loading state. */
+    liveLoading?: boolean;
+    /** The child grid configuration to render in the right pane. */
+    childGridDef: GridCustomizerDefinition;
+    /** Persona initials helper (matches existing focused-view rendering). */
+    getInitials: (name: string) => string;
+    /** Persona color helper (matches existing focused-view rendering). */
+    getPersonaColor: (name: string) => string;
+    /** Should the upcoming-activity row at the bottom of the rail render. */
+    showUpNextActivity?: boolean;
+    /**
+     * Optional mock-data generator. When provided (typically by the editor's
+     * shim wrapper), each card receives a stable mocked row set. When omitted,
+     * the right pane renders zero rows.
+     */
+    generateMockData?: GridMockDataGenerator;
+}
+declare const FocusedViewMasterDetailPreview: React.FC<FocusedViewMasterDetailPreviewProps>;
+
+/**
+ * LookupControl — Dynamics 365-style lookup field.
+ *
+ * Moved from apps/form-builder/src/components/form-designer/canvas/
+ * LookupControl.tsx in Phase 6.5d.
+ *
+ * Decoupled from form-builder's Zustand stores by consuming
+ * `FormRuntimeCapabilities.searchLookup` from the runtime context. The
+ * editor's `EditorFormRuntimeProvider` translates Dataverse client calls
+ * to this shape; generated host code will provide its own adapter.
+ *
+ * Entity-specific knowledge (primary name attribute, secondary text
+ * field, person-entity set, entity icons) stays in this file — it's
+ * static data, not editor-specific.
+ *
+ * Avatar fetching (entityimage endpoint) and entity-set-name resolution
+ * sit outside the FormRuntimeCapabilities surface and are accepted as
+ * optional injected props. The editor shim wires both via the Dataverse
+ * client + metadata cache; deployed runtime callers may omit them.
+ *
+ * Features:
+ * - Search icon on the right that triggers search on click
+ * - Selected value shows persona icon, linked text, and X to clear
+ * - Type-to-search with debouncing
+ * - Dropdown with "+ New" and "Advanced" options
+ * - Respects lookupViewId and lookupFetchXml configuration
+ */
+
+type LookupSearchCapability = FormRuntimeCapabilities['searchLookup'];
+interface LookupControlProps {
+    control: ControlDefinition;
+    disabled?: boolean;
+    value?: string;
+    onChange?: (value: string) => void;
+    /**
+     * Optional override for the runtime context's `searchLookup`. When
+     * omitted, the component reads from `useOptionalFormRuntimeContext()`.
+     * When neither path supplies it, the "not connected" fallback renders.
+     */
+    searchLookup?: LookupSearchCapability;
+    /**
+     * Optional override for the runtime context's connection state.
+     * Drives the "not connected" branch. When omitted, reads from
+     * `useOptionalFormRuntimeContext()`.
+     */
+    isConnectedOverride?: boolean;
+    /**
+     * Optional avatar fetcher used for person-entity lookups. When
+     * omitted, person personas render with initials only.
+     */
+    fetchEntityImage?: (recordId: string) => Promise<string | null>;
+    /**
+     * Optional entity logical name → plural set name resolver. Defaults
+     * to appending 's'. The editor adapter wires this to the metadata
+     * cache so virtual entities and irregular plurals resolve correctly.
+     */
+    resolveEntitySetName?: (entityLogicalName: string) => string;
+}
+declare function getPrimaryNameAttribute(entityLogicalName: string): string;
+declare function getInitials(name: string): string;
+declare function getEntityIcon(entityLogicalName: string): string;
+declare function isPersonEntity(entityLogicalName: string | null): boolean;
+declare function getSecondaryTextField(entityLogicalName: string): string | null;
+declare const LookupControl: React.FC<LookupControlProps>;
+declare const lookupEntityHelpers: {
+    getPrimaryNameAttribute: typeof getPrimaryNameAttribute;
+    getSecondaryTextField: typeof getSecondaryTextField;
+    isPersonEntity: typeof isPersonEntity;
+    getEntityIcon: typeof getEntityIcon;
+    getInitials: typeof getInitials;
+};
+
+/**
+ * WebResourceRenderer — preview surface for Dynamics web-resource controls.
+ *
+ * Moved from apps/form-builder/src/components/form-designer/canvas/
+ * ControlRenderer.tsx in Phase 6.5e. The component now reads
+ * `connection`, `previewContext`, and `fetchWebResource` from
+ * `useOptionalFormRuntimeContext()` so the editor's
+ * `useWebResourceContent` hook can be retired (Decision C in the Task
+ * 6.5 sub-plan).
+ *
+ * Behaviour preserved:
+ * - HTML web resources render via URL into a sandboxed iframe.
+ * - Image (PNG/JPG/GIF/ICO/SVG) and code (CSS/JS/XML/XSL/RESX) types
+ *   render the fetched content directly.
+ * - "Not connected" / "no resource configured" / "loading" / "error"
+ *   states map to the same placeholders the editor surfaced.
+ *
+ * The embedded-entity-browser special case (`/embedded/entity-browser/
+ * index.html` + WR_INIT postMessage) is editor-specific and stays in
+ * the form-builder shim — see
+ * `apps/form-builder/src/components/form-designer/canvas/
+ * WebResourceRenderer.tsx`. The runtime version is the same shape
+ * generated host code will eventually mount.
+ */
+
+interface WebResourceRendererProps {
+    control: ControlDefinition;
+    /**
+     * Designer / preview flag. Carried for parity with the legacy editor
+     * component — not currently used but reserved for future read-only
+     * overlays at design time.
+     */
+    designMode?: boolean;
+}
+declare const WebResourceRenderer: React.FC<WebResourceRendererProps>;
+
+/**
+ * Check if a web resource name matches embedded entity browser patterns.
+ * Matches `kh_/entitybrowser`, `kh_entitybrowser`, `entitybrowser`, etc.
+ */
+declare function isEmbeddedEntityBrowser(webResourceName: string): boolean;
+
+export { ButtonControl, ChartBranch, type ChartBranchProps, ChartRenderer, type ChartRendererEntry, type ChartRendererProps, CheckboxControl, ChoiceGroupBranch, ChoiceGroupControl, type ChoiceGroupControlProps, ComboBoxControl, type ControlPartProps, DateControl, DropdownControl, EmojiRating, type EmojiRatingProps, type FocusedCardData, type FocusedCardRow, FocusedViewMasterDetailPreview, type FocusedViewMasterDetailPreviewProps, FormLinkControl, type GridMockDataGenerator, LabelControl, LookupBranch, LookupControl, type LookupControlProps, type LookupSearchCapability, NestedRecordsCallout, type NestedRecordsCalloutProps, NestedRecordsSidePanel, type NestedRecordsSidePanelProps, NestedRecordsTrigger, type NestedRecordsTriggerProps, NumberControl, PersonaControl, RatingControl, SliderControl, SpacerControl, SpinButtonControl, SubgridBranch, type SubgridBranchProps, TextControl, TextFieldWithFormat, type TextFieldWithFormatProps, TextareaControl, TimelineControl, ToggleControl, UnknownControl, WebResourceBranch, WebResourceRenderer, type WebResourceRendererProps, isChartControlType, isDisabled, isEmbeddedEntityBrowser, lookupEntityHelpers, renderGridCell };