@stonecrop/schema 0.10.15 → 0.11.0

package/dist/src/doctype.d.ts

@@ -1,4 +1,115 @@
 import { z } from 'zod';
+/**
+ * Cardinality for relationship links.
+ * @public
+ */
+export declare const Cardinality: z.ZodEnum<{
+    one: "one";
+    atMostOne: "atMostOne";
+    noneOrMany: "noneOrMany";
+    atLeastOne: "atLeastOne";
+}>;
+/**
+ * Cardinality type inferred from Zod schema
+ * @public
+ */
+export type Cardinality = z.infer<typeof Cardinality>;
+/**
+ * Serialized function type - a function serialized to a string.
+ * Used for custom fetch handlers.
+ * @public
+ */
+export type SerializedFunction = string;
+/**
+ * Sync fetch strategy - data is fetched in the initial query.
+ * @public
+ */
+export declare const SyncFetch: z.ZodObject<{
+    method: z.ZodLiteral<"sync">;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Sync fetch strategy type
+ * @public
+ */
+export type SyncFetch = z.infer<typeof SyncFetch>;
+/**
+ * Lazy fetch strategy - data is fetched on demand in a separate query.
+ * @public
+ */
+export declare const LazyFetch: z.ZodObject<{
+    method: z.ZodLiteral<"lazy">;
+}, z.core.$strip>;
+/**
+ * Lazy fetch strategy type
+ * @public
+ */
+export type LazyFetch = z.infer<typeof LazyFetch>;
+/**
+ * Custom fetch strategy - uses a custom handler function.
+ * @public
+ */
+export declare const CustomFetch: z.ZodObject<{
+    method: z.ZodLiteral<"custom">;
+    handler: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Custom fetch strategy type
+ * @public
+ */
+export type CustomFetch = z.infer<typeof CustomFetch>;
+/**
+ * Fetch strategy for link data loading.
+ * - sync: fetched in the initial query
+ * - lazy: fetched on demand in a separate query
+ * - custom: uses a custom handler function
+ * @public
+ */
+export declare const FetchStrategy: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    method: z.ZodLiteral<"sync">;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"lazy">;
+}, z.core.$strip>, z.ZodObject<{
+    method: z.ZodLiteral<"custom">;
+    handler: z.ZodString;
+}, z.core.$strip>], "method">;
+/**
+ * Fetch strategy type
+ * @public
+ */
+export type FetchStrategy = z.infer<typeof FetchStrategy>;
+/**
+ * Link declaration - describes a relationship from one doctype to another.
+ * @public
+ */
+export declare const LinkDeclaration: z.ZodObject<{
+    target: z.ZodString;
+    cardinality: z.ZodEnum<{
+        one: "one";
+        atMostOne: "atMostOne";
+        noneOrMany: "noneOrMany";
+        atLeastOne: "atLeastOne";
+    }>;
+    backlink: z.ZodOptional<z.ZodString>;
+    component: z.ZodOptional<z.ZodString>;
+    fieldname: z.ZodOptional<z.ZodString>;
+    fetch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        method: z.ZodLiteral<"sync">;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodObject<{
+        method: z.ZodLiteral<"lazy">;
+    }, z.core.$strip>, z.ZodObject<{
+        method: z.ZodLiteral<"custom">;
+        handler: z.ZodString;
+    }, z.core.$strip>], "method">>;
+    blockWorkflows: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Link declaration type inferred from Zod schema
+ * @public
+ */
+export type LinkDeclaration = z.infer<typeof LinkDeclaration>;
 /**
  * Action definition within a workflow
  * @public
@@ -61,7 +172,6 @@ export declare const DoctypeMeta: z.ZodObject<{
             JSON: "JSON";
             Code: "Code";
             Link: "Link";
-            Doctype: "Doctype";
             Attach: "Attach";
             Currency: "Currency";
             Quantity: "Quantity";
@@ -86,13 +196,37 @@ export declare const DoctypeMeta: z.ZodObject<{
         options: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
         cardinality: z.ZodOptional<z.ZodEnum<{
             one: "one";
-            many: "many";
+            atMostOne: "atMostOne";
+            noneOrMany: "noneOrMany";
+            atLeastOne: "atLeastOne";
         }>>;
         mask: z.ZodOptional<z.ZodString>;
         validation: z.ZodOptional<z.ZodObject<{
             errorMessage: z.ZodString;
         }, z.core.$loose>>;
     }, z.core.$strip>>;
+    links: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        target: z.ZodString;
+        cardinality: z.ZodEnum<{
+            one: "one";
+            atMostOne: "atMostOne";
+            noneOrMany: "noneOrMany";
+            atLeastOne: "atLeastOne";
+        }>;
+        backlink: z.ZodOptional<z.ZodString>;
+        component: z.ZodOptional<z.ZodString>;
+        fieldname: z.ZodOptional<z.ZodString>;
+        fetch: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            method: z.ZodLiteral<"sync">;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>, z.ZodObject<{
+            method: z.ZodLiteral<"lazy">;
+        }, z.core.$strip>, z.ZodObject<{
+            method: z.ZodLiteral<"custom">;
+            handler: z.ZodString;
+        }, z.core.$strip>], "method">>;
+        blockWorkflows: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
     workflow: z.ZodOptional<z.ZodObject<{
         states: z.ZodOptional<z.ZodArray<z.ZodString>>;
         actions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -105,8 +239,6 @@ export declare const DoctypeMeta: z.ZodObject<{
         }, z.core.$strip>>>;
     }, z.core.$strip>>;
     inherits: z.ZodOptional<z.ZodString>;
-    listDoctype: z.ZodOptional<z.ZodString>;
-    parentDoctype: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
  * Doctype metadata type inferred from Zod schema
@@ -137,6 +269,38 @@ export interface DoctypeRef {
     /** URL-friendly slug (e.g., 'task', 'customer') */
     slug?: string;
 }
+/**
+ * Options for fetching a single record
+ * @public
+ */
+export interface GetRecordOptions {
+    /**
+     * Include nested link sub-selections.
+     * - `true`: include all descendant links
+     * - `string[]`: include only named links
+     * - `false` / omitted: scalar fields only (default)
+     */
+    includeNested?: boolean | string[];
+    /**
+     * Maximum depth for recursive sub-selections.
+     * No default — unlimited when omitted.
+     */
+    maxDepth?: number;
+}
+/**
+ * Options for fetching multiple records
+ * @public
+ */
+export interface GetRecordsOptions {
+    /** Filter expression (field-value pairs) */
+    filters?: Record<string, unknown>;
+    /** Order by expression (e.g. 'NAME_ASC') */
+    orderBy?: string;
+    /** Maximum number of records to return */
+    limit?: number;
+    /** Number of records to skip */
+    offset?: number;
+}
 /**
  * Interface for data clients that fetch doctype metadata and records.
  * Implemented by \@stonecrop/graphql-client's StonecropClient.
@@ -155,23 +319,23 @@ export interface DataClient<T extends DoctypeRef = DoctypeRef, M = DoctypeMeta>
     getMeta(context: DoctypeContext): Promise<M | null>;
     /**
      * Fetch a single record by ID
+     *
+     * When `includeNested` is set, builds a query with sub-selections for descendant
+     * links and returns ancestor + merged descendants. When omitted, returns flat scalar data.
+     *
      * @param doctype - Doctype reference (name and optional slug)
      * @param recordId - Record ID to fetch
+     * @param options - Query options
      * @returns Record data or null if not found
      */
-    getRecord(doctype: T, recordId: string): Promise<Record<string, unknown> | null>;
+    getRecord(doctype: T, recordId: string, options?: GetRecordOptions): Promise<Record<string, unknown> | null>;
     /**
      * Fetch multiple records
      * @param doctype - Doctype reference (name and optional slug)
-     * @param options - Optional filters, pagination, sorting
+     * @param options - Query options
      * @returns Array of record data
      */
-    getRecords(doctype: T, options?: {
-        filters?: Record<string, unknown>;
-        orderBy?: string;
-        limit?: number;
-        offset?: number;
-    }): Promise<Record<string, unknown>[]>;
+    getRecords(doctype: T, options?: GetRecordsOptions): Promise<Record<string, unknown>[]>;
     /**
      * Execute a doctype action (e.g., SUBMIT, APPROVE, save).
      * All state changes flow through this single mutation endpoint.

package/dist/src/doctype.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctype.d.ts","sourceRoot":"","sources":["../../src/doctype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;iBAuB1B,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAE/D;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;iBAWtB,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6BrB,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAA;AAErD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oCAAoC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAAE,CAAC,GAAG,WAAW;IAC7E;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;IAEnD;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;IAEhF;;;;;OAKG;IACH,UAAU,CACT,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;KACf,GACC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;IAErC;;;;;;;;OAQG;IACH,SAAS,CACR,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,OAAO,EAAE,GACd,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAA;CACrE"}
+{"version":3,"file":"doctype.d.ts","sourceRoot":"","sources":["../../src/doctype.ts"],"names":[],"mappings":"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"}

package/dist/src/doctype.js

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import { FieldMeta } from './field';
+/**
+ * Action definition within a workflow
+ * @public
+ */
+export const ActionDefinition = z
+    .object({
+    /** Display label for the action */
+    label: z.string().min(1),
+    /** Handler function name or path */
+    handler: z.string().min(1),
+    /** Fields that must have values before action can execute */
+    requiredFields: z.array(z.string()).optional(),
+    /** Workflow states where this action is available */
+    allowedStates: z.array(z.string()).optional(),
+    /** Whether to show a confirmation dialog */
+    confirm: z.boolean().optional(),
+    /** Additional arguments for the action */
+    args: z.record(z.string(), z.unknown()).optional(),
+})
+    .meta({
+    title: 'ActionDefinition',
+    description: 'Action definition within a workflow',
+});
+/**
+ * Workflow metadata - states and actions for a doctype
+ * @public
+ */
+export const WorkflowMeta = z
+    .object({
+    /** List of workflow states */
+    states: z.array(z.string()).optional(),
+    /** Actions available in this workflow */
+    actions: z.record(z.string(), ActionDefinition).optional(),
+})
+    .meta({
+    title: 'WorkflowMeta',
+    description: 'Workflow metadata - states and actions for a doctype',
+});
+/**
+ * Doctype metadata - complete definition of a doctype
+ * @public
+ */
+export const DoctypeMeta = z
+    .object({
+    /** Display name of the doctype */
+    name: z.string().min(1),
+    /** URL-friendly slug (kebab-case) */
+    slug: z.string().min(1).optional(),
+    /** Database table name */
+    tableName: z.string().optional(),
+    /** Field definitions */
+    fields: z.array(FieldMeta),
+    /** Workflow configuration */
+    workflow: WorkflowMeta.optional(),
+    /** Parent doctype for inheritance */
+    inherits: z.string().optional(),
+    /** Doctype to use for list views */
+    listDoctype: z.string().optional(),
+    /** Parent doctype for child tables */
+    parentDoctype: z.string().optional(),
+})
+    .meta({
+    title: 'DoctypeMeta',
+    description: 'Doctype metadata - complete definition of a doctype',
+});

package/dist/src/field.d.ts

@@ -54,7 +54,6 @@ export declare const FieldMeta: z.ZodObject<{
         JSON: "JSON";
         Code: "Code";
         Link: "Link";
-        Doctype: "Doctype";
         Attach: "Attach";
         Currency: "Currency";
         Quantity: "Quantity";
@@ -79,7 +78,9 @@ export declare const FieldMeta: z.ZodObject<{
     options: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodRecord<z.ZodString, z.ZodUnknown>]>>;
     cardinality: z.ZodOptional<z.ZodEnum<{
         one: "one";
-        many: "many";
+        atMostOne: "atMostOne";
+        noneOrMany: "noneOrMany";
+        atLeastOne: "atLeastOne";
     }>>;
     mask: z.ZodOptional<z.ZodString>;
     validation: z.ZodOptional<z.ZodObject<{

package/dist/src/field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,qGAStB,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,eAAe;IAE1B,qDAAqD;;iBAMpD,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAtBpB,qDAAqD;;;iBA4GpD,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/field.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,qGAStB,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEvD;;;GAGG;AACH,eAAO,MAAM,eAAe;IAE1B,qDAAqD;;iBAMpD,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAA;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAtBpB,qDAAqD;;;iBA8GpD,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAA"}

package/dist/src/field.js

@@ -0,0 +1,108 @@
+import { z } from 'zod';
+import { StonecropFieldType } from './fieldtype';
+/**
+ * Field options - flexible bag for type-specific configuration.
+ *
+ * Usage by fieldtype:
+ * - Link/Doctype: target doctype slug as string ("customer", "sales-order-item")
+ * - Select: array of choices (["Draft", "Submitted", "Cancelled"])
+ * - Decimal: config object (\{ precision: 10, scale: 2 \})
+ * - Code: config object (\{ language: "python" \})
+ *
+ * @public
+ */
+export const FieldOptions = z
+    .union([
+    z.string(), // Link/Doctype target: "customer"
+    z.array(z.string()), // Select choices: ["A", "B", "C"]
+    z.record(z.string(), z.unknown()), // Config: \{ precision: 10, scale: 2 \}
+])
+    .meta({
+    title: 'FieldOptions',
+    description: 'Field options - flexible bag for type-specific configuration',
+});
+/**
+ * Validation configuration for form fields
+ * @public
+ */
+export const FieldValidation = z
+    .looseObject({
+    /** Error message to display when validation fails */
+    errorMessage: z.string(),
+})
+    .meta({
+    title: 'FieldValidation',
+    description: 'Validation configuration for form fields',
+});
+/**
+ * Unified field metadata - the single source of truth for field definitions.
+ * Works for both forms (AForm) and tables (ATable).
+ *
+ * Core principle: "Text" is "Text" regardless of rendering context.
+ *
+ * @public
+ */
+export const FieldMeta = z
+    .object({
+    // === CORE (required) ===
+    /** Unique identifier for the field within its doctype */
+    fieldname: z.string().min(1),
+    /** Semantic field type - determines behavior and default component */
+    fieldtype: StonecropFieldType,
+    // === COMPONENT (optional - derived from fieldtype when not specified) ===
+    /** Vue component to render this field. If not specified, derived from TYPE_MAP */
+    component: z.string().optional(),
+    // === DISPLAY ===
+    /** Human-readable label for the field */
+    label: z.string().optional(),
+    /** Width of the field (CSS value, e.g., "40ch", "200px") */
+    width: z.string().optional(),
+    /** Text alignment within the field */
+    align: z.enum(['left', 'center', 'right', 'start', 'end']).optional(),
+    // === BEHAVIOR ===
+    /** Whether the field is required */
+    required: z.boolean().optional(),
+    /** Whether the field is read-only */
+    readOnly: z.boolean().optional(),
+    /** Whether the field is editable (for table cells) */
+    edit: z.boolean().optional(),
+    /** Whether the field is hidden from the UI */
+    hidden: z.boolean().optional(),
+    // === VALUE ===
+    /** Current value of the field */
+    value: z.unknown().optional(),
+    /** Default value for new records */
+    default: z.unknown().optional(),
+    // === TYPE-SPECIFIC ===
+    /**
+     * Type-specific options:
+     * - Link: target doctype slug ("customer")
+     * - Doctype: child doctype slug ("sales-order-item")
+     * - Select: choices array (["Draft", "Submitted"])
+     * - Decimal: \{ precision, scale \}
+     * - Code: \{ language \}
+     */
+    options: FieldOptions.optional(),
+    /**
+     * Cardinality for Doctype fields:
+     * - 'one': 1:1 nested form (default)
+     * - 'many': 1:many child table
+     */
+    cardinality: z.enum(['one', 'many']).optional(),
+    /**
+     * Input mask pattern. Accepts either a plain mask string or a stringified
+     * arrow function that receives `locale` and returns a mask string.
+     *
+     * Plain pattern: `"##/##/####"`
+     *
+     * Function pattern: `"(locale) => locale === 'en-US' ? '(###) ###-####' : '####-######'"`
+     */
+    mask: z.string().optional(),
+    // === VALIDATION ===
+    /** Validation configuration */
+    validation: FieldValidation.optional(),
+})
+    .meta({
+    title: 'FieldMeta',
+    description: 'Unified field metadata - the single source of truth for field definitions, works for both forms (AForm) and tables (ATable)',
+});

package/dist/src/fieldtype.d.ts

@@ -19,7 +19,6 @@ export declare const StonecropFieldType: z.ZodEnum<{
     JSON: "JSON";
     Code: "Code";
     Link: "Link";
-    Doctype: "Doctype";
     Attach: "Attach";
     Currency: "Currency";
     Quantity: "Quantity";

package/dist/src/fieldtype.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fieldtype.d.ts","sourceRoot":"","sources":["../../src/fieldtype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;EAyB5B,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAA;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAmC9D,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,CAEzE"}
+{"version":3,"file":"fieldtype.d.ts","sourceRoot":"","sources":["../../src/fieldtype.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;GAIG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;EAwB5B,CAAA;AAEH;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAA;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,kBAAkB,EAAE,aAAa,CAkC9D,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,kBAAkB,GAAG,MAAM,CAEzE"}

package/dist/src/fieldtype.js

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+/**
+ * Stonecrop field types - the semantic type of the field.
+ * These are consistent across forms and tables.
+ * @public
+ */
+export const StonecropFieldType = z
+    .enum([
+    'Data', // Short text, varchar
+    'Text', // Long text
+    'Int', // Integer
+    'Float', // Floating point (IEEE 754)
+    'Decimal', // Arbitrary precision decimal
+    'Check', // Boolean/checkbox
+    'Date', // Date only
+    'Time', // Time only
+    'Datetime', // Date and time
+    'Duration', // Time interval
+    'DateRange', // Date range
+    'JSON', // JSON data
+    'Code', // Code/source (with syntax highlighting)
+    'Link', // Reference to another doctype
+    'Doctype', // Child doctype (1:1 nested form or 1:many table via cardinality)
+    'Attach', // File attachment
+    'Currency', // Currency value
+    'Quantity', // Quantity with unit
+    'Select', // Dropdown selection
+])
+    .meta({
+    title: 'StonecropFieldType',
+    description: 'Semantic field types for Stonecrop doctypes, consistent across forms and tables',
+});
+/**
+ * Mapping from StonecropFieldType to default Vue component.
+ * Components can be overridden in the field definition.
+ * @public
+ */
+export const TYPE_MAP = {
+    // Text
+    Data: { component: 'ATextInput', fieldtype: 'Data' },
+    Text: { component: 'ATextInput', fieldtype: 'Text' },
+    // Numeric
+    Int: { component: 'ANumericInput', fieldtype: 'Int' },
+    Float: { component: 'ANumericInput', fieldtype: 'Float' },
+    Decimal: { component: 'ADecimalInput', fieldtype: 'Decimal' },
+    // Boolean
+    Check: { component: 'ACheckbox', fieldtype: 'Check' },
+    // Date/Time
+    Date: { component: 'ADate', fieldtype: 'Date' },
+    Time: { component: 'ATimeInput', fieldtype: 'Time' },
+    Datetime: { component: 'ADatetimePicker', fieldtype: 'Datetime' },
+    Duration: { component: 'ADurationInput', fieldtype: 'Duration' },
+    DateRange: { component: 'ADateRangePicker', fieldtype: 'DateRange' },
+    // Structured
+    JSON: { component: 'ACodeEditor', fieldtype: 'JSON' },
+    Code: { component: 'ACodeEditor', fieldtype: 'Code' },
+    // Relational
+    Link: { component: 'ALink', fieldtype: 'Link' },
+    Doctype: { component: 'AForm', fieldtype: 'Doctype' },
+    // Files
+    Attach: { component: 'AFileAttach', fieldtype: 'Attach' },
+    // Specialized
+    Currency: { component: 'ACurrencyInput', fieldtype: 'Currency' },
+    Quantity: { component: 'AQuantityInput', fieldtype: 'Quantity' },
+    Select: { component: 'ADropdown', fieldtype: 'Select' },
+};
+/**
+ * Get the default component for a field type
+ * @param fieldtype - The semantic field type
+ * @returns The default component name
+ * @public
+ */
+export function getDefaultComponent(fieldtype) {
+    return TYPE_MAP[fieldtype]?.component ?? 'ATextInput';
+}

package/dist/src/index.d.ts

@@ -1,11 +1,7 @@
-export { StonecropFieldType, TYPE_MAP, getDefaultComponent } from './fieldtype';
-export { FieldMeta, FieldOptions, FieldValidation } from './field';
-export { DoctypeMeta, WorkflowMeta, ActionDefinition, type DoctypeContext, type DoctypeRef, type DataClient, } from './doctype';
-export { validateField, validateDoctype, parseField, parseDoctype, type ValidationResult, type ValidationError, } from './validation';
-export { convertGraphQLSchema, GQL_SCALAR_MAP, WELL_KNOWN_SCALARS, INTERNAL_SCALARS, buildScalarMap, defaultIsEntityType, defaultIsEntityField, classifyFieldType, type IntrospectionSource, type GraphQLConversionOptions, type GraphQLConversionFieldMeta, type ConvertedGraphQLDoctype, } from './converter';
+export { StonecropFieldType, TYPE_MAP, getDefaultComponent, type FieldTemplate } from './fieldtype';
+export type { FieldMeta, FieldOptions, FieldValidation } from './field';
+export type { ActionDefinition, Cardinality, CustomFetch, DataClient, DoctypeContext, DoctypeMeta, DoctypeRef, FetchStrategy, GetRecordOptions, GetRecordsOptions, LazyFetch, LinkDeclaration, SerializedFunction, SyncFetch, WorkflowMeta, } from './doctype';
+export { parseDoctype, parseField, validateDoctype, validateField, type ValidationError, type ValidationResult, } from './validation';
+export { buildScalarMap, classifyFieldType, convertGraphQLSchema, defaultIsEntityField, defaultIsEntityType, GQL_SCALAR_MAP, INTERNAL_SCALARS, WELL_KNOWN_SCALARS, type ConvertedGraphQLDoctype, type GraphQLConversionFieldMeta, type GraphQLConversionOptions, type IntrospectionSource, } from './converter';
 export { toSlug, toPascalCase, pascalToSnake, snakeToCamel, camelToSnake, snakeToLabel, camelToLabel } from './naming';
-export type { StonecropFieldType as StonecropFieldTypeValue } from './fieldtype';
-export type { FieldMeta as FieldMetaType, FieldOptions as FieldOptionsType } from './field';
-export type { FieldTemplate } from './fieldtype';
-export type { DoctypeMeta as DoctypeMetaType, WorkflowMeta as WorkflowMetaType } from './doctype';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAG/E,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGlE,OAAO,EACN,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,UAAU,GACf,MAAM,WAAW,CAAA;AAGlB,OAAO,EACN,aAAa,EACb,eAAe,EACf,UAAU,EACV,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACpB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACN,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC5B,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGtH,YAAY,EAAE,kBAAkB,IAAI,uBAAuB,EAAE,MAAM,aAAa,CAAA;AAChF,YAAY,EAAE,SAAS,IAAI,aAAa,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC3F,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAChD,YAAY,EAAE,WAAW,IAAI,eAAe,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAGnG,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAGvE,YAAY,EACX,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,YAAY,GACZ,MAAM,WAAW,CAAA;AAGlB,OAAO,EACN,YAAY,EACZ,UAAU,EACV,eAAe,EACf,aAAa,EACb,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACrB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACN,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,GACxB,MAAM,aAAa,CAAA;AAGpB,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,12 @@
+// Field types
+export { StonecropFieldType, TYPE_MAP, getDefaultComponent } from './fieldtype';
+// Field schema
+export { FieldMeta, FieldOptions, FieldValidation } from './field';
+// Doctype schema
+export { DoctypeMeta, WorkflowMeta, ActionDefinition, } from './doctype';
+// Validation helpers
+export { validateField, validateDoctype, parseField, parseDoctype, } from './validation';
+// GraphQL to Doctype conversion
+export { convertGraphQLSchema, GQL_SCALAR_MAP, WELL_KNOWN_SCALARS, INTERNAL_SCALARS, buildScalarMap, defaultIsEntityType, defaultIsEntityField, classifyFieldType, } from './converter';
+// Naming utilities
+export { toSlug, toPascalCase, pascalToSnake, snakeToCamel, camelToSnake, snakeToLabel, camelToLabel } from './naming';