@objectstack/spec 0.3.2 → 0.4.1

package/dist/data/field.zod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.zod.d.ts","sourceRoot":"","sources":["../../src/data/field.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,SAAS,oXA6BpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,eAAe;;;;;;IAOf,2BAA2B;;;;;;IAO3B,8BAA8B;;;IAI9B,yBAAyB;;;;;IAMzB,wBAAwB;;;;;;;;;;;;;;;;;IAGxB,0BAA0B;;;;;IAM1B,kBAAkB;;;;;;;;;;;;;;;;IASlB,yCAAyC;;;;;;;;;;;;;;;;;;;IAmCzC,4BAA4B;;;;IAK5B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,KAAK;oBACD,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACb,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBACd,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACR,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBACR,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BACP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACd,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE7B;;;;;;;;OAQG;8BACuB,YAAY,EAAE,GAAG,MAAM,EAAE,IAAG,UAAU,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAAA;KAAE,CAAA,WAAW,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuB1G,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAMpB,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAOjC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAKX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAKT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKX,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAM5B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAKN,MAAM,WAAc,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAM9B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKb,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAKL,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAIjC,CAAC"}
+{"version":3,"file":"field.zod.d.ts","sourceRoot":"","sources":["../../src/data/field.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,SAAS,qdAqCpB,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;EAK7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;EAKpC,CAAC;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;EAI/B,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;EAQxB,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,eAAe;;;;;;IAOf,2BAA2B;;;;;;IAO3B,8BAA8B;;;IAI9B,yBAAyB;;;;;IAMzB,wBAAwB;;;;;;;;;;;;;;;;;IAGxB,0BAA0B;;;;;IAM1B,kBAAkB;;;;;;;;;;;;;;;;IASlB,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAyCzC,4BAA4B;;;;IAK5B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGf,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;AAEtD,eAAO,MAAM,KAAK;oBACD,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACb,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBACd,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACR,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBACR,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBACV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BACP,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACZ,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oBACd,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBACN,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAE7B;;;;;;;;;;;;;;;OAeG;8BACuB,YAAY,EAAE,GAAG,MAAM,EAAE,IAAG,UAAU,GAAG;QAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAAA;KAAE,CAAA,WAAW,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAuC1G,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAMpB,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAOjC,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uBAKX,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAKT,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKX,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAM5B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAKN,MAAM,WAAc,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAM9B,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKb,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAKV,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAKN,MAAM,WAAU,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWhD,CAAC"}

package/dist/data/field.zod.js

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Field = exports.FieldSchema = exports.AddressSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
+exports.Field = exports.FieldSchema = exports.VectorConfigSchema = exports.AddressSchema = exports.CurrencyValueSchema = exports.CurrencyConfigSchema = exports.LocationCoordinatesSchema = exports.SelectOptionSchema = exports.FieldType = void 0;
 const zod_1 = require("zod");
+const identifiers_zod_1 = require("../shared/identifiers.zod");
 /**
  * Field Type Enum
  */
@@ -15,32 +16,55 @@ exports.FieldType = zod_1.z.enum([
     // Date & Time
     'date', 'datetime', 'time',
     // Logic
-    'boolean',
+    'boolean', 'toggle', // Toggle is a distinct UI from checkbox
     // Selection
-    'select', // Static options
+    'select', // Single select dropdown
+    'multiselect', // Multi select (often tags)
+    'radio', // Radio group
+    'checkboxes', // Checkbox group
     // Relational
-    'lookup', 'master_detail', // Dynamic reference to other objects
+    'lookup', 'master_detail', // Dynamic reference
+    'tree', // Hierarchical reference
     // Media
-    'image', 'file', 'avatar',
+    'image', 'file', 'avatar', 'video', 'audio',
     // Calculated / System
     'formula', 'summary', 'autonumber',
     // Enhanced Types
-    'location', // GPS coordinates (aka geolocation)
-    'geolocation', // Alternative name for location field
+    'location', // GPS coordinates
     'address', // Structured address
-    'code', // Code with syntax highlighting
+    'code', // Code editor (JSON/SQL/JS)
+    'json', // Structured JSON data
     'color', // Color picker
     'rating', // Star rating
     'slider', // Numeric slider
     'signature', // Digital signature
     'qrcode', // QR code / Barcode
+    'progress', // Progress bar
+    'tags', // Simple tag list
+    // AI/ML Types
+    'vector', // Vector embeddings for AI/ML (semantic search, RAG)
 ]);
 /**
  * Select Option Schema
+ *
+ * Defines option values for select/picklist fields.
+ *
+ * **CRITICAL RULE**: The `value` field is a machine identifier that gets stored in the database.
+ * It MUST be lowercase to avoid case-sensitivity issues in queries and comparisons.
+ *
+ * @example Good
+ * { label: 'New', value: 'new' }
+ * { label: 'In Progress', value: 'in_progress' }
+ * { label: 'Closed Won', value: 'closed_won' }
+ *
+ * @example Bad (will be rejected)
+ * { label: 'New', value: 'New' } // uppercase
+ * { label: 'In Progress', value: 'In Progress' } // spaces and uppercase
+ * { label: 'Closed Won', value: 'Closed_Won' } // mixed case
  */
 exports.SelectOptionSchema = zod_1.z.object({
-    label: zod_1.z.string().describe('Display label'),
-    value: zod_1.z.string().describe('Stored value'),
+    label: zod_1.z.string().describe('Display label (human-readable, any case allowed)'),
+    value: identifiers_zod_1.SystemIdentifierSchema.describe('Stored value (lowercase machine identifier)'),
     color: zod_1.z.string().optional().describe('Color code for badges/charts'),
     default: zod_1.z.boolean().optional().describe('Is default option'),
 });
@@ -54,6 +78,32 @@ exports.LocationCoordinatesSchema = zod_1.z.object({
     altitude: zod_1.z.number().optional().describe('Altitude in meters'),
     accuracy: zod_1.z.number().optional().describe('Accuracy in meters'),
 });
+/**
+ * Currency Configuration Schema
+ * Configuration for currency field type supporting multi-currency
+ *
+ * Note: Currency codes are validated by length only (3 characters) to support:
+ * - Standard ISO 4217 codes (USD, EUR, CNY, etc.)
+ * - Cryptocurrency codes (BTC, ETH, etc.)
+ * - Custom business-specific codes
+ * Stricter validation can be implemented at the application layer based on business requirements.
+ */
+exports.CurrencyConfigSchema = zod_1.z.object({
+    precision: zod_1.z.number().int().min(0).max(10).default(2).describe('Decimal precision (default: 2)'),
+    currencyMode: zod_1.z.enum(['dynamic', 'fixed']).default('dynamic').describe('Currency mode: dynamic (user selectable) or fixed (single currency)'),
+    defaultCurrency: zod_1.z.string().length(3).default('CNY').describe('Default or fixed currency code (ISO 4217, e.g., USD, CNY, EUR)'),
+});
+/**
+ * Currency Value Schema
+ * Runtime value structure for currency fields
+ *
+ * Note: Currency codes are validated by length only (3 characters) to support flexibility.
+ * See CurrencyConfigSchema for details on currency code validation strategy.
+ */
+exports.CurrencyValueSchema = zod_1.z.object({
+    value: zod_1.z.number().describe('Monetary amount'),
+    currency: zod_1.z.string().length(3).describe('Currency code (ISO 4217)'),
+});
 /**
  * Address Schema
  * Structured address for address field type
@@ -67,6 +117,37 @@ exports.AddressSchema = zod_1.z.object({
     countryCode: zod_1.z.string().optional().describe('ISO country code (e.g., US, GB)'),
     formatted: zod_1.z.string().optional().describe('Formatted address string'),
 });
+/**
+ * Vector Configuration Schema
+ * Configuration for vector field type supporting AI/ML embeddings
+ *
+ * Vector fields store numerical embeddings for semantic search, similarity matching,
+ * and Retrieval-Augmented Generation (RAG) workflows.
+ *
+ * @example
+ * // Text embeddings for semantic search
+ * {
+ *   dimensions: 1536,  // OpenAI text-embedding-ada-002
+ *   distanceMetric: 'cosine',
+ *   indexed: true
+ * }
+ *
+ * @example
+ * // Image embeddings with normalization
+ * {
+ *   dimensions: 512,   // ResNet-50
+ *   distanceMetric: 'euclidean',
+ *   normalized: true,
+ *   indexed: true
+ * }
+ */
+exports.VectorConfigSchema = zod_1.z.object({
+    dimensions: zod_1.z.number().int().min(1).max(10000).describe('Vector dimensionality (e.g., 1536 for OpenAI embeddings)'),
+    distanceMetric: zod_1.z.enum(['cosine', 'euclidean', 'dotProduct', 'manhattan']).default('cosine').describe('Distance/similarity metric for vector search'),
+    normalized: zod_1.z.boolean().default(false).describe('Whether vectors are normalized (unit length)'),
+    indexed: zod_1.z.boolean().default(true).describe('Whether to create a vector index for fast similarity search'),
+    indexType: zod_1.z.enum(['hnsw', 'ivfflat', 'flat']).optional().describe('Vector index algorithm (HNSW for high accuracy, IVFFlat for large datasets)'),
+});
 /**
  * Field Schema - Best Practice Enterprise Pattern
  */
@@ -134,6 +215,10 @@ exports.FieldSchema = zod_1.z.object({
     qrErrorCorrection: zod_1.z.enum(['L', 'M', 'Q', 'H']).optional().describe('QR code error correction level (L=7%, M=15%, Q=25%, H=30%). Only applicable when barcodeFormat is "qr"'),
     displayValue: zod_1.z.boolean().optional().describe('Display human-readable value below barcode/QR code'),
     allowScanning: zod_1.z.boolean().optional().describe('Enable camera scanning for barcode/QR code input'),
+    // Currency field config
+    currencyConfig: exports.CurrencyConfigSchema.optional().describe('Configuration for currency field type'),
+    // Vector field config
+    vectorConfig: exports.VectorConfigSchema.optional().describe('Configuration for vector field type (AI/ML embeddings)'),
     /** Security & Visibility */
     hidden: zod_1.z.boolean().default(false).describe('Hidden from default UI'),
     readonly: zod_1.z.boolean().default(false).describe('Read-only in UI'),
@@ -166,13 +251,27 @@ exports.Field = {
     /**
      * Select field helper with backward-compatible API
      *
-     * @example Old API (array first)
+     * Automatically converts option values to lowercase to enforce naming conventions.
+     *
+     * @example Old API (array first) - auto-converts to lowercase
      * Field.select(['High', 'Low'], { label: 'Priority' })
+     * // Results in: [{ label: 'High', value: 'high' }, { label: 'Low', value: 'low' }]
      *
-     * @example New API (config object)
+     * @example New API (config object) - enforces lowercase
      * Field.select({ options: [{label: 'High', value: 'high'}], label: 'Priority' })
+     *
+     * @example Multi-word values - converts to snake_case
+     * Field.select(['In Progress', 'Closed Won'], { label: 'Status' })
+     * // Results in: [{ label: 'In Progress', value: 'in_progress' }, { label: 'Closed Won', value: 'closed_won' }]
      */
     select: (optionsOrConfig, config) => {
+        // Helper function to convert string to lowercase snake_case
+        const toSnakeCase = (str) => {
+            return str
+                .toLowerCase()
+                .replace(/\s+/g, '_') // Replace spaces with underscores
+                .replace(/[^a-z0-9_]/g, ''); // Remove invalid characters (keeping underscores only)
+        };
         // Support both old and new signatures:
         // Old: Field.select(['a', 'b'], { label: 'X' })
         // New: Field.select({ options: [{label: 'A', value: 'a'}], label: 'X' })
@@ -180,12 +279,18 @@ exports.Field = {
         let finalConfig;
         if (Array.isArray(optionsOrConfig)) {
             // Old signature: array as first param
-            options = optionsOrConfig.map(o => typeof o === 'string' ? { label: o, value: o } : o);
+            options = optionsOrConfig.map(o => typeof o === 'string'
+                ? { label: o, value: toSnakeCase(o) } // Auto-convert string to snake_case
+                : { ...o, value: o.value.toLowerCase() } // Ensure value is lowercase
+            );
             finalConfig = config || {};
         }
         else {
             // New signature: config object with options
-            options = (optionsOrConfig.options || []).map(o => typeof o === 'string' ? { label: o, value: o } : o);
+            options = (optionsOrConfig.options || []).map(o => typeof o === 'string'
+                ? { label: o, value: toSnakeCase(o) } // Auto-convert string to snake_case
+                : { ...o, value: o.value.toLowerCase() } // Ensure value is lowercase
+            );
             // Remove options from config to avoid confusion
             const { options: _, ...restConfig } = optionsOrConfig;
             finalConfig = restConfig;
@@ -241,8 +346,15 @@ exports.Field = {
         type: 'qrcode',
         ...config
     }),
-    geolocation: (config = {}) => ({
-        type: 'geolocation',
+    vector: (dimensions, config = {}) => ({
+        type: 'vector',
+        vectorConfig: {
+            dimensions,
+            distanceMetric: 'cosine',
+            normalized: false,
+            indexed: true,
+            ...config.vectorConfig
+        },
         ...config
     }),
 };

package/dist/data/filter.zod.d.ts

@@ -20,6 +20,23 @@ import { z } from 'zod';
  * 3. Type Safe: Structure can be statically inferred by TypeScript
  * 4. Convention over Configuration: Implicit syntax for common queries
  */
+/**
+ * Field Reference
+ * Represents a reference to another field/column instead of a literal value.
+ * Used for joins (ON clause) and cross-field comparisons.
+ *
+ * @example
+ * // user.id = order.owner_id
+ * { "$eq": { "$field": "order.owner_id" } }
+ */
+export declare const FieldReferenceSchema: z.ZodObject<{
+    $field: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    $field: string;
+}, {
+    $field: string;
+}>;
+export type FieldReference = z.infer<typeof FieldReferenceSchema>;
 /**
  * Comparison operators for equality and inequality checks.
  * Supported data types: Any
@@ -42,23 +59,63 @@ export declare const EqualityOperatorSchema: z.ZodObject<{
  */
 export declare const ComparisonOperatorSchema: z.ZodObject<{
     /** Greater than - SQL: > | MongoDB: $gt */
-    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     /** Greater than or equal to - SQL: >= | MongoDB: $gte */
-    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     /** Less than - SQL: < | MongoDB: $lt */
-    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     /** Less than or equal to - SQL: <= | MongoDB: $lte */
-    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
 }, "strip", z.ZodTypeAny, {
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
 }, {
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
 }>;
 /**
  * Set operators for membership checks.
@@ -81,11 +138,31 @@ export declare const SetOperatorSchema: z.ZodObject<{
  */
 export declare const RangeOperatorSchema: z.ZodObject<{
     /** Between (inclusive) - takes [min, max] array */
-    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate]>, z.ZodUnion<[z.ZodNumber, z.ZodDate]>], null>>;
+    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>, z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>], null>>;
 }, "strip", z.ZodTypeAny, {
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
 }, {
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
 }>;
 /**
  * String pattern matching operators.
@@ -129,13 +206,49 @@ export declare const SpecialOperatorSchema: z.ZodObject<{
 export declare const FieldOperatorsSchema: z.ZodObject<{
     $eq: z.ZodOptional<z.ZodAny>;
     $ne: z.ZodOptional<z.ZodAny>;
-    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
-    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
-    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
-    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate]>>;
+    $gt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
+    $gte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
+    $lt: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
+    $lte: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>>;
     $in: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
     $nin: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
-    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate]>, z.ZodUnion<[z.ZodNumber, z.ZodDate]>], null>>;
+    $between: z.ZodOptional<z.ZodTuple<[z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>, z.ZodUnion<[z.ZodNumber, z.ZodDate, z.ZodObject<{
+        $field: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        $field: string;
+    }, {
+        $field: string;
+    }>]>], null>>;
     $contains: z.ZodOptional<z.ZodString>;
     $startsWith: z.ZodOptional<z.ZodString>;
     $endsWith: z.ZodOptional<z.ZodString>;
@@ -144,13 +257,25 @@ export declare const FieldOperatorsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     $eq?: any;
     $ne?: any;
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
     $in?: any[] | undefined;
     $nin?: any[] | undefined;
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
     $contains?: string | undefined;
     $startsWith?: string | undefined;
     $endsWith?: string | undefined;
@@ -159,13 +284,25 @@ export declare const FieldOperatorsSchema: z.ZodObject<{
 }, {
     $eq?: any;
     $ne?: any;
-    $gt?: number | Date | undefined;
-    $gte?: number | Date | undefined;
-    $lt?: number | Date | undefined;
-    $lte?: number | Date | undefined;
+    $gt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $gte?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lt?: number | Date | {
+        $field: string;
+    } | undefined;
+    $lte?: number | Date | {
+        $field: string;
+    } | undefined;
     $in?: any[] | undefined;
     $nin?: any[] | undefined;
-    $between?: [number | Date, number | Date] | undefined;
+    $between?: [number | Date | {
+        $field: string;
+    }, number | Date | {
+        $field: string;
+    }] | undefined;
     $contains?: string | undefined;
     $startsWith?: string | undefined;
     $endsWith?: string | undefined;

package/dist/data/filter.zod.d.ts.map

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

package/dist/data/filter.zod.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALL_OPERATORS = exports.LOGICAL_OPERATORS = exports.FILTER_OPERATORS = exports.NormalizedFilterSchema = exports.QueryFilterSchema = exports.FilterConditionSchema = exports.FieldOperatorsSchema = exports.SpecialOperatorSchema = exports.StringOperatorSchema = exports.RangeOperatorSchema = exports.SetOperatorSchema = exports.ComparisonOperatorSchema = exports.EqualityOperatorSchema = void 0;
+exports.ALL_OPERATORS = exports.LOGICAL_OPERATORS = exports.FILTER_OPERATORS = exports.NormalizedFilterSchema = exports.QueryFilterSchema = exports.FilterConditionSchema = exports.FieldOperatorsSchema = exports.SpecialOperatorSchema = exports.StringOperatorSchema = exports.RangeOperatorSchema = exports.SetOperatorSchema = exports.ComparisonOperatorSchema = exports.EqualityOperatorSchema = exports.FieldReferenceSchema = void 0;
 const zod_1 = require("zod");
 /**
  * Unified Query DSL Specification
@@ -23,6 +23,18 @@ const zod_1 = require("zod");
  * 3. Type Safe: Structure can be statically inferred by TypeScript
  * 4. Convention over Configuration: Implicit syntax for common queries
  */
+/**
+ * Field Reference
+ * Represents a reference to another field/column instead of a literal value.
+ * Used for joins (ON clause) and cross-field comparisons.
+ *
+ * @example
+ * // user.id = order.owner_id
+ * { "$eq": { "$field": "order.owner_id" } }
+ */
+exports.FieldReferenceSchema = zod_1.z.object({
+    $field: zod_1.z.string().describe('Field Reference/Column Name')
+});
 // ============================================================================
 // 3.1 Comparison Operators
 // ============================================================================
@@ -42,13 +54,13 @@ exports.EqualityOperatorSchema = zod_1.z.object({
  */
 exports.ComparisonOperatorSchema = zod_1.z.object({
     /** Greater than - SQL: > | MongoDB: $gt */
-    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     /** Greater than or equal to - SQL: >= | MongoDB: $gte */
-    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     /** Less than - SQL: < | MongoDB: $lt */
-    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     /** Less than or equal to - SQL: <= | MongoDB: $lte */
-    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
 });
 // ============================================================================
 // 3.2 Set & Range Operators
@@ -69,8 +81,8 @@ exports.SetOperatorSchema = zod_1.z.object({
 exports.RangeOperatorSchema = zod_1.z.object({
     /** Between (inclusive) - takes [min, max] array */
     $between: zod_1.z.tuple([
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()]),
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()])
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]),
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema])
     ]).optional(),
 });
 // ============================================================================
@@ -112,16 +124,16 @@ exports.FieldOperatorsSchema = zod_1.z.object({
     $eq: zod_1.z.any().optional(),
     $ne: zod_1.z.any().optional(),
     // Comparison (numeric/date)
-    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
-    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
-    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
-    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date()]).optional(),
+    $gt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
+    $gte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
+    $lt: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
+    $lte: zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]).optional(),
     // Set & Range
     $in: zod_1.z.array(zod_1.z.any()).optional(),
     $nin: zod_1.z.array(zod_1.z.any()).optional(),
     $between: zod_1.z.tuple([
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()]),
-        zod_1.z.union([zod_1.z.number(), zod_1.z.date()])
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema]),
+        zod_1.z.union([zod_1.z.number(), zod_1.z.date(), exports.FieldReferenceSchema])
     ]).optional(),
     // String-specific
     $contains: zod_1.z.string().optional(),