@object-ui/types 0.3.1 → 2.0.0

package/dist/workflow.d.ts

@@ -0,0 +1,340 @@
+/**
+ * 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 - Workflow Schema
+ *
+ * Defines workflow UI types for visual workflow design, approval processes,
+ * and workflow instance tracking.
+ */
+import type { BaseSchema } from './base';
+/**
+ * Workflow lifecycle status
+ */
+export type WorkflowStatus = 'draft' | 'active' | 'paused' | 'completed' | 'cancelled';
+/**
+ * Types of nodes available in the workflow designer
+ */
+export type WorkflowNodeType = 'start' | 'end' | 'task' | 'approval' | 'condition' | 'parallel' | 'delay' | 'notification' | 'script';
+/**
+ * Types of edges connecting workflow nodes
+ */
+export type WorkflowEdgeType = 'default' | 'conditional' | 'timeout';
+/**
+ * Action that can be performed on a workflow node
+ */
+export interface WorkflowNodeAction {
+    /**
+     * Action type
+     */
+    type: 'approve' | 'reject' | 'reassign' | 'comment' | 'escalate' | 'custom';
+    /**
+     * Display label for the action
+     */
+    label: string;
+    /**
+     * Target node to transition to after action
+     */
+    nextNodeId?: string;
+    /**
+     * Condition expression for action availability
+     */
+    condition?: string;
+}
+/**
+ * A node in the workflow graph
+ */
+export interface WorkflowNode {
+    /**
+     * Unique node identifier
+     */
+    id: string;
+    /**
+     * Node type
+     */
+    type: WorkflowNodeType;
+    /**
+     * Display label
+     */
+    label: string;
+    /**
+     * Node description
+     */
+    description?: string;
+    /**
+     * Position in the workflow canvas
+     */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Node-specific configuration
+     */
+    config?: Record<string, any>;
+    /**
+     * Assignee identifier
+     */
+    assignee?: string;
+    /**
+     * How the assignee is resolved
+     */
+    assigneeType?: 'user' | 'role' | 'group' | 'expression';
+    /**
+     * Timeout duration in minutes
+     */
+    timeout?: number;
+    /**
+     * Available actions for this node
+     */
+    actions?: WorkflowNodeAction[];
+}
+/**
+ * An edge connecting two workflow nodes
+ */
+export interface WorkflowEdge {
+    /**
+     * Unique edge identifier
+     */
+    id: string;
+    /**
+     * Source node identifier
+     */
+    source: string;
+    /**
+     * Target node identifier
+     */
+    target: string;
+    /**
+     * Edge type
+     */
+    type?: WorkflowEdgeType;
+    /**
+     * Display label
+     */
+    label?: string;
+    /**
+     * Condition expression for conditional edges
+     */
+    condition?: string;
+}
+/**
+ * Rule governing how approvals are processed
+ */
+export interface ApprovalRule {
+    /**
+     * Approval strategy type
+     */
+    type: 'any' | 'all' | 'majority' | 'sequential';
+    /**
+     * Minimum number of approvals required
+     */
+    minApprovals?: number;
+    /**
+     * Timeout duration in minutes
+     */
+    timeout?: number;
+    /**
+     * Identifier to escalate to on timeout
+     */
+    escalateTo?: string;
+    /**
+     * Expression that triggers automatic approval
+     */
+    autoApproveCondition?: string;
+}
+/**
+ * Variable definition for workflow context
+ */
+export interface WorkflowVariable {
+    /**
+     * Variable name
+     */
+    name: string;
+    /**
+     * Variable data type
+     */
+    type: 'string' | 'number' | 'boolean' | 'date' | 'object';
+    /**
+     * Default value
+     */
+    defaultValue?: any;
+    /**
+     * Whether the variable is required
+     */
+    required?: boolean;
+}
+/**
+ * Workflow Schema - Main workflow definition
+ */
+export interface WorkflowSchema extends BaseSchema {
+    type: 'workflow';
+    /**
+     * Workflow title
+     */
+    title?: string;
+    /**
+     * Workflow description
+     */
+    description?: string;
+    /**
+     * Current workflow status
+     */
+    status?: WorkflowStatus;
+    /**
+     * Workflow nodes
+     */
+    nodes: WorkflowNode[];
+    /**
+     * Workflow edges
+     */
+    edges: WorkflowEdge[];
+    /**
+     * Workflow variables
+     */
+    variables?: WorkflowVariable[];
+    /**
+     * Workflow version number
+     */
+    version?: number;
+}
+/**
+ * Workflow Designer Schema - Visual workflow editor component
+ */
+export interface WorkflowDesignerSchema extends BaseSchema {
+    type: 'workflow-designer';
+    /**
+     * Workflow to edit
+     */
+    workflow?: WorkflowSchema;
+    /**
+     * Whether the designer is in read-only mode
+     */
+    readOnly?: boolean;
+    /**
+     * Show minimap navigation panel
+     */
+    showMinimap?: boolean;
+    /**
+     * Show designer toolbar
+     */
+    showToolbar?: boolean;
+    /**
+     * Save callback action
+     */
+    onSave?: string;
+    /**
+     * Publish callback action
+     */
+    onPublish?: string;
+}
+/**
+ * A single entry in the approval history
+ */
+export interface ApprovalHistoryItem {
+    /**
+     * Node where the action was taken
+     */
+    nodeId: string;
+    /**
+     * Action that was performed
+     */
+    action: string;
+    /**
+     * Actor identifier
+     */
+    actor: string;
+    /**
+     * Display name of the actor
+     */
+    actorName?: string;
+    /**
+     * ISO 8601 timestamp of the action
+     */
+    timestamp: string;
+    /**
+     * Optional comment
+     */
+    comment?: string;
+}
+/**
+ * Approval Process Schema - Approval workflow UI component
+ */
+export interface ApprovalProcessSchema extends BaseSchema {
+    type: 'approval-process';
+    /**
+     * Associated workflow identifier
+     */
+    workflowId?: string;
+    /**
+     * Workflow instance identifier
+     */
+    instanceId?: string;
+    /**
+     * Current active node identifier
+     */
+    currentNodeId?: string;
+    /**
+     * Approval rule configuration
+     */
+    approvalRule?: ApprovalRule;
+    /**
+     * Approval history entries
+     */
+    history?: ApprovalHistoryItem[];
+    /**
+     * Approval process data
+     */
+    data?: Record<string, any>;
+    /**
+     * Show approval history timeline
+     */
+    showHistory?: boolean;
+    /**
+     * Show comments section
+     */
+    showComments?: boolean;
+}
+/**
+ * Workflow Instance Schema - Runtime state of a workflow execution
+ */
+export interface WorkflowInstanceSchema extends BaseSchema {
+    type: 'workflow-instance';
+    /**
+     * Associated workflow definition identifier
+     */
+    workflowId: string;
+    /**
+     * Unique instance identifier
+     */
+    instanceId: string;
+    /**
+     * Current instance status
+     */
+    status: WorkflowStatus;
+    /**
+     * Currently active node identifiers
+     */
+    currentNodes: string[];
+    /**
+     * Runtime variable values
+     */
+    variables?: Record<string, any>;
+    /**
+     * ISO 8601 timestamp when the instance started
+     */
+    startedAt?: string;
+    /**
+     * ISO 8601 timestamp when the instance completed
+     */
+    completedAt?: string;
+    /**
+     * Instance data payload
+     */
+    data?: Record<string, any>;
+}
+//# sourceMappingURL=workflow.d.ts.map

package/dist/workflow.d.ts.map

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

package/dist/workflow.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.)'),
+});