@middag-io/react 0.2.1 → 0.3.1

package/dist-lib/contracts/block-data.d.ts

@@ -0,0 +1,399 @@
+/**
+ * Block data contracts — typed data shapes for all 8 ADR-807 standard blocks.
+ *
+ * Imported by block components for BlockProps<TData> type parameter.
+ * These mirror the JSON shapes sent from PHP controllers via Inertia.
+ *
+ * @see ADR-807 ref/page-contract-v1 §5
+ * @see NV-05-ux-blocks.md
+ */
+export interface DenseTableColumnDef {
+    key: string;
+    label: string;
+    sortable?: boolean;
+    searchable?: boolean;
+    variant?: "text" | "status" | "badge" | "boolean" | "timestamp" | "link" | "rich_status" | "html" | "link_group";
+    minWidth?: number;
+}
+export interface DenseTablePagination {
+    page: number;
+    perPage: number;
+    total: number;
+    lastPage: number;
+}
+export interface DenseTableSort {
+    column: string | null;
+    direction: "asc" | "desc" | null;
+}
+export interface DenseTableFilterDef {
+    key: string;
+    label: string;
+    type: "select" | "multiselect" | "date_range";
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+}
+export interface DenseTableRowAction {
+    id: string;
+    label: string;
+    icon: string;
+    intent?: "default" | "danger";
+    variant?: "icon" | "button";
+    href?: string;
+    method?: "get" | "post" | "delete";
+    requiresConfirmation?: boolean;
+    confirmationMessage?: string;
+    confirmation?: ActionConfirmation;
+    visible_when?: FormCondition;
+    disabled_when?: FormCondition;
+    loading_when?: FormCondition;
+    disabled_reason_field?: string;
+}
+export interface DenseTableBulkAction {
+    id: string;
+    label: string;
+    icon?: string;
+    intent?: "default" | "danger";
+    href: string;
+    method: "post" | "delete";
+    requiresConfirmation?: boolean;
+    confirmationMessage?: string;
+}
+export interface ActionConfirmation {
+    title: string;
+    message: string;
+    intent?: "danger" | "warning" | "default";
+    confirmLabel?: string;
+    cancelLabel?: string;
+    waitForPolling?: boolean;
+    waitingMessage?: string;
+}
+export interface RichStatusValue {
+    label: string;
+    appearance: "success" | "warning" | "danger" | "info" | "neutral";
+    icon?: string;
+}
+export interface LinkGroupItem {
+    icon: string;
+    href: string | null;
+    label: string;
+    external?: boolean;
+}
+export interface DenseTableBlockData {
+    columns: DenseTableColumnDef[];
+    rows: Record<string, unknown>[];
+    pagination: DenseTablePagination;
+    sort: DenseTableSort;
+    filters: {
+        available: DenseTableFilterDef[];
+        applied: Record<string, string | string[]>;
+    };
+    rowActions?: DenseTableRowAction[];
+    bulkActions?: DenseTableBulkAction[];
+    searchPlaceholder?: string;
+    emptyState?: {
+        icon?: string;
+        title?: string;
+        description?: string;
+        cta?: {
+            label: string;
+            href: string;
+        };
+    };
+}
+export interface MetricCardBlockData {
+    value: string | number;
+    delta?: string;
+    deltaDirection?: "positive" | "negative" | "neutral";
+    label: string;
+    icon?: string;
+    href?: string;
+    locale?: string;
+    compact?: boolean;
+}
+export type EmptyStateVariant = "first-use" | "no-results" | "error" | "permission";
+export interface EmptyStateBlockData {
+    variant?: EmptyStateVariant;
+    icon?: string;
+    description: string;
+    cta?: {
+        label: string;
+        href?: string;
+        method?: "get" | "post";
+    };
+    ctaSecondary?: {
+        label: string;
+        href: string;
+    };
+}
+export type StatusStripTone = "success" | "warning" | "danger" | "neutral";
+export type StatusItemAppearance = "success" | "warning" | "danger" | "info" | "neutral";
+export interface StatusStripItem {
+    key: string;
+    label: string;
+    value: string;
+    appearance: StatusItemAppearance;
+    tooltip?: string;
+    href?: string;
+}
+export interface StatusStripBlockData {
+    score?: number;
+    tone?: StatusStripTone;
+    items: StatusStripItem[];
+}
+export interface DetailPanelFieldDef {
+    key: string;
+    label: string;
+    value: string | number | boolean | null;
+    kind?: "text" | "status" | "timestamp" | "boolean" | "link" | "code" | "email";
+    copyable?: boolean;
+    href?: string;
+}
+export interface DetailPanelSectionDef {
+    id: string;
+    title: string;
+    fields: DetailPanelFieldDef[];
+    defaultCollapsed?: boolean;
+    actions?: Array<{
+        id: string;
+        label: string;
+        icon: string;
+        intent?: "default" | "danger";
+        href?: string;
+        method?: string;
+        requiresConfirmation?: boolean;
+    }>;
+}
+export interface DetailPanelBlockData {
+    sections: DetailPanelSectionDef[];
+    columns?: 1 | 2;
+}
+export interface ActivityTimelineEntry {
+    id: string;
+    actor: string;
+    actorHref?: string;
+    action: string;
+    detail?: string;
+    icon: string;
+    color: "success" | "info" | "warning" | "destructive" | "neutral";
+    timestamp: number;
+}
+export interface ActivityTimelineBlockData {
+    groups: Array<{
+        label: string;
+        entries: ActivityTimelineEntry[];
+    }>;
+    hasMore?: boolean;
+    loadMoreHref?: string;
+    limit?: number;
+}
+export type FormFieldType = "text" | "textarea" | "password" | "email" | "url" | "int" | "float" | "select" | "multiselect" | "radio" | "checkbox" | "switch" | "date" | "datetime" | "duration" | "file" | "entity_picker" | "hidden" | "static" | "header";
+export interface FormCondition {
+    field: string;
+    operator: "equals" | "not_equals" | "in" | "not_in";
+    value: string | string[];
+}
+export interface FormFieldNode {
+    kind: "field";
+    key: string;
+    component: FormFieldType;
+    props: {
+        label: string;
+        placeholder?: string;
+        helpText?: string;
+        required?: boolean;
+        disabled?: boolean;
+        readOnly?: boolean;
+        options?: Array<{
+            value: string;
+            label: string;
+        }>;
+        min?: number;
+        max?: number;
+        step?: number;
+        rows?: number;
+        accept?: string;
+        multiple?: boolean;
+        autocompleteHref?: string;
+        visible_when?: FormCondition;
+        hidden_when?: FormCondition;
+        disabled_when?: FormCondition;
+        required_when?: FormCondition;
+    };
+}
+export interface FormSectionNode {
+    kind: "section";
+    id: string;
+    label: string;
+    defaultCollapsed?: boolean;
+    children: FormSchemaNode[];
+}
+export interface FormGroupNode {
+    kind: "group";
+    id: string;
+    columns?: 1 | 2;
+    children: FormSchemaNode[];
+}
+export interface FormHeaderNode {
+    kind: "header";
+    label: string;
+}
+export type FormSchemaNode = FormFieldNode | FormSectionNode | FormGroupNode | FormHeaderNode;
+export interface FormPanelBlockData {
+    action: string;
+    method: "post" | "put" | "patch";
+    schema: FormSchemaNode[];
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    meta: {
+        submitLabel?: string;
+        cancelLabel?: string;
+        cancelHref?: string;
+        multiStep?: boolean;
+    };
+}
+export interface MarkdownPanelBlockData {
+    content: string;
+    maxHeight?: number;
+}
+export interface CardGridColumnDef {
+    key: string;
+    label: string;
+    kind?: "text" | "status" | "badge" | "boolean" | "timestamp" | "number";
+}
+export interface CardGridBlockData {
+    columns: CardGridColumnDef[];
+    rows: Record<string, unknown>[];
+    variant?: "default" | "store" | "connector";
+    emptyState?: {
+        icon?: string;
+        title?: string;
+        description?: string;
+        cta?: {
+            label: string;
+            href: string;
+        };
+    };
+}
+export interface ActionGridItem {
+    id: string;
+    icon: string;
+    title: string;
+    description: string;
+    actionUrl: string;
+    actionMethod?: "post" | "delete";
+    confirmText?: string;
+    sesskey?: string;
+}
+export interface ActionGridBlockData {
+    items: ActionGridItem[];
+    flash?: {
+        success: boolean;
+        message: string;
+    } | null;
+}
+export interface LinkListItem {
+    label: string;
+    href: string | null;
+    icon?: string;
+    description?: string;
+    external?: boolean;
+}
+export interface LinkListBlockData {
+    items: LinkListItem[];
+}
+export interface SentenceBuilderRule {
+    id: string;
+    field: string;
+    operator: string;
+    value: string;
+}
+export interface SentenceBuilderGroup {
+    id: string;
+    connector: "and" | "or";
+    rules: SentenceBuilderRule[];
+}
+export interface SentenceBuilderBlockData {
+    groups: SentenceBuilderGroup[];
+    availableFields: Array<{
+        key: string;
+        label: string;
+        operators: string[];
+    }>;
+    audienceEstimate?: {
+        matched: number;
+        total: number;
+    };
+}
+export interface ConditionRule {
+    id: string;
+    field: string;
+    operator: string;
+    value: string;
+}
+export interface ConditionGroup {
+    id: string;
+    logic: "and" | "or";
+    rules: ConditionRule[];
+    groups: ConditionGroup[];
+}
+export interface ConditionTreeBlockData {
+    root: ConditionGroup;
+    availableFields: Array<{
+        key: string;
+        label: string;
+        type: string;
+    }>;
+    availableOperators: Array<{
+        key: string;
+        label: string;
+    }>;
+}
+export interface TabbedPanelTab {
+    key: string;
+    label: string;
+    icon?: string;
+    blocks: import("@/contracts/page-contract").BlockDescriptor[];
+}
+export interface TabbedPanelBlockData {
+    tabs: TabbedPanelTab[];
+    defaultTab?: string;
+}
+export interface FlowEditorNode {
+    id: string;
+    type: "trigger" | "condition" | "action";
+    label: string;
+    description?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+}
+export interface FlowEditorEdge {
+    id: string;
+    source: string;
+    target: string;
+    label?: string;
+}
+export interface FlowEditorBlockData {
+    nodes: FlowEditorNode[];
+    edges: FlowEditorEdge[];
+}
+export interface FormBuilderField {
+    id: string;
+    type: "text" | "textarea" | "select" | "checkbox" | "date" | "file" | "rating" | "email" | "number";
+    label: string;
+    required?: boolean;
+    placeholder?: string;
+    options?: string[];
+}
+export interface FormBuilderBlockData {
+    fields: FormBuilderField[];
+    availableTypes: Array<{
+        type: string;
+        label: string;
+        icon: string;
+    }>;
+}
+//# sourceMappingURL=block-data.d.ts.map

package/dist-lib/contracts/block-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-data.d.ts","sourceRoot":"","sources":["../../src/contracts/block-data.ts"],"names":[],"mappings":"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"}

package/dist-lib/contracts/connectors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Connectors VOs — TypeScript mirror of PHP VOs in
+ * `classes/extensions/core/connectors/connector/*`.
+ */
+export type ConnectorStatus = "unconfigured" | "configured" | "connected" | "degraded" | "disconnected";
+export interface CredentialField {
+    key: string;
+    label: string;
+    type: "text" | "password" | "url" | "select";
+    required?: boolean;
+    placeholder?: string | null;
+}
+export interface HealthCheckResult {
+    success: boolean;
+    latency_ms: number | null;
+    error_message: string | null;
+    resulting_status: string;
+    checked_at: number;
+}
+export interface ConnectorListItem {
+    id: number;
+    fullname: string;
+    connector_type: string;
+    extension: string;
+    status: ConnectorStatus;
+    enabled: boolean;
+    last_check_at: number | null;
+    latency_ms: number | null;
+}
+export interface ConnectorDetail {
+    id: number;
+    fullname: string;
+    description: string | null;
+    connector_type: string;
+    endpoint: string | null;
+    extension: string;
+    status: ConnectorStatus;
+    enabled: boolean;
+    created_at: number;
+    modified_at: number;
+    credential_fields: CredentialField[];
+    health_history: HealthCheckResult[];
+}
+export interface ConnectorTypeInfo {
+    type: string;
+    name: string;
+    extension: string;
+    credential_fields: CredentialField[];
+}
+//# sourceMappingURL=connectors.d.ts.map

package/dist-lib/contracts/connectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectors.d.ts","sourceRoot":"","sources":["../../src/contracts/connectors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,YAAY,GACZ,WAAW,GACX,UAAU,GACV,cAAc,CAAC;AAEnB,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC,cAAc,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,eAAe,EAAE,CAAC;CACtC"}

package/dist-lib/contracts/navigation.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Navigation contract — typed shape for the `navigation` Inertia shared prop.
+ *
+ * PHP serializes this from navigation_registry during boot().
+ * Frontend reads it from usePage().props.navigation.
+ *
+ * @see ADR-807 ref/shell-and-navigation §4
+ * @see NV-05-ux-shell-sidebar.md §1.3
+ */
+/** Level 3 — leaf navigation item */
+export interface NavigationChild {
+    /** Unique key, e.g. "segments.rules.active" */
+    key: string;
+    /** Localized display label */
+    label: string;
+    /** Full URL (resolved by server, includes Moodle base). Null for non-leaf nodes. */
+    href?: string;
+    /** Server-resolved active state (true when this item is the current page) */
+    active: boolean;
+}
+/** Level 2 — navigable item, optionally has L3 children */
+export interface NavigationItem {
+    /** Unique key, e.g. "segments.rules" */
+    key: string;
+    /** Localized display label */
+    label: string;
+    /** Full URL. Null for section-only nodes without a landing page. */
+    href?: string;
+    /** Server-resolved active state */
+    active: boolean;
+    /** Optional badge — numeric count or status string, e.g. 3 or "new" */
+    badge?: number | string;
+    /** Badge display variant: 'count' (muted text, default) or 'alert' (red pill like WooCommerce). */
+    badgeVariant?: "count" | "alert";
+    /** L3 children — empty array if none */
+    children: NavigationChild[];
+}
+/** Level 1 — section group with icon, not directly navigable */
+export interface NavigationSection {
+    /** Unique key, e.g. "segments" */
+    key: string;
+    /** Localized display label */
+    label: string;
+    /**
+     * Lucide icon name (kebab-case), e.g. "filter", "plug", "git-branch".
+     * Sidebar renders it via dynamic Lucide import or icon map.
+     */
+    icon: string;
+    /** Group identifier for visual separators: "main" | "extensions" | "system" */
+    group?: "main" | "extensions" | "system";
+    /** L2 items in this section */
+    items: NavigationItem[];
+}
+/** Full navigation payload sent as Inertia shared prop (legacy shape) */
+export interface NavigationPayload {
+    sections: NavigationSection[];
+    /**
+     * Server-resolved key of the currently active item.
+     * Used by the sidebar for highlight — client does not do URL matching.
+     */
+    activeKey: string;
+}
+/**
+ * Unified node for the 3-level navigation tree.
+ *
+ * Can represent any level: group (N1), section (N2), or item (N3).
+ * Mirrors the PHP navigation_node VO.
+ */
+/** Entity types for automatic icon resolution when no explicit icon is set. */
+export type NavigationEntityType = "connector" | "workflow" | "segment" | "instancegroup" | "condition" | "compliance" | "offering" | "order" | "course" | "form" | "certificate";
+export interface NavigationNode {
+    key: string;
+    label: string;
+    icon?: string;
+    /** Entity type for automatic icon resolution (CC-based). Overrides depth fallback. */
+    entityType?: NavigationEntityType;
+    href?: string;
+    badge?: string | number;
+    /** Badge display variant: 'count' (muted text, default) or 'alert' (red pill like WooCommerce). */
+    badgeVariant?: "count" | "alert";
+    active?: boolean;
+    /** When true, clicking replaces sidebar with this node's children + back. */
+    drilldown?: boolean;
+    /** When true, group renders with a toggle to expand/collapse its content. */
+    collapsible?: boolean;
+    /** Whether a collapsible group starts expanded (default: false). */
+    defaultOpen?: boolean;
+    /** CSS color for status dot shown next to drilldown title (e.g. 'var(--success)'). */
+    statusColor?: string;
+    children?: NavigationNode[];
+}
+/** Navigation payload using the unified tree model */
+export interface NavigationTreePayload {
+    tree: NavigationNode[];
+    activeKey: string;
+    /** Stack of drilled-down node keys (for ← back navigation). */
+    drilldownStack?: string[];
+    /** Persistent footer items (Settings, Help). */
+    footer: NavigationNode[];
+}
+//# sourceMappingURL=navigation.d.ts.map

package/dist-lib/contracts/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/contracts/navigation.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,mGAAmG;IACnG,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,wCAAwC;IACxC,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;IACzC,+BAA+B;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,UAAU,GACV,SAAS,GACT,eAAe,GACf,WAAW,GACX,YAAY,GACZ,UAAU,GACV,OAAO,GACP,QAAQ,GACR,MAAM,GACN,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,mGAAmG;IACnG,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACjC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,gDAAgD;IAChD,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B"}