@questpie/admin 1.1.1 → 2.0.0

package/dist/client/builder/types/field-types.mjs

@@ -0,0 +1,19 @@
+//#region src/client/builder/types/field-types.ts
+/**
+* Helper to check if item is a field reference (string or object with field)
+*/
+function isFieldReference(item) {
+	return typeof item === "string" || "field" in item && !("type" in item);
+}
+/**
+* Helper to get field name from layout item
+*/
+function getFieldName(item) {
+	if (typeof item === "string") return item;
+	if ("field" in item && typeof item.field === "string") return item.field;
+	return null;
+}
+
+//#endregion
+export { getFieldName, isFieldReference };
+//# sourceMappingURL=field-types.mjs.map

package/dist/client/builder/types/field-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-types.mjs","names":[],"sources":["../../../../src/client/builder/types/field-types.ts"],"sourcesContent":["/**\n * Field Component Types\n *\n * Types for field components, form views, and field configuration.\n */\n\nimport type { z } from \"zod\";\nimport type { ComponentReference } from \"#questpie/admin/server\";\nimport type { I18nText } from \"../../i18n/types.js\";\nimport type { ActionDefinition } from \"./action-types\";\nimport type {\n\tBaseFieldProps,\n\tDynamicI18nText,\n\tIconComponent,\n\tMaybeLazyComponent,\n} from \"./common\";\n\n// ============================================================================\n// Validation Configuration\n// ============================================================================\n\n/**\n * Validation configuration for fields\n *\n * These options are used to generate Zod schemas for client-side validation.\n */\nexport interface FieldValidationConfig {\n\t/**\n\t * Minimum length for strings\n\t */\n\tminLength?: number;\n\n\t/**\n\t * Maximum length for strings\n\t */\n\tmaxLength?: number;\n\n\t/**\n\t * Minimum value for numbers\n\t */\n\tmin?: number;\n\n\t/**\n\t * Maximum value for numbers\n\t */\n\tmax?: number;\n\n\t/**\n\t * Regex pattern for strings\n\t */\n\tpattern?: RegExp | string;\n\n\t/**\n\t * Custom error message for pattern validation\n\t */\n\tpatternMessage?: string;\n\n\t/**\n\t * Email validation (for text fields)\n\t */\n\temail?: boolean;\n\n\t/**\n\t * URL validation (for text fields)\n\t */\n\turl?: boolean;\n\n\t/**\n\t * Custom validation function\n\t * @returns Error message if invalid, undefined if valid\n\t */\n\tvalidate?: (\n\t\tvalue: any,\n\t\tformValues: Record<string, any>,\n\t) => string | undefined;\n\n\t/**\n\t * Custom Zod refinement\n\t */\n\trefine?: (schema: z.ZodTypeAny) => z.ZodTypeAny;\n}\n\n// ============================================================================\n// Field Component Props\n// ============================================================================\n\n/**\n * Props passed to field components\n *\n * @typeParam TValue - Type of the field value\n */\nexport interface FieldComponentProps<TValue = any> extends BaseFieldProps {\n\t/**\n\t * Field value (typed)\n\t */\n\tvalue: TValue;\n\n\t/**\n\t * Change handler (typed)\n\t * Optional to support read-only/preview modes\n\t */\n\tonChange?: (value: TValue) => void;\n\n\t/**\n\t * Field configuration options\n\t */\n\tconfig?: FieldUIConfig;\n}\n\n/**\n * Props for embedded collection fields\n */\nexport interface EmbeddedCollectionProps extends BaseFieldProps {\n\t/**\n\t * Target collection name\n\t */\n\tcollection: string;\n\n\t/**\n\t * Display mode\n\t */\n\tmode?: \"inline\" | \"modal\" | \"drawer\";\n\n\t/**\n\t * Whether items can be reordered\n\t */\n\torderable?: boolean;\n\n\t/**\n\t * Function to generate row labels\n\t */\n\trowLabel?: (item: any) => string;\n}\n\n// ============================================================================\n// Field Hooks Context\n// ============================================================================\n\n/**\n * Context provided to field hooks (onChange, etc.)\n */\nexport interface FieldHookContext {\n\t/**\n\t * Set value of any field in the form\n\t */\n\tsetValue: (name: string, value: any) => void;\n\n\t/**\n\t * Get current values of all fields\n\t */\n\tgetValues: () => Record<string, any>;\n\n\t/**\n\t * Get value of a specific field\n\t */\n\tgetValue: (name: string) => any;\n\n\t/**\n\t * Current field name\n\t */\n\tfieldName: string;\n\n\t/**\n\t * Current locale (for localized fields)\n\t */\n\tlocale?: string;\n}\n\n// ============================================================================\n// Field UI Configuration\n// ============================================================================\n\n/**\n * Field UI configuration (per-field overrides in collection config)\n */\nexport interface FieldUIConfig {\n\t/**\n\t * Display label\n\t */\n\tlabel?: DynamicI18nText;\n\n\t/**\n\t * Description text\n\t */\n\tdescription?: DynamicI18nText;\n\n\t/**\n\t * Placeholder text\n\t */\n\tplaceholder?: DynamicI18nText;\n\n\t/**\n\t * Field type override\n\t */\n\ttype?: string;\n\n\t/**\n\t * Whether field is required\n\t */\n\trequired?: boolean | ((values: Record<string, any>) => boolean);\n\n\t/**\n\t * Whether field is read-only\n\t */\n\treadOnly?: boolean | ((values: Record<string, any>) => boolean);\n\n\t/**\n\t * Whether field is disabled (grayed out, can be dynamic)\n\t */\n\tdisabled?: boolean | ((values: Record<string, any>) => boolean);\n\n\t/**\n\t * Whether field is hidden (can be dynamic based on form values).\n\t * Hidden fields are not rendered. Default is false (visible).\n\t *\n\t * Note: undefined/false = visible, true = hidden.\n\t * This follows JavaScript falsy semantics for better DX.\n\t */\n\thidden?: boolean | ((values: Record<string, any>) => boolean);\n\n\t/**\n\t * Whether field is localized\n\t */\n\tlocalized?: boolean;\n\n\t/**\n\t * Validation configuration for client-side validation\n\t */\n\tvalidation?: FieldValidationConfig;\n\n\t/**\n\t * Custom field component\n\t */\n\tcomponent?: MaybeLazyComponent<FieldComponentProps>;\n\n\t/**\n\t * Additional options for field type\n\t */\n\toptions?: SelectOption[] | ((values: Record<string, any>) => SelectOption[]);\n\n\t/**\n\t * Relation configuration\n\t */\n\trelation?: RelationFieldConfig;\n\n\t/**\n\t * Embedded collection configuration\n\t */\n\tembedded?: EmbeddedFieldConfig;\n\n\t/**\n\t * Rich text configuration\n\t */\n\trichText?: RichTextConfig;\n\n\t/**\n\t * Array field configuration\n\t */\n\tarray?: ArrayFieldConfig;\n\n\t// ========================================================================\n\t// Field Hooks\n\t// ========================================================================\n\n\t/**\n\t * Compute field value from other fields (proxy-tracked dependencies).\n\t * Makes the field read-only and virtual (not submitted to backend).\n\t *\n\t * Dependencies are automatically detected via Proxy tracking.\n\t * Works in both forms (reactive) and tables (static).\n\t *\n\t * @example\n\t * ```ts\n\t * pricePerMinute: r.number({\n\t *   label: \"Price/Minute\",\n\t *   compute: (values) => values.price / values.duration,\n\t * })\n\t *\n\t * fullName: r.text({\n\t *   compute: (values) => `${values.firstName} ${values.lastName}`,\n\t * })\n\t * ```\n\t */\n\tcompute?: (values: Record<string, any>) => any;\n\n\t/**\n\t * Called when field value changes.\n\t * Use for side effects like updating other fields.\n\t * Can be async for API calls.\n\t *\n\t * @example\n\t * ```ts\n\t * onChange: async (value, { setValue }) => {\n\t *   // Auto-generate slug from title\n\t *   setValue('slug', slugify(value));\n\t * }\n\t * ```\n\t */\n\tonChange?: (value: any, ctx: FieldHookContext) => void | Promise<void>;\n\n\t/**\n\t * Dynamic default value for new records.\n\t * Can be a static value, sync function, or async function.\n\t * Only evaluated when creating new records (not on edit).\n\t *\n\t * @example\n\t * ```ts\n\t * // Static\n\t * defaultValue: \"draft\"\n\t *\n\t * // Based on other fields\n\t * defaultValue: (values) => values.type === \"post\" ? \"draft\" : \"published\"\n\t *\n\t * // Async (fetch from API)\n\t * defaultValue: async (values) => {\n\t *   const settings = await fetchSettings();\n\t *   return settings.defaultStatus;\n\t * }\n\t * ```\n\t */\n\tdefaultValue?:\n\t\t| any\n\t\t| ((values: Record<string, any>) => any)\n\t\t| ((values: Record<string, any>) => Promise<any>);\n\n\t/**\n\t * Async options loader for select-type fields.\n\t * Dependencies are automatically detected via Proxy tracking.\n\t *\n\t * @example\n\t * ```ts\n\t * subcategory: r.select({\n\t *   loadOptions: async (values) => {\n\t *     // Automatically re-fetches when values.category changes\n\t *     return fetchSubcategories(values.category);\n\t *   },\n\t * })\n\t * ```\n\t */\n\tloadOptions?: (values: Record<string, any>) => Promise<SelectOption[]>;\n}\n\n/**\n * Select field option\n */\nexport interface SelectOption {\n\tlabel: I18nText;\n\tvalue: string | number | boolean;\n\tdisabled?: boolean;\n}\n\n/**\n * Relation field configuration\n */\nexport interface RelationFieldConfig {\n\t/**\n\t * Target collection name\n\t */\n\ttargetCollection: string;\n\n\t/**\n\t * Display mode\n\t */\n\tmode?: \"inline\" | \"picker\" | \"create\";\n\n\t/**\n\t * Whether multiple items can be selected\n\t */\n\tmultiple?: boolean;\n\n\t/**\n\t * Whether items can be reordered\n\t */\n\torderable?: boolean;\n\n\t/**\n\t * Filter for relation options\n\t */\n\tfilter?: (values: Record<string, any>) => Record<string, any>;\n}\n\n/**\n * Embedded collection configuration\n */\nexport interface EmbeddedFieldConfig {\n\t/**\n\t * Target collection name\n\t */\n\tcollection: string;\n\n\t/**\n\t * Display mode\n\t */\n\tmode?: \"inline\" | \"modal\" | \"drawer\";\n\n\t/**\n\t * Whether items can be reordered\n\t */\n\torderable?: boolean;\n\n\t/**\n\t * Function to generate row labels\n\t */\n\trowLabel?: (item: any) => string;\n}\n\n/**\n * Rich text editor configuration\n */\nexport interface RichTextConfig {\n\t/**\n\t * Enable image uploads\n\t */\n\tenableImages?: boolean;\n\n\t/**\n\t * Show character count\n\t */\n\tshowCharacterCount?: boolean;\n\n\t/**\n\t * Maximum characters\n\t */\n\tmaxCharacters?: number;\n\n\t/**\n\t * Feature toggles\n\t */\n\tfeatures?: {\n\t\tslashCommands?: boolean;\n\t\ttableControls?: boolean;\n\t\tbubbleMenu?: boolean;\n\t};\n\n\t/**\n\t * Image upload handler\n\t */\n\tonImageUpload?: (file: File) => Promise<string>;\n}\n\n/**\n * Array field configuration\n */\nexport interface ArrayFieldConfig {\n\t/**\n\t * Placeholder text for items\n\t */\n\tplaceholder?: string;\n\n\t/**\n\t * Type of items in array\n\t */\n\titemType?: string;\n\n\t/**\n\t * Options for select-type items\n\t */\n\toptions?: SelectOption[];\n\n\t/**\n\t * Whether items can be reordered\n\t */\n\torderable?: boolean;\n\n\t/**\n\t * Minimum items\n\t */\n\tminItems?: number;\n\n\t/**\n\t * Maximum items\n\t */\n\tmaxItems?: number;\n}\n\n// ============================================================================\n// Field Layout Configuration - Mirrors Object Field API\n// ============================================================================\n\n/**\n * Layout mode - controls spatial arrangement of fields\n * Mirrors ObjectFieldLayout from field components\n *\n * - `\"stack\"` - Vertical layout, each field on its own line\n * - `\"inline\"` - Horizontal flexbox, fields side-by-side with wrapping\n * - `\"grid\"` - CSS Grid with configurable columns\n *\n * @see ObjectFieldLayout in field-types.ts for detailed visual examples\n */\nexport type LayoutMode = \"stack\" | \"inline\" | \"grid\";\n\n/**\n * Wrapper mode - controls container visual appearance\n * Mirrors ObjectFieldWrapper from field components\n *\n * - `\"flat\"` - No visual container, fields render directly\n * - `\"collapsible\"` - Accordion-style expandable container\n *\n * @see ObjectFieldWrapper in field-types.ts for detailed visual examples\n */\nexport type WrapperMode = \"flat\" | \"collapsible\";\n\n/**\n * Section layout - universal container for grouping fields\n *\n * Mirrors object field API exactly:\n * - wrapper: visual container style (flat | collapsible)\n * - layout: field arrangement (stack | inline | grid)\n * - columns: for grid layout\n * - defaultCollapsed: for collapsible wrapper\n *\n * @example Simple section with label\n * ```ts\n * {\n *   type: 'section',\n *   label: 'Contact Information',\n *   fields: [f.name, f.email, f.phone]\n * }\n * ```\n *\n * @example Grid layout (acts as \"row\")\n * ```ts\n * {\n *   type: 'section',\n *   layout: 'grid',\n *   columns: 2,\n *   fields: [f.firstName, f.lastName]\n * }\n * ```\n *\n * @example Collapsible section\n * ```ts\n * {\n *   type: 'section',\n *   label: 'Advanced Settings',\n *   wrapper: 'collapsible',\n *   defaultCollapsed: true,\n *   fields: [f.apiKey, f.webhookUrl]\n * }\n * ```\n *\n * @example Collapsible + Grid\n * ```ts\n * {\n *   type: 'section',\n *   label: 'Address',\n *   wrapper: 'collapsible',\n *   layout: 'grid',\n *   columns: 2,\n *   fields: [f.street, f.city, f.zip, f.country]\n * }\n * ```\n */\nexport interface SectionLayout<TData = any> {\n\ttype: \"section\";\n\n\t// Visual grouping\n\tlabel?: DynamicI18nText;\n\tdescription?: DynamicI18nText;\n\n\t// Wrapper (mirrors object field)\n\twrapper?: WrapperMode;\n\tdefaultCollapsed?: boolean;\n\n\t// Layout (mirrors object field)\n\tlayout?: LayoutMode;\n\tcolumns?: number;\n\tgap?: number;\n\n\t// Content\n\tfields: FieldLayoutItem<TData>[];\n\n\t// Conditional visibility (hidden: false/undefined = visible, true = hidden)\n\thidden?: boolean | ((values: Record<string, any>) => boolean);\n\n\t// Custom styling\n\tclassName?: string;\n}\n\n/**\n * Tab configuration for tabbed forms\n */\nexport interface TabConfig<TData = any> {\n\tid: string;\n\tlabel: DynamicI18nText;\n\ticon?: IconComponent | ComponentReference;\n\tfields: FieldLayoutItem<TData>[];\n\t// Conditional visibility (hidden: false/undefined = visible, true = hidden)\n\thidden?: boolean | ((values: Record<string, any>) => boolean);\n}\n\n/**\n * Tabs layout container for tabbed forms.\n */\nexport interface TabsLayout<TData = any> {\n\ttype: \"tabs\";\n\ttabs: TabConfig<TData>[];\n}\n\n/**\n * Context passed to reactive handlers.\n */\nexport interface FieldReactiveContext<TData = any> {\n\tdata: TData;\n\tsibling: Record<string, any>;\n\tctx?: Record<string, any>;\n\tprev?: {\n\t\tdata: TData;\n\t\tsibling: Record<string, any>;\n\t};\n}\n\n/**\n * Reactive handler config (short function form or object form).\n */\nexport type FieldReactiveHandlerConfig<TData = any, TReturn = any> =\n\t| ((ctx: FieldReactiveContext<TData>) => TReturn | Promise<TReturn>)\n\t| {\n\t\t\thandler: (ctx: FieldReactiveContext<TData>) => TReturn | Promise<TReturn>;\n\t\t\tdeps?: string[] | ((ctx: { data: TData }) => any[]);\n\t\t\tdebounce?: number;\n\t  };\n\n/**\n * Serialized reactive config from server introspection.\n */\nexport interface SerializedReactiveDepsConfig {\n\tdeps: string[];\n\tdebounce?: number;\n}\n\n/**\n * Reactive field config for form layout.\n * Handlers are executed server-side; deps tracked for client reactivity.\n */\nexport interface FieldReactiveConfig<TData = any> {\n\t/** Hide field conditionally */\n\thidden?:\n\t\t| boolean\n\t\t| FieldReactiveHandlerConfig<TData, boolean>\n\t\t| SerializedReactiveDepsConfig;\n\t/** Make field read-only conditionally */\n\treadOnly?:\n\t\t| boolean\n\t\t| FieldReactiveHandlerConfig<TData, boolean>\n\t\t| SerializedReactiveDepsConfig;\n\t/** Disable field conditionally */\n\tdisabled?:\n\t\t| boolean\n\t\t| FieldReactiveHandlerConfig<TData, boolean>\n\t\t| SerializedReactiveDepsConfig;\n\t/** Auto-compute field value */\n\tcompute?:\n\t\t| FieldReactiveHandlerConfig<TData, any>\n\t\t| SerializedReactiveDepsConfig;\n}\n\n/**\n * Field layout item with optional reactive config\n */\nexport interface FieldLayoutItemWithReactive<TData = any>\n\textends FieldReactiveConfig<TData> {\n\tfield: string;\n\tclassName?: string;\n}\n\n/**\n * Field layout item - can be a simple field name, field with config, section, or tabs\n *\n * @example\n * ```ts\n * fields: [\n *   f.name,  // simple field reference\n *   { field: f.email, className: 'col-span-2' },  // with className\n *   { field: f.slug, compute: { handler: ({ data }) => slugify(data.name), deps: ['name'] } },  // with compute\n *   { field: f.reason, hidden: ({ data }) => data.status !== 'cancelled' },  // with hidden\n *   { type: 'section', layout: 'grid', columns: 2, fields: [...] },  // section\n *   { type: 'tabs', tabs: [...] }  // tabs\n * ]\n * ```\n */\nexport type FieldLayoutItem<TData = any> =\n\t| string\n\t| FieldLayoutItemWithReactive<TData>\n\t| SectionLayout<TData>\n\t| TabsLayout<TData>;\n\n/**\n * Helper to check if item is a field reference (string or object with field)\n */\nexport function isFieldReference<TData = any>(\n\titem: FieldLayoutItem<TData>,\n): item is string | FieldLayoutItemWithReactive<TData> {\n\treturn typeof item === \"string\" || (\"field\" in item && !(\"type\" in item));\n}\n\n/**\n * Helper to get field name from layout item\n */\nexport function getFieldName<TData = any>(\n\titem: FieldLayoutItem<TData>,\n): string | null {\n\tif (typeof item === \"string\") return item;\n\tif (\"field\" in item && typeof item.field === \"string\") return item.field;\n\treturn null;\n}\n\n/**\n * Helper to get className from field layout item\n */\nexport function getFieldClassName<TData = any>(\n\titem: FieldLayoutItem<TData>,\n): string | undefined {\n\treturn typeof item === \"string\"\n\t\t? undefined\n\t\t: \"className\" in item\n\t\t\t? item.className\n\t\t\t: undefined;\n}\n\n// ============================================================================\n// Form View Configuration\n// ============================================================================\n\n/**\n * Form sidebar configuration\n * Uses `fields` array (same structure as main form)\n */\nexport interface FormSidebarConfig<TData = any> {\n\tposition?: \"left\" | \"right\";\n\tfields: FieldLayoutItem<TData>[];\n}\n\n/**\n * Form view configuration\n * Uses `fields` array for main content\n *\n * @example\n * ```ts\n * .form(({ v, f }) => v.form({\n *   sidebar: {\n *     position: 'right',\n *     fields: [f.status, f.publishedAt]\n *   },\n *   fields: [\n *     { type: 'section', layout: 'grid', columns: 2, fields: [f.name, f.email] },\n *     { type: 'section', label: 'Content', fields: [f.body] }\n *   ]\n * }))\n * ```\n */\nexport interface FormViewConfig<TData = any> {\n\tfields: FieldLayoutItem<TData>[];\n\tsidebar?: FormSidebarConfig<TData>;\n\tactions?: FormViewActionsConfig;\n}\n\n/**\n * Actions configuration for form views\n *\n * @example\n * ```ts\n * actions: {\n *   primary: [a.action({ id: \"publish\", label: \"Publish\" })],  // Buttons next to Save\n *   secondary: [a.action({ id: \"delete\", label: \"Delete\" })],  // In dropdown menu (...)\n * }\n * ```\n */\nexport interface FormViewActionsConfig<TItem = any> {\n\t/** Actions shown as buttons (next to Save) */\n\tprimary?: ActionDefinition<TItem>[];\n\t/** Actions shown in dropdown menu (...) */\n\tsecondary?: ActionDefinition<TItem>[];\n}\n\n// ============================================================================\n// Component Registry\n// ============================================================================\n\n/**\n * Registry for custom field and widget components\n */\nexport interface ComponentRegistry {\n\t/**\n\t * Custom field components by type\n\t */\n\tfields?: Record<string, MaybeLazyComponent<FieldComponentProps>>;\n\n\t/**\n\t * Custom widget components by type\n\t */\n\twidgets?: Record<string, MaybeLazyComponent<any>>;\n\n\t/**\n\t * Custom named components (for component prop on fields)\n\t */\n\tcustom?: Record<string, MaybeLazyComponent<any>>;\n}\n"],"mappings":";;;;AAkrBA,SAAgB,iBACf,MACsD;AACtD,QAAO,OAAO,SAAS,YAAa,WAAW,QAAQ,EAAE,UAAU;;;;;AAMpE,SAAgB,aACf,MACgB;AAChB,KAAI,OAAO,SAAS,SAAU,QAAO;AACrC,KAAI,WAAW,QAAQ,OAAO,KAAK,UAAU,SAAU,QAAO,KAAK;AACnE,QAAO"}

package/dist/client/builder/types/global-types.d.mts

@@ -0,0 +1,22 @@
+import { I18nText } from "../../i18n/types.mjs";
+import { IconComponent } from "./common.mjs";
+import { ComponentReference } from "../../../server/augmentation.mjs";
+import "../../../server/index.mjs";
+import { AdminBuilder } from "../admin-builder.mjs";
+
+//#region src/client/builder/types/global-types.d.ts
+
+interface GlobalBuilderState<TAdminApp extends AdminBuilder<any> = AdminBuilder<any>> {
+  readonly name: string;
+  readonly "~adminApp": TAdminApp;
+  /** Display label - supports inline translations */
+  readonly label?: I18nText;
+  /** Description - supports inline translations */
+  readonly description?: I18nText;
+  readonly icon?: IconComponent | ComponentReference;
+  readonly fields?: Record<string, any>;
+  readonly form?: any;
+}
+//#endregion
+export { GlobalBuilderState };
+//# sourceMappingURL=global-types.d.mts.map

package/dist/client/builder/types/global-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-types.d.mts","names":[],"sources":["../../../../src/client/builder/types/global-types.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAsEiB,qCACG,oBAAoB;;wBAGhB;;mBAEL;;yBAEM;kBACP,gBAAgB;oBACd"}

package/dist/client/builder/types/ui-config.d.mts

@@ -0,0 +1,160 @@
+import "../../i18n/types.mjs";
+import { DynamicI18nText, IconComponent } from "./common.mjs";
+import { ComponentReference } from "../../../server/augmentation.mjs";
+import "../../../server/index.mjs";
+import { WidgetConfig } from "./widget-types.mjs";
+
+//#region src/client/builder/types/ui-config.d.ts
+
+/**
+ * Dashboard action item - simplified action for dashboard header
+ */
+interface DashboardAction {
+  /** Unique action ID */
+  id: string;
+  /** Action label */
+  label: DynamicI18nText;
+  /** Action icon */
+  icon?: IconComponent | ComponentReference;
+  /** Link URL */
+  href?: string;
+  /** Click handler */
+  onClick?: () => void;
+  /** Visual variant */
+  variant?: "default" | "primary" | "secondary" | "outline" | "ghost";
+}
+/**
+ * Widget card visual variant
+ */
+type WidgetCardVariant = "default" | "compact" | "featured";
+/**
+ * Dashboard layout item - can be a widget, section, or tabs
+ */
+type DashboardLayoutItem = WidgetConfig | DashboardSection | DashboardTabs;
+/**
+ * Dashboard section - groups widgets together
+ *
+ * @example
+ * ```ts
+ * {
+ *   type: "section",
+ *   label: { en: "Sales Overview", sk: "Prehľad predaja" },
+ *   layout: "grid",
+ *   columns: 3,
+ *   items: [
+ *     { type: "stats", ... },
+ *     { type: "chart", ... },
+ *   ]
+ * }
+ * ```
+ */
+interface DashboardSection {
+  type: "section";
+  /** Section label */
+  label?: DynamicI18nText;
+  /** Section description */
+  description?: DynamicI18nText;
+  /** Section icon */
+  icon?: IconComponent | ComponentReference;
+  /** Wrapper style */
+  wrapper?: "flat" | "card" | "collapsible";
+  /** Whether collapsed by default (for collapsible wrapper) */
+  defaultCollapsed?: boolean;
+  /** Layout mode */
+  layout?: "grid" | "stack";
+  /** Grid columns (for grid layout) */
+  columns?: number;
+  /** Gap between items */
+  gap?: number;
+  /** Section items */
+  items: DashboardLayoutItem[];
+  /** Custom CSS class */
+  className?: string;
+}
+/**
+ * Dashboard tabs - tabbed widget groups
+ *
+ * @example
+ * ```ts
+ * {
+ *   type: "tabs",
+ *   tabs: [
+ *     {
+ *       id: "overview",
+ *       label: { en: "Overview", sk: "Prehľad" },
+ *       items: [...widgets]
+ *     },
+ *     {
+ *       id: "analytics",
+ *       label: { en: "Analytics", sk: "Analytika" },
+ *       items: [...widgets]
+ *     }
+ *   ]
+ * }
+ * ```
+ */
+interface DashboardTabs {
+  type: "tabs";
+  /** Tab configurations */
+  tabs: DashboardTabConfig[];
+  /** Default active tab ID */
+  defaultTab?: string;
+  /** Tabs visual variant */
+  variant?: "default" | "line" | "pills";
+}
+/**
+ * Single tab configuration
+ */
+interface DashboardTabConfig {
+  /** Unique tab ID */
+  id: string;
+  /** Tab label */
+  label: DynamicI18nText;
+  /** Tab icon */
+  icon?: IconComponent | ComponentReference;
+  /** Tab items (widgets or sections) */
+  items: DashboardLayoutItem[];
+  /** Badge text (e.g., count) */
+  badge?: string | number;
+}
+/**
+ * Dashboard configuration
+ */
+interface DashboardConfig {
+  /** Dashboard layout mode */
+  layout?: "grid" | "list";
+  /** Dashboard title - supports inline translations */
+  title?: DynamicI18nText;
+  /** Dashboard description - supports inline translations */
+  description?: DynamicI18nText;
+  /** Grid columns (default: 4) */
+  columns?: number;
+  /** Gap between widgets */
+  gap?: number;
+  /** Dashboard items - widgets, sections, or tabs */
+  items?: DashboardLayoutItem[];
+  /**
+   * @deprecated Use `items` instead
+   */
+  widgets?: WidgetConfig[];
+  /** Default widget card variant */
+  defaultCardVariant?: WidgetCardVariant;
+  /** Show refresh button in header */
+  showRefresh?: boolean;
+  /** Auto-refresh interval in milliseconds */
+  refreshInterval?: number;
+  /** Enable realtime invalidation for dashboard widgets by default */
+  realtime?: boolean;
+  /** Header actions (buttons in dashboard header) */
+  actions?: DashboardAction[];
+}
+/**
+ * Locale configuration
+ */
+interface LocaleConfig {
+  default?: string;
+  supported?: string[];
+}
+//#endregion
+export { DashboardAction, DashboardConfig, DashboardLayoutItem, DashboardSection, DashboardTabConfig, DashboardTabs, LocaleConfig };
+//# sourceMappingURL=ui-config.d.mts.map

package/dist/client/builder/types/ui-config.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-config.d.mts","names":[],"sources":["../../../../src/client/builder/types/ui-config.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAwCY,UAtBK,eAAA,CAsBY;EAKjB;EACT,EAAA,EAAA,MAAA;EACA;EACA,KAAA,EA1BK,eA0BL;EAAa;EAmBC,IAAA,CAAA,EA3CT,aA2CyB,GA3CT,kBA2CS;EAGxB;EAEM,IAAA,CAAA,EAAA,MAAA;EAEP;EAAgB,OAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EAYhB;EAAmB,OAAA,CAAA,EAAA,SAAA,GAAA,SAAA,GAAA,WAAA,GAAA,SAAA,GAAA,OAAA;AA2B3B;AAaA;;;AAMwB,KA5FZ,iBAAA,GA4FY,SAAA,GAAA,SAAA,GAAA,UAAA;;;AAUxB;AAIS,KArGG,mBAAA,GACT,YAoGM,GAnGN,gBAmGM,GAlGN,aAkGM;;;;;;;AA4HT;;;;;;;;;;;UA3MiB,gBAAA;;;UAGR;;gBAEM;;SAEP,gBAAgB;;;;;;;;;;;;SAYhB;;;;;;;;;;;;;;;;;;;;;;;;;;UA2BS,aAAA;;;QAGV;;;;;;;;;UAUU,kBAAA;;;;SAIT;;SAEA,gBAAgB;;SAEhB;;;;;;;UAQS,eAAA;;;;UAIR;;gBAEM;;;;;;UAMN;;;;YAIE;;uBAEW;;;;;;;;YAQX;;;;;UAsGM,YAAA"}

package/dist/client/builder/types/views.d.mts

@@ -0,0 +1,89 @@
+import { ComponentRegistry, FormViewConfig } from "./field-types.mjs";
+import { ListViewConfig } from "./collection-types.mjs";
+import * as React$1 from "react";
+
+//#region src/client/builder/types/views.d.ts
+type ViewBaseProps = {
+  navigate: (path: string) => void;
+  basePath?: string;
+  config?: Record<string, any>;
+  viewConfig?: ListViewConfig | FormViewConfig;
+  registry?: ComponentRegistry;
+};
+interface CollectionListViewProps {
+  collection: string;
+  baseFindOptions?: any;
+  realtime?: boolean;
+  headerActions?: React$1.ReactNode;
+  onRowClick?: (item: any) => void;
+  config?: ViewBaseProps["config"];
+  viewConfig?: ListViewConfig;
+  navigate: ViewBaseProps["navigate"];
+  basePath?: ViewBaseProps["basePath"];
+}
+interface CollectionFormViewProps {
+  collection: string;
+  id?: string;
+  title?: string;
+  headerActions?: React$1.ReactNode;
+  onSuccess?: (data?: any) => void;
+  onCancel?: () => void;
+  onError?: (error: Error) => void;
+  defaultValues?: Record<string, any>;
+  allCollectionsConfig?: Record<string, any>;
+  config?: ViewBaseProps["config"];
+  viewConfig?: FormViewConfig;
+  navigate: ViewBaseProps["navigate"];
+  basePath?: ViewBaseProps["basePath"];
+  registry?: ViewBaseProps["registry"];
+  children?: React$1.ReactNode;
+}
+interface GlobalFormViewProps {
+  global: string;
+  title?: string;
+  description?: string;
+  headerActions?: React$1.ReactNode;
+  onSuccess?: (data?: any) => void;
+  onError?: (error: Error) => void;
+  allGlobalsConfig?: Record<string, any>;
+  config?: ViewBaseProps["config"];
+  viewConfig?: FormViewConfig;
+  navigate: ViewBaseProps["navigate"];
+  basePath?: ViewBaseProps["basePath"];
+  registry?: ViewBaseProps["registry"];
+  children?: React$1.ReactNode;
+}
+interface DefaultViewsConfig {
+  dashboard?: {
+    component?: React$1.ComponentType;
+    header?: {
+      title?: string;
+      showDate?: boolean;
+    };
+    welcomeCard?: {
+      title?: string;
+      description?: string;
+    };
+  };
+  collectionList?: {
+    component?: React$1.ComponentType<CollectionListViewProps>;
+    showSearch?: boolean;
+    showFilters?: boolean;
+    showToolbar?: boolean;
+    realtime?: boolean;
+    emptyState?: React$1.ComponentType;
+  };
+  collectionForm?: {
+    component?: React$1.ComponentType<CollectionFormViewProps>;
+    showMeta?: boolean;
+    showStatus?: boolean;
+    sidebarFields?: string[];
+  };
+  globalForm?: {
+    component?: React$1.ComponentType<GlobalFormViewProps>;
+    layout?: "single" | "sidebar";
+  };
+}
+//#endregion
+export { DefaultViewsConfig };
+//# sourceMappingURL=views.d.mts.map

package/dist/client/builder/types/views.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.mts","names":[],"sources":["../../../../src/client/builder/types/views.ts"],"sourcesContent":[],"mappings":";;;;;KAIK,aAAA;;EAAA,QAAA,CAAA,EAAA,MAAa;EAGR,MAAA,CAAA,EAAA,MAAA,CAAA,MAAA,EAAA,GAAA,CAAA;EACI,UAAA,CAAA,EAAA,cAAA,GAAiB,cAAjB;EAAiB,QAAA,CAAA,EACnB,iBADmB;CACnB;AAAiB,UAGZ,uBAAA,CAHY;EAGZ,UAAA,EAAA,MAAA;EAIA,eAAM,CAAA,EAAA,GAAA;EAEb,QAAA,CAAA,EAAA,OAAA;EACI,aAAA,CAAA,EAHG,OAAA,CAAM,SAGT;EACH,UAAA,CAAA,EAAA,CAAA,IAAA,EAAA,GAAA,EAAA,GAAA,IAAA;EACC,MAAA,CAAA,EAHF,aAGE,CAAA,QAAA,CAAA;EAAa,UAAA,CAAA,EAFX,cAEW;EAGR,QAAA,EAJN,aAIM,CAAA,UAAuB,CAAA;EAIvB,QAAM,CAAA,EAPX,aAOW,CAAA,UAAA,CAAA;;AAIN,UARA,uBAAA,CAQA;EACO,UAAA,EAAA,MAAA;EACd,EAAA,CAAA,EAAA,MAAA;EACI,KAAA,CAAA,EAAA,MAAA;EACH,aAAA,CAAA,EARM,OAAA,CAAM,SAQZ;EACC,SAAA,CAAA,EAAA,CAAA,IAAA,CAAA,EAAA,GAAA,EAAA,GAAA,IAAA;EACA,QAAA,CAAA,EAAA,GAAA,GAAA,IAAA;EACA,OAAM,CAAA,EAAA,CAAA,KAAA,EARC,KAQD,EAAA,GAAA,IAAA;EAAS,aAAA,CAAA,EAPV,MAOU,CAAA,MAAA,EAAA,GAAA,CAAA;EAGV,oBAAA,CAAA,EATO,MASY,CAAA,MAAA,EAAA,GAAA,CAAA;EAInB,MAAM,CAAA,EAZb,aAYa,CAAA,QAAA,CAAA;EAEJ,UAAA,CAAA,EAbL,cAaK;EACC,QAAA,EAbT,aAaS,CAAA,UAAA,CAAA;EACV,QAAA,CAAA,EAbE,aAaF,CAAA,UAAA,CAAA;EACI,QAAA,CAAA,EAbF,aAaE,CAAA,UAAA,CAAA;EACH,QAAA,CAAA,EAbC,OAAA,CAAM,SAaP;;AAEC,UAZK,mBAAA,CAYL;EACA,MAAM,EAAA,MAAA;EAAS,KAAA,CAAA,EAAA,MAAA;EAGV,WAAA,CAAA,EAAA,MAAA;EAEH,aAAM,CAAA,EAdH,OAAA,CAAM,SAcH;EAYc,SAAA,CAAA,EAAA,CAAA,IAAA,CAAA,EAAA,GAAA,EAAA,GAAA,IAAA;EAApB,OAAM,CAAA,EAAA,CAAA,KAAA,EAxBD,KAwBC,EAAA,GAAA,IAAA;EAKL,gBAAM,CAAA,EA5BD,MA4BC,CAAA,MAAA,EAAA,GAAA,CAAA;EAIa,MAAA,CAAA,EA/BxB,aA+BwB,CAAA,QAAA,CAAA;EAApB,UAAM,CAAA,EA9BN,cA8BM;EAOc,QAAA,EApCvB,aAoCuB,CAAA,UAAA,CAAA;EAApB,QAAM,CAAA,EAnCR,aAmCQ,CAAA,UAAA,CAAA;EAAa,QAAA,CAAA,EAlCrB,aAkCqB,CAAA,UAAA,CAAA;aAjCrB,OAAA,CAAM;;UAGD,kBAAA;;gBAEH,OAAA,CAAM;;;;;;;;;;;gBAYN,OAAA,CAAM,cAAc;;;;;iBAKnB,OAAA,CAAM;;;gBAIP,OAAA,CAAM,cAAc;;;;;;gBAOpB,OAAA,CAAM,cAAc"}