@object-ui/core 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,42 @@
+# @object-ui/core
+
+## 0.3.0
+
+### Minor Changes
+
+- Unified version across all packages to 0.3.0 for consistent versioning
+
+## 0.2.2
+
+### Patch Changes
+
+- New plugin-object and ObjectQL SDK updates
+
+  **Added:**
+  - New Plugin: @object-ui/plugin-object - ObjectQL plugin for automatic table and form generation
+    - ObjectTable: Auto-generates tables from ObjectQL object schemas
+    - ObjectForm: Auto-generates forms from ObjectQL object schemas with create/edit/view modes
+    - Full TypeScript support with comprehensive type definitions
+  - Type Definitions: Added ObjectTableSchema and ObjectFormSchema to @object-ui/types
+  - ObjectQL Integration: Enhanced ObjectQLDataSource with getObjectSchema() method using MetadataApiClient
+
+  **Changed:**
+  - Updated @objectql/sdk from ^1.8.3 to ^1.9.1
+  - Updated @objectql/types from ^1.8.3 to ^1.9.1
+
+- Updated dependencies
+  - @object-ui/types@0.3.0
+
+## 0.2.1
+
+### Patch Changes
+
+- Patch release: Add automated changeset workflow and CI/CD improvements
+
+  This release includes infrastructure improvements:
+  - Added changeset-based version management
+  - Enhanced CI/CD workflows with GitHub Actions
+  - Improved documentation for contributing and releasing
+
+- Updated dependencies
+  - @object-ui/types@0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ObjectQL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# @object-ui/core
+
+Core logic, types, and validation for Object UI. Zero React dependencies.
+
+## Features
+
+- 🎯 **Type Definitions** - Complete TypeScript schemas for all components
+- 🔍 **Component Registry** - Framework-agnostic component registration system
+- 📊 **Data Scope** - Data scope management and expression evaluation
+- ✅ **Validation** - Zod-based schema validation
+- 🚀 **Zero React** - Can run in Node.js or any JavaScript environment
+
+## Installation
+
+```bash
+npm install @object-ui/core
+```
+
+## Usage
+
+### Type Definitions
+
+```typescript
+import type { 
+  PageSchema, 
+  FormSchema, 
+  InputSchema,
+  BaseSchema 
+} from '@object-ui/core'
+
+const mySchema: PageSchema = {
+  type: 'page',
+  title: 'My Page',
+  body: []
+}
+```
+
+### Component Registry
+
+```typescript
+import { ComponentRegistry } from '@object-ui/core'
+
+const registry = new ComponentRegistry()
+registry.register('button', buttonMetadata)
+const metadata = registry.get('button')
+```
+
+### Data Scope
+
+```typescript
+import { DataScope } from '@object-ui/core'
+
+const scope = new DataScope({ 
+  user: { name: 'John', role: 'admin' } 
+})
+
+const userName = scope.get('user.name') // 'John'
+const isAdmin = scope.evaluate('${user.role === "admin"}') // true
+```
+
+## Philosophy
+
+This package is designed to be **framework-agnostic**. It contains:
+
+- ✅ Pure TypeScript types and interfaces
+- ✅ Core logic and utilities
+- ✅ Validation schemas
+- ❌ NO React components
+- ❌ NO UI rendering logic
+- ❌ NO framework dependencies
+
+This allows the core types and logic to be used in:
+- Build tools and CLI utilities
+- Backend validation
+- Code generators
+- Alternative framework adapters (Vue, Svelte, etc.)
+
+## API Reference
+
+See [full documentation](https://objectui.org/api/core) for detailed API reference.
+
+## License
+
+MIT

package/dist/builder/schema-builder.d.ts

@@ -0,0 +1,287 @@
+/**
+ * @object-ui/core - Schema Builder
+ *
+ * Fluent API for building schemas programmatically.
+ * Provides type-safe builder functions for common schema patterns.
+ *
+ * @module builder
+ * @packageDocumentation
+ */
+import type { BaseSchema, FormSchema, FormField, CRUDSchema, TableColumn, ActionSchema, ButtonSchema, InputSchema, CardSchema, GridSchema, FlexSchema } from '@object-ui/types';
+/**
+ * Base builder class
+ */
+declare class SchemaBuilder<T extends BaseSchema> {
+    protected schema: any;
+    constructor(type: string);
+    /**
+     * Set the ID
+     */
+    id(id: string): this;
+    /**
+     * Set the className
+     */
+    className(className: string): this;
+    /**
+     * Set visibility
+     */
+    visible(visible: boolean): this;
+    /**
+     * Set conditional visibility
+     */
+    visibleOn(expression: string): this;
+    /**
+     * Set disabled state
+     */
+    disabled(disabled: boolean): this;
+    /**
+     * Set test ID
+     */
+    testId(testId: string): this;
+    /**
+     * Build the final schema
+     */
+    build(): T;
+}
+/**
+ * Form builder
+ */
+export declare class FormBuilder extends SchemaBuilder<FormSchema> {
+    constructor();
+    /**
+     * Add a field to the form
+     */
+    field(field: FormField): this;
+    /**
+     * Add multiple fields
+     */
+    fields(fields: FormField[]): this;
+    /**
+     * Set default values
+     */
+    defaultValues(values: Record<string, any>): this;
+    /**
+     * Set submit label
+     */
+    submitLabel(label: string): this;
+    /**
+     * Set form layout
+     */
+    layout(layout: 'vertical' | 'horizontal'): this;
+    /**
+     * Set number of columns
+     */
+    columns(columns: number): this;
+    /**
+     * Set submit handler
+     */
+    onSubmit(handler: (data: Record<string, any>) => void | Promise<void>): this;
+}
+/**
+ * CRUD builder
+ */
+export declare class CRUDBuilder extends SchemaBuilder<CRUDSchema> {
+    constructor();
+    /**
+     * Set resource name
+     */
+    resource(resource: string): this;
+    /**
+     * Set API endpoint
+     */
+    api(api: string): this;
+    /**
+     * Set title
+     */
+    title(title: string): this;
+    /**
+     * Set description
+     */
+    description(description: string): this;
+    /**
+     * Add a column
+     */
+    column(column: TableColumn): this;
+    /**
+     * Set all columns
+     */
+    columns(columns: TableColumn[]): this;
+    /**
+     * Set form fields
+     */
+    fields(fields: FormField[]): this;
+    /**
+     * Enable create operation
+     */
+    enableCreate(label?: string): this;
+    /**
+     * Enable update operation
+     */
+    enableUpdate(label?: string): this;
+    /**
+     * Enable delete operation
+     */
+    enableDelete(label?: string, confirmText?: string): this;
+    /**
+     * Set pagination
+     */
+    pagination(pageSize?: number): this;
+    /**
+     * Enable row selection
+     */
+    selectable(mode?: 'single' | 'multiple'): this;
+    /**
+     * Add a batch action
+     */
+    batchAction(action: ActionSchema): this;
+    /**
+     * Add a row action
+     */
+    rowAction(action: ActionSchema): this;
+}
+/**
+ * Button builder
+ */
+export declare class ButtonBuilder extends SchemaBuilder<ButtonSchema> {
+    constructor();
+    /**
+     * Set button label
+     */
+    label(label: string): this;
+    /**
+     * Set button variant
+     */
+    variant(variant: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link'): this;
+    /**
+     * Set button size
+     */
+    size(size: 'default' | 'sm' | 'lg' | 'icon'): this;
+    /**
+     * Set button icon
+     */
+    icon(icon: string): this;
+    /**
+     * Set click handler
+     */
+    onClick(handler: () => void | Promise<void>): this;
+    /**
+     * Set loading state
+     */
+    loading(loading: boolean): this;
+}
+/**
+ * Input builder
+ */
+export declare class InputBuilder extends SchemaBuilder<InputSchema> {
+    constructor();
+    /**
+     * Set field name
+     */
+    name(name: string): this;
+    /**
+     * Set label
+     */
+    label(label: string): this;
+    /**
+     * Set placeholder
+     */
+    placeholder(placeholder: string): this;
+    /**
+     * Set input type
+     */
+    inputType(type: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url'): this;
+    /**
+     * Mark as required
+     */
+    required(required?: boolean): this;
+    /**
+     * Set default value
+     */
+    defaultValue(value: string | number): this;
+}
+/**
+ * Card builder
+ */
+export declare class CardBuilder extends SchemaBuilder<CardSchema> {
+    constructor();
+    /**
+     * Set card title
+     */
+    title(title: string): this;
+    /**
+     * Set card description
+     */
+    description(description: string): this;
+    /**
+     * Set card content
+     */
+    content(content: BaseSchema | BaseSchema[]): this;
+    /**
+     * Set card variant
+     */
+    variant(variant: 'default' | 'outline' | 'ghost'): this;
+    /**
+     * Make card hoverable
+     */
+    hoverable(hoverable?: boolean): this;
+}
+/**
+ * Grid builder
+ */
+export declare class GridBuilder extends SchemaBuilder<GridSchema> {
+    constructor();
+    /**
+     * Set number of columns
+     */
+    columns(columns: number): this;
+    /**
+     * Set gap
+     */
+    gap(gap: number): this;
+    /**
+     * Add a child
+     */
+    child(child: BaseSchema): this;
+    /**
+     * Set all children
+     */
+    children(children: BaseSchema[]): this;
+}
+/**
+ * Flex builder
+ */
+export declare class FlexBuilder extends SchemaBuilder<FlexSchema> {
+    constructor();
+    /**
+     * Set flex direction
+     */
+    direction(direction: 'row' | 'col' | 'row-reverse' | 'col-reverse'): this;
+    /**
+     * Set justify content
+     */
+    justify(justify: 'start' | 'end' | 'center' | 'between' | 'around' | 'evenly'): this;
+    /**
+     * Set align items
+     */
+    align(align: 'start' | 'end' | 'center' | 'baseline' | 'stretch'): this;
+    /**
+     * Set gap
+     */
+    gap(gap: number): this;
+    /**
+     * Add a child
+     */
+    child(child: BaseSchema): this;
+    /**
+     * Set all children
+     */
+    children(children: BaseSchema[]): this;
+}
+export declare const form: () => FormBuilder;
+export declare const crud: () => CRUDBuilder;
+export declare const button: () => ButtonBuilder;
+export declare const input: () => InputBuilder;
+export declare const card: () => CardBuilder;
+export declare const grid: () => GridBuilder;
+export declare const flex: () => FlexBuilder;
+export {};