[Copilot]

Defines the type system shared between backend (ObjectQL) parser and frontend (ObjectUI) renderer.

Core Interfaces

FieldType - 16 data types covering text, numeric, date/time, lookup, selection, and special fields (file, image, json)

ObjectField - Field metadata with validation rules, constraints, lookup configuration, and display properties

ObjectEntity - Complete entity definition including fields array, keys, UI hints, audit/soft-delete flags, and search configuration

ObjectView - View configuration supporting 10 presentation types (list, form, detail, card, kanban, calendar, chart, map, timeline, custom) with columns, filters, sorting, and layouts

Usage Example

import { ObjectEntity } from '@objectstack/spec';

const userEntity: ObjectEntity = {
  name: 'User',
  label: 'User',
  pluralLabel: 'Users',
  fields: [
    { name: 'email', label: 'Email', type: 'email', required: true, unique: true },
    { name: 'role', label: 'Role', type: 'select', options: [
      { value: 'admin', label: 'Administrator' },
      { value: 'user', label: 'User' }
    ]},
    { name: 'manager', label: 'Manager', type: 'lookup', 
      lookupEntity: 'User', lookupDisplayField: 'name' }
  ],
  primaryKey: 'id',
  displayField: 'email'
};

Implementation Notes

• TSDoc comments on all properties for IntelliSense
• Extensibility via metadata fields without core schema changes
• Pure TypeScript, platform-agnostic (Node.js/Browser/Electron compatible)
• Type guard isFieldType() for runtime validation

Original prompt

Please create a src/types/meta directory.
Define the Metamodel interfaces: ObjectEntity, ObjectField, and ObjectView.
These interfaces will be the contract shared between the backend (ObjectQL) parser and the frontend (ObjectUI) renderer.
Include specific types for FieldType (e.g., text, number, lookup)."

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.