@object-ui/types 3.0.3 → 3.1.0

package/dist/app.d.ts

@@ -10,8 +10,100 @@
  *
  * Defines the metadata structure for a complete application, including
  * global layout, navigation menus, and routing configuration.
+ *
+ * ## Navigation Model
+ *
+ * ObjectUI uses a unified `NavigationItem` model aligned with @objectstack/spec.
+ * The legacy `MenuItem` type is retained for backward compatibility but new
+ * configurations should use `NavigationItem` and the `navigation` / `areas` fields.
  */
 import type { BaseSchema } from './base';
+/**
+ * Navigation item type — determines the target and required fields.
+ */
+export type NavigationItemType = 'object' | 'dashboard' | 'page' | 'report' | 'url' | 'group' | 'separator' | 'action';
+/**
+ * Unified Navigation Item
+ *
+ * The single navigation primitive used across ObjectUI and @objectstack/spec.
+ * Replaces the legacy `MenuItem` for application navigation trees.
+ *
+ * Supports typed navigation targets (object, dashboard, page, report, url),
+ * nested groups, visibility expressions, RBAC permissions, and UX enhancements
+ * like badges, pinning, and sort ordering.
+ */
+export interface NavigationItem {
+    /** Unique identifier */
+    id: string;
+    /** Navigation item type */
+    type: NavigationItemType;
+    /** Display label (plain string or I18nLabel object for internationalization) */
+    label: string | {
+        key: string;
+        defaultValue?: string;
+        params?: Record<string, any>;
+    };
+    /** Icon name (Lucide) */
+    icon?: string;
+    /** Target object name (for type: 'object') */
+    objectName?: string;
+    /** Target view name (for type: 'object') — opens a specific named list view e.g. 'calendar', 'pipeline' */
+    viewName?: string;
+    /** Target dashboard name (for type: 'dashboard') */
+    dashboardName?: string;
+    /** Target page name (for type: 'page') */
+    pageName?: string;
+    /** Target report name (for type: 'report') */
+    reportName?: string;
+    /** Target URL (for type: 'url') */
+    url?: string;
+    /** Link target (for type: 'url') */
+    target?: '_blank' | '_self';
+    /** Child navigation items (for type: 'group') */
+    children?: NavigationItem[];
+    /** Visibility expression — boolean or expression string e.g. "${user.role === 'admin'}" */
+    visible?: boolean | string;
+    /** Required permissions to see/access this item */
+    requiredPermissions?: string[];
+    /** Badge text or count */
+    badge?: string | number;
+    /** Badge visual variant */
+    badgeVariant?: 'default' | 'destructive' | 'outline';
+    /** Whether group is expanded by default (for type: 'group') */
+    defaultOpen?: boolean;
+    /** Whether this item is pinned */
+    pinned?: boolean;
+    /** Sort order weight (lower = higher) */
+    order?: number;
+}
+/**
+ * Navigation Area — a business-domain partition of navigation items.
+ *
+ * Inspired by Salesforce Lightning App → Area → Tab model and
+ * Microsoft Power Apps Area → Group → Subarea pattern.
+ *
+ * Each area contains an independent navigation tree, allowing large
+ * enterprise applications to organise navigation by domain (e.g.
+ * Sales, Service, Marketing).
+ */
+export interface NavigationArea {
+    /** Unique identifier */
+    id: string;
+    /** Display label (plain string or I18nLabel object for internationalization) */
+    label: string | {
+        key: string;
+        defaultValue?: string;
+        params?: Record<string, any>;
+    };
+    /** Icon name (Lucide) */
+    icon?: string;
+    /** Navigation items within this area */
+    navigation: NavigationItem[];
+    /** Visibility expression */
+    visible?: boolean | string;
+    /** Required permissions to see this area */
+    requiredPermissions?: string[];
+}
 /**
  * Top-level Application Configuration (app.json)
  */
@@ -25,10 +117,18 @@ export interface AppSchema extends BaseSchema {
      * Display Title
      */
     title?: string;
+    /**
+     * Display Label (used in navigation and app switcher)
+     */
+    label?: string;
     /**
      * Application Description
      */
     description?: string;
+    /**
+     * Icon name (Lucide) for app switcher and navigation
+     */
+    icon?: string;
     /**
      * Logo URL or Icon name
      */
@@ -37,6 +137,15 @@ export interface AppSchema extends BaseSchema {
      * Favicon URL
      */
     favicon?: string;
+    /**
+     * Branding configuration
+     */
+    branding?: BrandingConfig;
+    /**
+     * Whether the application is active (visible in app switcher)
+     * @default true
+     */
+    active?: boolean;
     /**
      * Global Layout Strategy
      * - sidebar: Standard admin layout with left sidebar
@@ -47,8 +156,20 @@ export interface AppSchema extends BaseSchema {
     layout?: 'sidebar' | 'header' | 'empty';
     /**
      * Global Navigation Menu
+     * @deprecated Use `navigation` instead. Retained for backward compatibility.
      */
     menu?: MenuItem[];
+    /**
+     * Unified navigation tree (aligned with @objectstack/spec NavigationItem model).
+     * Takes precedence over `menu` when both are present.
+     */
+    navigation?: NavigationItem[];
+    /**
+     * Navigation areas / business-domain partitions.
+     * When provided, the sidebar displays an area switcher and renders
+     * the selected area's navigation tree.
+     */
+    areas?: NavigationArea[];
     /**
      * Global Actions (User Profile, Settings, etc)
      */
@@ -66,6 +187,7 @@ export interface AppSchema extends BaseSchema {
 }
 /**
  * Navigation Menu Item
+ * @deprecated Use `NavigationItem` instead.
  */
 export interface MenuItem {
     /**
@@ -101,6 +223,101 @@ export interface MenuItem {
      */
     hidden?: boolean | string;
 }
+/**
+ * Convert a legacy `MenuItem` to a `NavigationItem`.
+ *
+ * Mapping rules:
+ * - `type: 'item'` → inferred from `href` (url) or `path` (page)
+ * - `type: 'group'` → `type: 'group'`
+ * - `type: 'separator'` → `type: 'separator'`
+ * - `hidden` → `visible` (inverted)
+ * - `path` → `pageName` (last segment) or kept as-is for url
+ * - `href` → `url` with `target: '_blank'`
+ */
+export declare function menuItemToNavigationItem(item: MenuItem, index?: number): NavigationItem;
+/**
+ * Wizard step identifier for app creation flow.
+ */
+export type AppWizardStepId = 'basic' | 'objects' | 'navigation' | 'branding';
+/**
+ * App wizard step definition.
+ */
+export interface AppWizardStep {
+    /** Step identifier */
+    id: AppWizardStepId;
+    /** Display label */
+    label: string;
+    /** Step description */
+    description?: string;
+    /** Icon name (Lucide) */
+    icon?: string;
+    /** Whether the step is optional */
+    optional?: boolean;
+}
+/**
+ * Branding configuration for an application.
+ */
+export interface BrandingConfig {
+    /** Logo URL or base64 data URI */
+    logo?: string;
+    /** Primary brand color (hex) */
+    primaryColor?: string;
+    /** Favicon URL */
+    favicon?: string;
+    /** Font family override */
+    fontFamily?: string;
+}
+/**
+ * Object selection entry for the wizard.
+ */
+export interface ObjectSelection {
+    /** Object name (snake_case) */
+    name: string;
+    /** Display label */
+    label: string;
+    /** Icon name (Lucide) */
+    icon?: string;
+    /** Whether this object is selected */
+    selected: boolean;
+}
+/**
+ * App creation wizard draft state — represents the in-progress
+ * application configuration before it is finalized into an AppSchema.
+ */
+export interface AppWizardDraft {
+    /** App name (snake_case, validated) */
+    name: string;
+    /** Display title */
+    title: string;
+    /** Description */
+    description?: string;
+    /** App icon name (Lucide) */
+    icon?: string;
+    /** Template to start from */
+    template?: string;
+    /** Layout strategy */
+    layout: 'sidebar' | 'header' | 'empty';
+    /** Selected business objects */
+    objects: ObjectSelection[];
+    /** Navigation tree being built */
+    navigation: NavigationItem[];
+    /** Branding configuration */
+    branding: BrandingConfig;
+}
+/**
+ * Editor mode for the app designer.
+ */
+export type EditorMode = 'edit' | 'preview' | 'code';
+/**
+ * Validate an app name is snake_case.
+ * Pattern: starts with lowercase letter, followed by lowercase letters/digits,
+ * with optional underscore-separated segments (no trailing/leading/double underscores).
+ */
+export declare function isValidAppName(name: string): boolean;
+/**
+ * Convert an AppWizardDraft to an AppSchema.
+ */
+export declare function wizardDraftToAppSchema(draft: AppWizardDraft): AppSchema;
 /**
  * Application Header/Toolbar Action
  */

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,IAAI,EAAE,KAAK,CAAC;IAEZ;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IAExC;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;IAEtC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IACjF;;OAEG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,CAAC;CACzC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/app.js

@@ -5,4 +5,88 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export {};
+// ============================================================================
+// MenuItem → NavigationItem Transform
+// ============================================================================
+/**
+ * Convert a legacy `MenuItem` to a `NavigationItem`.
+ *
+ * Mapping rules:
+ * - `type: 'item'` → inferred from `href` (url) or `path` (page)
+ * - `type: 'group'` → `type: 'group'`
+ * - `type: 'separator'` → `type: 'separator'`
+ * - `hidden` → `visible` (inverted)
+ * - `path` → `pageName` (last segment) or kept as-is for url
+ * - `href` → `url` with `target: '_blank'`
+ */
+export function menuItemToNavigationItem(item, index = 0) {
+    const id = `migrated_${index}`;
+    if (item.type === 'separator') {
+        return {
+            id,
+            type: 'separator',
+            label: item.label || '',
+        };
+    }
+    if (item.type === 'group') {
+        return {
+            id,
+            type: 'group',
+            label: item.label || '',
+            icon: item.icon,
+            children: (item.children || []).map((child, i) => menuItemToNavigationItem(child, index * 100 + i)),
+            visible: item.hidden !== undefined ? !item.hidden : undefined,
+            badge: item.badge,
+            defaultOpen: true,
+        };
+    }
+    // Default: 'item' type — infer target from href / path
+    if (item.href) {
+        return {
+            id,
+            type: 'url',
+            label: item.label || '',
+            icon: item.icon,
+            url: item.href,
+            target: '_blank',
+            visible: item.hidden !== undefined ? !item.hidden : undefined,
+            badge: item.badge,
+        };
+    }
+    // Path-based item → treat as page navigation
+    return {
+        id,
+        type: 'page',
+        label: item.label || '',
+        icon: item.icon,
+        pageName: item.path || '',
+        visible: item.hidden !== undefined ? !item.hidden : undefined,
+        badge: item.badge,
+    };
+}
+/**
+ * Validate an app name is snake_case.
+ * Pattern: starts with lowercase letter, followed by lowercase letters/digits,
+ * with optional underscore-separated segments (no trailing/leading/double underscores).
+ */
+export function isValidAppName(name) {
+    return /^[a-z][a-z0-9]*(_[a-z0-9]+)*$/.test(name);
+}
+/**
+ * Convert an AppWizardDraft to an AppSchema.
+ */
+export function wizardDraftToAppSchema(draft) {
+    return {
+        type: 'app',
+        name: draft.name,
+        title: draft.title,
+        label: draft.title,
+        description: draft.description,
+        icon: draft.icon,
+        logo: draft.branding.logo,
+        favicon: draft.branding.favicon,
+        branding: draft.branding,
+        layout: draft.layout,
+        navigation: draft.navigation,
+    };
+}

package/dist/complex.d.ts

@@ -452,6 +452,8 @@ export interface DashboardWidgetLayout {
 export interface DashboardWidgetSchema {
     id?: string;
     title?: string;
+    /** Widget description */
+    description?: string;
     /** Component schema (legacy format) */
     component?: SchemaNode;
     layout?: DashboardWidgetLayout;
@@ -459,17 +461,133 @@ export interface DashboardWidgetSchema {
     type?: string;
     /** Widget-specific configuration (spec shorthand format) */
     options?: unknown;
+    /** Chart configuration for chart-type widgets */
+    chartConfig?: any;
+    /**
+     * Widget color variant.
+     * Aligned with @objectstack/spec WidgetColorVariantSchema.
+     */
+    colorVariant?: 'default' | 'blue' | 'teal' | 'orange' | 'purple' | 'success' | 'warning' | 'danger';
+    /** Action URL for clickable widgets */
+    actionUrl?: string;
+    /** Action type for widget interactions */
+    actionType?: string;
+    /** Action icon name */
+    actionIcon?: string;
+    /**
+     * Data binding: Object name for data source.
+     * Aligned with @objectstack/spec DashboardWidgetSchema.object.
+     */
+    object?: string;
+    /**
+     * Data binding: Filter conditions.
+     * Aligned with @objectstack/spec DashboardWidgetSchema.filter.
+     */
+    filter?: any;
+    /**
+     * Data binding: Category field for grouping.
+     * Aligned with @objectstack/spec DashboardWidgetSchema.categoryField.
+     */
+    categoryField?: string;
+    /**
+     * Data binding: Value field for aggregation.
+     * Aligned with @objectstack/spec DashboardWidgetSchema.valueField.
+     */
+    valueField?: string;
+    /**
+     * Aggregation function.
+     * Aligned with @objectstack/spec DashboardWidgetSchema.aggregate.
+     */
+    aggregate?: string;
+    /**
+     * Multiple measures for pivot/matrix display.
+     * Aligned with @objectstack/spec WidgetMeasureSchema.
+     */
+    measures?: Array<{
+        valueField: string;
+        aggregate: string;
+        label?: string;
+        format?: string;
+    }>;
+    /**
+     * Responsive configuration per breakpoint.
+     * Aligned with @objectstack/spec DashboardWidgetSchema.responsive.
+     */
+    responsive?: any;
+    /**
+     * ARIA accessibility attributes.
+     * Aligned with @objectstack/spec AriaPropsSchema.
+     */
+    aria?: {
+        ariaLabel?: string;
+        ariaDescribedBy?: string;
+        role?: string;
+    };
 }
 /**
  * Dashboard Schema
  */
 export interface DashboardSchema extends BaseSchema {
     type: 'dashboard';
+    /** Dashboard title displayed in the header */
+    title?: string;
     columns?: number;
     gap?: number;
     widgets: DashboardWidgetSchema[];
     /** Auto-refresh interval in seconds. When set, the dashboard will periodically trigger onRefresh. */
     refreshInterval?: number;
+    /**
+     * Dashboard header configuration.
+     * Aligned with @objectstack/spec DashboardHeaderSchema.
+     */
+    header?: {
+        showTitle?: boolean;
+        showDescription?: boolean;
+        actions?: Array<{
+            label: string;
+            actionUrl?: string;
+            actionType?: string;
+            icon?: string;
+        }>;
+    };
+    /**
+     * Global filter configurations.
+     * Applied across all dashboard widgets.
+     * Aligned with @objectstack/spec GlobalFilterSchema.
+     */
+    globalFilters?: Array<{
+        field: string;
+        label?: string;
+        type?: 'text' | 'select' | 'date' | 'number' | 'lookup';
+        options?: string[];
+        optionsFrom?: {
+            object: string;
+            valueField: string;
+            labelField?: string;
+            filter?: any;
+        };
+        defaultValue?: any;
+        scope?: string;
+        targetWidgets?: string[];
+    }>;
+    /**
+     * Date range filter configuration.
+     * Aligned with @objectstack/spec DashboardSchema.dateRange.
+     */
+    dateRange?: {
+        field?: string;
+        defaultRange?: 'today' | 'yesterday' | 'this_week' | 'last_week' | 'this_month' | 'last_month' | 'this_quarter' | 'last_quarter' | 'this_year' | 'last_year' | 'last_7_days' | 'last_30_days' | 'last_90_days' | 'custom';
+        allowCustomRange?: boolean;
+    };
+    /**
+     * ARIA accessibility attributes.
+     * Aligned with @objectstack/spec AriaPropsSchema.
+     */
+    aria?: {
+        ariaLabel?: string;
+        ariaDescribedBy?: string;
+        role?: string;
+    };
 }
 /**
  * Union type of all complex schemas

package/dist/complex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"complex.d.ts","sourceRoot":"","sources":["../src/complex.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD;;OAEG;IACH,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9F;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IACzC;;OAEG;IACH,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAC7C;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD,IAAI,EAAE,eAAe,CAAC;IACtB;;OAEG;IACH,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC9C;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC;IACjD;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IACpC;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,cAAc,GACd,aAAa,GACb,WAAW,GACX,cAAc,GACd,WAAW,GACX,uBAAuB,GACvB,oBAAoB,GACpB,UAAU,GACV,cAAc,GACd,IAAI,GACJ,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IACzB;;OAEG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB;;OAEG;IACH,UAAU,EAAE,CAAC,eAAe,GAAG,WAAW,CAAC,EAAE,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,IAAI,EAAE,gBAAgB,CAAC;IACvB;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC1D;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,EAAE,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,OAAO,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB;;OAEG;IACH,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB;IACpC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,UAAU;IACjD,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,qGAAqG;IACrG,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,kBAAkB,GAClB,mBAAmB,GACnB,cAAc,GACd,aAAa,GACb,eAAe,CAAC"}
+{"version":3,"file":"complex.d.ts","sourceRoot":"","sources":["../src/complex.ts"],"names":[],"mappings":"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"}

package/dist/data-display.d.ts

@@ -330,6 +330,13 @@ export interface DataTableSchema extends BaseSchema {
      * @default false
      */
     selectable?: boolean | 'single' | 'multiple';
+    /**
+     * Selection checkbox display style
+     * - 'always': Checkboxes are always visible
+     * - 'hover': Checkboxes only appear on row hover
+     * @default 'always'
+     */
+    selectionStyle?: 'always' | 'hover';
     /**
      * Enable column sorting
      * @default true
@@ -377,6 +384,12 @@ export interface DataTableSchema extends BaseSchema {
      * @default false
      */
     editable?: boolean;
+    /**
+     * Enable single-click editing mode
+     * When true with editable, clicking a cell enters edit mode (instead of double-click)
+     * @default false
+     */
+    singleClickEdit?: boolean;
     /**
      * Cell value change handler
      * Called when a cell value is edited
@@ -406,6 +419,41 @@ export interface DataTableSchema extends BaseSchema {
      * Function that returns a CSS class string for each row
      */
     rowClassName?: (row: any, index: number) => string | undefined;
+    /**
+     * Dynamic row inline style
+     * Function that returns CSSProperties for each row (e.g., from conditionalFormatting).
+     */
+    rowStyle?: (row: any, index: number) => React.CSSProperties | undefined;
+    /**
+     * Number of columns to freeze (left-pin)
+     * When set, the first N columns remain fixed while the rest scroll horizontally.
+     * @default 0
+     */
+    frozenColumns?: number;
+    /**
+     * Show row numbers in the first column (Airtable-style)
+     * @default false
+     */
+    showRowNumbers?: boolean;
+    /**
+     * Show "+ Add record" row at the bottom of the table (Airtable-style)
+     * @default false
+     */
+    showAddRow?: boolean;
+    /**
+     * Callback when the "+ Add record" row is clicked
+     */
+    onAddRecord?: () => void;
+    /**
+     * Column resize handler
+     * Called when a column is resized
+     */
+    onColumnResize?: (columnKey: string, width: number) => void;
+    /**
+     * Column reorder handler (new order of accessorKeys)
+     * Called when columns are reordered via drag-and-drop
+     */
+    onColumnReorder?: (newOrder: string[]) => void;
 }
 /**
  * Markdown renderer component
@@ -579,6 +627,62 @@ export interface ChartSchema extends BaseSchema {
      */
     config?: Record<string, any>;
 }
+/**
+ * Aggregation function for pivot table values
+ */
+export type PivotAggregation = 'sum' | 'count' | 'avg' | 'min' | 'max';
+/**
+ * Pivot table (cross-tabulation) component
+ *
+ * Renders a matrix where rows correspond to one field,
+ * columns to another, and cells show an aggregated value.
+ */
+export interface PivotTableSchema extends BaseSchema {
+    type: 'pivot';
+    /**
+     * Pivot table title
+     */
+    title?: string;
+    /**
+     * Field used for row headers
+     */
+    rowField: string;
+    /**
+     * Field used for column headers
+     */
+    columnField: string;
+    /**
+     * Field whose values are aggregated in cells
+     */
+    valueField: string;
+    /**
+     * Aggregation function applied to valueField
+     * @default 'sum'
+     */
+    aggregation?: PivotAggregation;
+    /**
+     * Source data rows
+     */
+    data: Record<string, unknown>[];
+    /**
+     * Show a totals column on the right
+     * @default false
+     */
+    showRowTotals?: boolean;
+    /**
+     * Show a totals row at the bottom
+     * @default false
+     */
+    showColumnTotals?: boolean;
+    /**
+     * Numeric format string (e.g. "$,.2f") — applied via simple prefix/suffix/decimals
+     */
+    format?: string;
+    /**
+     * Mapping of column header values to Tailwind text-color classes
+     */
+    columnColors?: Record<string, string>;
+}
 /**
  * Timeline event
  */
@@ -677,7 +781,7 @@ export interface KbdSchema extends BaseSchema {
 /**
  * Union type of all data display schemas
  */
-export type DataDisplaySchema = AlertSchema | BadgeSchema | AvatarSchema | ListSchema | TableSchema | DataTableSchema | MarkdownSchema | TreeViewSchema | ChartSchema | TimelineSchema | HtmlSchema | StatisticSchema | BreadcrumbSchema | KbdSchema;
+export type DataDisplaySchema = AlertSchema | BadgeSchema | AvatarSchema | ListSchema | TableSchema | DataTableSchema | MarkdownSchema | TreeViewSchema | ChartSchema | PivotTableSchema | TimelineSchema | HtmlSchema | StatisticSchema | BreadcrumbSchema | KbdSchema;
 /**
  * Raw HTML component
  */