@object-ui/types 0.3.1 → 0.5.0

package/dist/views.d.ts

@@ -0,0 +1,417 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * @object-ui/types - View Component Schemas
+ *
+ * Type definitions for various view components (List, Detail, Grid, Kanban, Calendar).
+ * These schemas enable building different data visualization interfaces.
+ *
+ * @module views
+ * @packageDocumentation
+ */
+import type { BaseSchema, SchemaNode } from './base';
+import type { ActionSchema } from './crud';
+import type { TableColumn } from './data-display';
+/**
+ * View Type
+ */
+export type ViewType = 'list' | 'detail' | 'grid' | 'kanban' | 'calendar' | 'timeline' | 'map';
+/**
+ * Detail View Field Configuration
+ */
+export interface DetailViewField {
+    /**
+     * Field name/path
+     */
+    name: string;
+    /**
+     * Display label
+     */
+    label?: string;
+    /**
+     * Field type for rendering
+     */
+    type?: 'text' | 'image' | 'link' | 'badge' | 'date' | 'datetime' | 'json' | 'html' | 'markdown' | 'custom';
+    /**
+     * Format string (e.g., date format)
+     */
+    format?: string;
+    /**
+     * Custom renderer
+     */
+    render?: SchemaNode;
+    /**
+     * Field value
+     */
+    value?: any;
+    /**
+     * Whether field is read-only
+     */
+    readonly?: boolean;
+    /**
+     * Field visibility condition
+     */
+    visible?: boolean | string;
+    /**
+     * Span across columns (for grid layout)
+     */
+    span?: number;
+}
+/**
+ * Detail View Section/Group
+ */
+export interface DetailViewSection {
+    /**
+     * Section title
+     */
+    title?: string;
+    /**
+     * Section description
+     */
+    description?: string;
+    /**
+     * Section icon
+     */
+    icon?: string;
+    /**
+     * Fields in this section
+     */
+    fields: DetailViewField[];
+    /**
+     * Collapsible section
+     */
+    collapsible?: boolean;
+    /**
+     * Default collapsed state
+     */
+    defaultCollapsed?: boolean;
+    /**
+     * Grid columns for field layout
+     */
+    columns?: number;
+    /**
+     * Section visibility condition
+     */
+    visible?: boolean | string;
+}
+/**
+ * Detail View Tab
+ */
+export interface DetailViewTab {
+    /**
+     * Tab key/identifier
+     */
+    key: string;
+    /**
+     * Tab label
+     */
+    label: string;
+    /**
+     * Tab icon
+     */
+    icon?: string;
+    /**
+     * Tab content
+     */
+    content: SchemaNode | SchemaNode[];
+    /**
+     * Tab visibility condition
+     */
+    visible?: boolean | string;
+    /**
+     * Badge count
+     */
+    badge?: string | number;
+}
+/**
+ * Detail View Schema - Display detailed information about a single record
+ * Enhanced in Phase 2 with better organization and features
+ */
+export interface DetailViewSchema extends BaseSchema {
+    type: 'detail-view';
+    /**
+     * Detail title
+     */
+    title?: string;
+    /**
+     * API endpoint to fetch detail data
+     */
+    api?: string;
+    /**
+     * Resource ID to display
+     */
+    resourceId?: string | number;
+    /**
+     * Object name (for ObjectQL integration)
+     */
+    objectName?: string;
+    /**
+     * Data to display (if not fetching from API)
+     */
+    data?: any;
+    /**
+     * Layout mode
+     */
+    layout?: 'vertical' | 'horizontal' | 'grid';
+    /**
+     * Grid columns (for grid layout)
+     */
+    columns?: number;
+    /**
+     * Field sections for organized display
+     */
+    sections?: DetailViewSection[];
+    /**
+     * Direct fields (without sections)
+     */
+    fields?: DetailViewField[];
+    /**
+     * Actions available in detail view
+     */
+    actions?: ActionSchema[];
+    /**
+     * Tabs for additional content
+     */
+    tabs?: DetailViewTab[];
+    /**
+     * Show back button
+     * @default true
+     */
+    showBack?: boolean;
+    /**
+     * Back button URL
+     */
+    backUrl?: string;
+    /**
+     * Custom back action
+     */
+    onBack?: string;
+    /**
+     * Show edit button
+     */
+    showEdit?: boolean;
+    /**
+     * Edit button URL
+     */
+    editUrl?: string;
+    /**
+     * Show delete button
+     */
+    showDelete?: boolean;
+    /**
+     * Delete confirmation message
+     */
+    deleteConfirmation?: string;
+    /**
+     * Whether to show loading state
+     * @default true
+     */
+    loading?: boolean;
+    /**
+     * Custom header content
+     */
+    header?: SchemaNode;
+    /**
+     * Custom footer content
+     */
+    footer?: SchemaNode;
+    /**
+     * Related records section
+     */
+    related?: Array<{
+        /**
+         * Relation title
+         */
+        title: string;
+        /**
+         * Relation type
+         */
+        type: 'list' | 'grid' | 'table';
+        /**
+         * API endpoint for related data
+         */
+        api?: string;
+        /**
+         * Static data
+         */
+        data?: any[];
+        /**
+         * Columns for table view
+         */
+        columns?: TableColumn[];
+        /**
+         * Fields for list view
+         */
+        fields?: string[];
+    }>;
+}
+/**
+ * View Switcher Schema - Toggle between different view modes
+ * New in Phase 2
+ */
+export interface ViewSwitcherSchema extends BaseSchema {
+    type: 'view-switcher';
+    /**
+     * Available view types
+     */
+    views: Array<{
+        /**
+         * View type
+         */
+        type: ViewType;
+        /**
+         * View label
+         */
+        label?: string;
+        /**
+         * View icon
+         */
+        icon?: string;
+        /**
+         * View schema
+         */
+        schema?: SchemaNode;
+    }>;
+    /**
+     * Default/active view
+     */
+    defaultView?: ViewType;
+    /**
+     * Current active view
+     */
+    activeView?: ViewType;
+    /**
+     * Switcher variant
+     */
+    variant?: 'tabs' | 'buttons' | 'dropdown';
+    /**
+     * Switcher position
+     */
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    /**
+     * View change callback
+     */
+    onViewChange?: string;
+    /**
+     * Persist view preference
+     */
+    persistPreference?: boolean;
+    /**
+     * Storage key for persisting view
+     */
+    storageKey?: string;
+}
+/**
+ * Filter UI Schema - Enhanced filter interface
+ * New in Phase 2
+ */
+export interface FilterUISchema extends BaseSchema {
+    type: 'filter-ui';
+    /**
+     * Available filters
+     */
+    filters: Array<{
+        /**
+         * Filter field
+         */
+        field: string;
+        /**
+         * Filter label
+         */
+        label?: string;
+        /**
+         * Filter type
+         */
+        type: 'text' | 'number' | 'select' | 'date' | 'date-range' | 'boolean';
+        /**
+         * Filter operator
+         */
+        operator?: 'equals' | 'contains' | 'startsWith' | 'gt' | 'lt' | 'between' | 'in';
+        /**
+         * Options for select filter
+         */
+        options?: Array<{
+            label: string;
+            value: any;
+        }>;
+        /**
+         * Placeholder
+         */
+        placeholder?: string;
+    }>;
+    /**
+     * Current filter values
+     */
+    values?: Record<string, any>;
+    /**
+     * Filter change callback
+     */
+    onChange?: string;
+    /**
+     * Show clear button
+     */
+    showClear?: boolean;
+    /**
+     * Show apply button
+     */
+    showApply?: boolean;
+    /**
+     * Filter layout
+     */
+    layout?: 'inline' | 'popover' | 'drawer';
+}
+/**
+ * Sort UI Schema - Enhanced sort interface
+ * New in Phase 2
+ */
+export interface SortUISchema extends BaseSchema {
+    type: 'sort-ui';
+    /**
+     * Sortable fields
+     */
+    fields: Array<{
+        /**
+         * Field name
+         */
+        field: string;
+        /**
+         * Field label
+         */
+        label?: string;
+    }>;
+    /**
+     * Current sort configuration
+     */
+    sort?: Array<{
+        /**
+         * Field to sort by
+         */
+        field: string;
+        /**
+         * Sort direction
+         */
+        direction: 'asc' | 'desc';
+    }>;
+    /**
+     * Sort change callback
+     */
+    onChange?: string;
+    /**
+     * Allow multiple sort fields
+     */
+    multiple?: boolean;
+    /**
+     * UI variant
+     */
+    variant?: 'dropdown' | 'buttons';
+}
+/**
+ * Union type of all view schemas
+ */
+export type ViewComponentSchema = DetailViewSchema | ViewSwitcherSchema | FilterUISchema | SortUISchema;
+//# sourceMappingURL=views.d.ts.map

package/dist/views.d.ts.map

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

package/dist/views.js

@@ -0,0 +1,8 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+export {};

package/dist/zod/app.zod.d.ts

@@ -0,0 +1,120 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * @object-ui/types/zod - Application Schema Zod Validators
+ *
+ * Zod validation schemas for top-level application configuration.
+ * Following @objectstack/spec UI specification format.
+ *
+ * @module zod/app
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * Menu Item Schema - Navigation menu item
+ */
+export declare const MenuItemSchema: z.ZodType<any>;
+/**
+ * App Action Schema - Application header/toolbar action
+ */
+export declare const AppActionSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        button: "button";
+        dropdown: "dropdown";
+        user: "user";
+    }>;
+    label: z.ZodOptional<z.ZodString>;
+    icon: z.ZodOptional<z.ZodString>;
+    onClick: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    items: z.ZodOptional<z.ZodArray<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+    shortcut: z.ZodOptional<z.ZodString>;
+    variant: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        destructive: "destructive";
+        outline: "outline";
+        secondary: "secondary";
+        ghost: "ghost";
+        link: "link";
+    }>>;
+    size: z.ZodOptional<z.ZodEnum<{
+        default: "default";
+        sm: "sm";
+        lg: "lg";
+        icon: "icon";
+    }>>;
+}, z.core.$strip>;
+/**
+ * App Schema - Top-level application configuration
+ */
+export declare const AppSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    className: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    data: z.ZodOptional<z.ZodAny>;
+    body: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodArray<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+    children: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodArray<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+    visible: z.ZodOptional<z.ZodBoolean>;
+    visibleOn: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodOptional<z.ZodBoolean>;
+    hiddenOn: z.ZodOptional<z.ZodString>;
+    disabled: z.ZodOptional<z.ZodBoolean>;
+    disabledOn: z.ZodOptional<z.ZodString>;
+    testId: z.ZodOptional<z.ZodString>;
+    ariaLabel: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"app">;
+    name: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    logo: z.ZodOptional<z.ZodString>;
+    favicon: z.ZodOptional<z.ZodString>;
+    layout: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
+        sidebar: "sidebar";
+        header: "header";
+        empty: "empty";
+    }>>>;
+    menu: z.ZodOptional<z.ZodArray<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<{
+            button: "button";
+            dropdown: "dropdown";
+            user: "user";
+        }>;
+        label: z.ZodOptional<z.ZodString>;
+        icon: z.ZodOptional<z.ZodString>;
+        onClick: z.ZodOptional<z.ZodString>;
+        avatar: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        items: z.ZodOptional<z.ZodArray<z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>>;
+        shortcut: z.ZodOptional<z.ZodString>;
+        variant: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            destructive: "destructive";
+            outline: "outline";
+            secondary: "secondary";
+            ghost: "ghost";
+            link: "link";
+        }>>;
+        size: z.ZodOptional<z.ZodEnum<{
+            default: "default";
+            sm: "sm";
+            lg: "lg";
+            icon: "icon";
+        }>>;
+    }, z.core.$strip>>>;
+}, z.core.$loose>;
+/**
+ * Export type inference helpers
+ */
+export type MenuItemSchemaType = z.infer<typeof MenuItemSchema>;
+export type AppActionSchemaType = z.infer<typeof AppActionSchema>;
+export type AppSchemaType = z.infer<typeof AppSchema>;
+//# sourceMappingURL=app.zod.d.ts.map

package/dist/zod/app.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.zod.d.ts","sourceRoot":"","sources":["../../src/zod/app.zod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CASvC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAW1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAUpB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAChE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC"}

package/dist/zod/app.zod.js

@@ -0,0 +1,60 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * @object-ui/types/zod - Application Schema Zod Validators
+ *
+ * Zod validation schemas for top-level application configuration.
+ * Following @objectstack/spec UI specification format.
+ *
+ * @module zod/app
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+import { BaseSchema } from './base.zod.js';
+/**
+ * Menu Item Schema - Navigation menu item
+ */
+export const MenuItemSchema = z.lazy(() => z.object({
+    type: z.enum(['item', 'group', 'separator']).optional().describe('Item type'),
+    label: z.string().optional().describe('Display label'),
+    icon: z.string().optional().describe('Icon name (Lucide)'),
+    path: z.string().optional().describe('Target path (route)'),
+    href: z.string().optional().describe('External link'),
+    children: z.array(MenuItemSchema).optional().describe('Child items (submenu)'),
+    badge: z.union([z.string(), z.number()]).optional().describe('Badge or count'),
+    hidden: z.union([z.boolean(), z.string()]).optional().describe('Visibility condition'),
+}));
+/**
+ * App Action Schema - Application header/toolbar action
+ */
+export const AppActionSchema = z.object({
+    type: z.enum(['button', 'dropdown', 'user']).describe('Action type'),
+    label: z.string().optional().describe('Action label'),
+    icon: z.string().optional().describe('Icon name'),
+    onClick: z.string().optional().describe('Click handler expression'),
+    avatar: z.string().optional().describe('User avatar URL (for type="user")'),
+    description: z.string().optional().describe('Additional description (e.g., email for user)'),
+    items: z.array(MenuItemSchema).optional().describe('Dropdown menu items (for type="dropdown" or "user")'),
+    shortcut: z.string().optional().describe('Keyboard shortcut'),
+    variant: z.enum(['default', 'destructive', 'outline', 'secondary', 'ghost', 'link']).optional().describe('Button variant'),
+    size: z.enum(['default', 'sm', 'lg', 'icon']).optional().describe('Button size'),
+});
+/**
+ * App Schema - Top-level application configuration
+ */
+export const AppSchema = BaseSchema.extend({
+    type: z.literal('app'),
+    name: z.string().optional().describe('Application name (system ID)'),
+    title: z.string().optional().describe('Display title'),
+    description: z.string().optional().describe('Application description'),
+    logo: z.string().optional().describe('Logo URL or icon name'),
+    favicon: z.string().optional().describe('Favicon URL'),
+    layout: z.enum(['sidebar', 'header', 'empty']).optional().default('sidebar').describe('Global layout strategy'),
+    menu: z.array(MenuItemSchema).optional().describe('Global navigation menu'),
+    actions: z.array(AppActionSchema).optional().describe('Global actions (user profile, settings, etc.)'),
+});