renderer-package 1.2.32

package/dist/page/types/page.d.ts

@@ -0,0 +1,202 @@
+import type { WorkflowStepsViewProps } from '../../pages/systemAdmin/modules/formbuilder/components/renderer/WorkflowStepsView';
+import type { WorkflowModalHandlers } from '../../pages/systemAdmin/modules/formbuilder/types/workflowModal';
+import type { PageWidgetConfig, WidgetActionConfig } from './widget-configs';
+export interface PageRouteConfig {
+    path: string;
+    isLandingPage?: boolean;
+    routeParams?: string[];
+    queryParams?: string[];
+}
+export interface PageDataBinding {
+    key: string;
+    source: 'route.param' | 'route.query' | 'context.user' | 'context.client' | 'context.tenant' | 'widget.state' | 'static';
+    param?: string;
+    widgetId?: string;
+    statePath?: string;
+    value?: unknown;
+    required?: boolean;
+    sample?: unknown;
+}
+export interface ConditionGroup {
+    logic: 'and' | 'or';
+    rules: ConditionRule[];
+    groups?: ConditionGroup[];
+}
+export interface ConditionRule {
+    left: ConditionOperand;
+    operator: string;
+    right?: ConditionOperand;
+}
+export type ConditionOperand = {
+    type: 'binding';
+    key: string;
+} | {
+    type: 'static';
+    value: unknown;
+} | {
+    type: 'context';
+    path: string;
+} | {
+    type: 'widget';
+    widgetId: string;
+    path: string;
+} | {
+    type: 'filter';
+    filterGroupKey: string;
+    key: string;
+} | {
+    type: 'literal';
+    value: unknown;
+};
+export type PageWidgetEventType = 'click' | 'row_click' | 'row_select' | 'submit' | 'change' | 'load' | 'error' | 'filter_change';
+export interface PageWidgetEvent {
+    type: PageWidgetEventType;
+    widgetId: string;
+    payload?: Record<string, unknown>;
+    timestamp: number;
+}
+export interface PageEventHandler {
+    id: string;
+    name?: string;
+    trigger: {
+        event: PageWidgetEventType;
+        widgetId?: string;
+    };
+    conditions?: ConditionGroup;
+    actions: WidgetActionConfig[];
+}
+export interface PageNavigationConfig {
+    breadcrumbs?: Array<{
+        label: string;
+        pageId?: string;
+        href?: string;
+    }>;
+    previousPage?: {
+        pageId?: string;
+        label?: string;
+    };
+    nextPage?: {
+        pageId?: string;
+        label?: string;
+    };
+    links?: Array<{
+        label: string;
+        pageId?: string;
+        icon?: string;
+    }>;
+}
+export type PageLayout = 'stack' | 'sidebar-main' | 'full-bleed';
+export type PagePadding = 'none' | 'sm' | 'md' | 'lg';
+export type PageMaxWidth = 'full' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '4xl' | '5xl' | '6xl' | '7xl';
+export interface PageContainerConfig {
+    padding?: PagePadding;
+    maxWidth?: PageMaxWidth;
+    showBorder?: boolean;
+}
+export type PageWidgetType = 'section' | 'columns' | 'card' | 'tab_group' | 'accordion' | 'divider' | 'spacer' | 'heading' | 'text' | 'markdown' | 'image' | 'stat_card' | 'stat_grid' | 'data_table' | 'chart_bar' | 'chart_line' | 'chart_pie' | 'chart_area' | 'chart_combo' | 'search_filter' | 'select_filter' | 'date_range_filter' | 'button' | 'button_group' | 'form_embed' | 'workflow_embed' | 'modal_trigger' | 'link' | 'page_nav' | 'week_calendar' | 'detail_card' | 'dual_list' | 'time_grid' | 'calendar_month' | 'calendar_year' | 'year_stepper' | 'week_stepper' | 'week_selector' | 'date_picker' | 'date_time_grid' | 'editable_matrix';
+export interface PageWidget {
+    id: string;
+    type: PageWidgetType;
+    label?: string;
+    config: PageWidgetConfig;
+    visibleWhen?: ConditionGroup | null;
+    children?: PageWidget[];
+}
+export interface PageSchema {
+    version: 1;
+    layout: PageLayout;
+    container?: PageContainerConfig;
+    meta?: {
+        title?: string;
+        description?: string;
+        icon?: string;
+    };
+    dataBindings: PageDataBinding[];
+    dataApis?: Record<string, import('./widget-configs').PageDataApiDefinition>;
+    prepopulateApi?: import('./widget-configs').PagePrepopulateApiConfig;
+    widgets: PageWidget[];
+    filterGroups?: string[];
+    eventHandlers?: PageEventHandler[];
+    navigation?: PageNavigationConfig;
+}
+export interface PageDefinition {
+    id: string;
+    clientId: string;
+    name: string;
+    description?: string;
+    version: number;
+    isActive: boolean;
+    moduleId: string;
+    tenantId?: string | null;
+    featureId?: string;
+    subFeatureId?: string;
+    isDefault?: boolean;
+    schema: PageSchema;
+    route?: PageRouteConfig;
+    basedOnId?: string;
+    createdAt: string;
+    updatedAt: string;
+    createdBy?: string;
+    updatedBy?: string;
+}
+export interface PageRenderPayload {
+    id: string;
+    version: number;
+    route?: PageRouteConfig;
+    schema: PageSchema;
+    embeddedForms?: Record<string, unknown>;
+}
+export interface PageResolveResult {
+    pageId: string;
+    version: number;
+    /** Set when resolve returns an embedded render payload (skips second fetch). */
+    renderPayload?: PageRenderPayload;
+    routeParams?: Record<string, string>;
+}
+export type PageAction = WidgetActionConfig & {
+    sourceWidgetId?: string;
+    event?: PageWidgetEventType;
+    payload?: Record<string, unknown>;
+    /**
+     * Live page context at dispatch time (host context + prepopulate mappings +
+     * values published by widgets). Hosts must merge this over their own context
+     * so API actions can resolve keys that only exist inside the renderer.
+     */
+    context?: Record<string, unknown>;
+};
+export interface PageRendererProps {
+    page: PageRenderPayload;
+    context?: Record<string, unknown>;
+    onAction?: (action: PageAction) => void;
+    chrome?: 'none' | 'minimal';
+    className?: string;
+    isEditor?: boolean;
+    nestingDepth?: number;
+    getWorkflowState?: WorkflowStepsViewProps['getWorkflowState'];
+    workflowModalHandlers?: WorkflowModalHandlers;
+    getAuthHeaders?: () => Record<string, string>;
+    /** When true, skip wrapping in PageContextProvider (nested page tabs reuse parent context) */
+    inheritContext?: boolean;
+    /** When true, skip built-in form modal and delegate `modal` actions to `onAction`. */
+    delegateModalToHost?: boolean;
+}
+export interface StudioPageHostProps {
+    clientId: string;
+    tenantId?: string;
+    moduleId?: string;
+    featureId?: string;
+    pageId?: string;
+    routePath?: string;
+    routeParams?: Record<string, string>;
+    isDefault?: boolean;
+    context?: Record<string, unknown>;
+    version?: number;
+    chrome?: 'none' | 'minimal';
+    onAction?: (action: PageAction) => void;
+    getWorkflowState?: WorkflowStepsViewProps['getWorkflowState'];
+    workflowModalHandlers?: WorkflowModalHandlers;
+    getAuthHeaders?: () => Record<string, string>;
+    delegateModalToHost?: boolean;
+}
+export declare const MAX_PAGE_NESTING_DEPTH = 1;
+//# sourceMappingURL=page.d.ts.map

package/dist/page/types/page.d.ts.map

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