@stonecrop/stonecrop 0.6.3 → 0.7.0

package/dist/stonecrop.d.ts

@@ -173,7 +173,7 @@ export declare type ComponentProps = {
      * Indicate whether elements inside the component are read-only
      * @public
      */
-    readonly?: boolean;
+    readOnly?: boolean;
     /**
      * Set a unique identifier for elements inside the component
      * @public
@@ -307,7 +307,7 @@ name: string;
 align?: CanvasTextAlign | undefined;
 edit?: boolean | undefined;
 label?: string | undefined;
-type?: string | undefined;
+fieldtype?: string | undefined;
 width?: string | undefined;
 pinned?: boolean | undefined;
 resizable?: boolean | undefined;
@@ -331,7 +331,7 @@ name: string;
 align?: CanvasTextAlign | undefined;
 edit?: boolean | undefined;
 label?: string | undefined;
-type?: string | undefined;
+fieldtype?: string | undefined;
 width?: string | undefined;
 pinned?: boolean | undefined;
 resizable?: boolean | undefined;
@@ -601,7 +601,7 @@ name: string;
 align?: CanvasTextAlign | undefined;
 edit?: boolean | undefined;
 label?: string | undefined;
-type?: string | undefined;
+fieldtype?: string | undefined;
 width?: string | undefined;
 pinned?: boolean | undefined;
 resizable?: boolean | undefined;
@@ -625,7 +625,7 @@ name: string;
 align?: CanvasTextAlign | undefined;
 edit?: boolean | undefined;
 label?: string | undefined;
-type?: string | undefined;
+fieldtype?: string | undefined;
 width?: string | undefined;
 pinned?: boolean | undefined;
 resizable?: boolean | undefined;
@@ -895,7 +895,7 @@ name: string;
 align?: CanvasTextAlign | undefined;
 edit?: boolean | undefined;
 label?: string | undefined;
-type?: string | undefined;
+fieldtype?: string | undefined;
 width?: string | undefined;
 pinned?: boolean | undefined;
 resizable?: boolean | undefined;
@@ -919,7 +919,7 @@ name: string;
 align?: CanvasTextAlign | undefined;
 edit?: boolean | undefined;
 label?: string | undefined;
-type?: string | undefined;
+fieldtype?: string | undefined;
 width?: string | undefined;
 pinned?: boolean | undefined;
 resizable?: boolean | undefined;
@@ -1185,6 +1185,15 @@ updateGanttBar: (event: GanttDragEvent) => void;
 updateRows: (newRows: TableRow[]) => void;
 }, "clearFilter" | "closeModal" | "createConnection" | "deleteConnection" | "getCellData" | "getCellDisplayValue" | "getConnectionsForBar" | "getFormattedValue" | "getHandlesForBar" | "getHeaderCellStyle" | "getIndent" | "getRowExpandSymbol" | "isRowGantt" | "isRowVisible" | "registerConnectionHandle" | "registerGanttBar" | "resizeColumn" | "setCellData" | "setCellText" | "setFilter" | "sortByColumn" | "toggleRowExpand" | "unregisterConnectionHandle" | "unregisterGanttBar" | "updateGanttBar" | "updateRows">>;
 
+/**
+ * Creates a validator with the given registry
+ * @param registry - Registry instance
+ * @param options - Additional validator options
+ * @returns SchemaValidator instance
+ * @public
+ */
+export declare function createValidator(registry: Registry, options?: Partial<ValidatorOptions>): SchemaValidator;
+
 /**
  * Cross-tab message payload
  * @public
@@ -2161,6 +2170,48 @@ export declare type Schema = {
  */
 export declare type SchemaTypes = FormSchema | TableSchema | FieldsetSchema;
 
+/**
+ * Schema validator class
+ * @public
+ */
+export declare class SchemaValidator {
+    private options;
+    /**
+     * Creates a new SchemaValidator instance
+     * @param options - Validator configuration options
+     */
+    constructor(options?: ValidatorOptions);
+    /**
+     * Validates a complete doctype schema
+     * @param doctype - Doctype name
+     * @param schema - Schema fields (List or Array)
+     * @param workflow - Optional workflow configuration
+     * @param actions - Optional actions map
+     * @returns Validation result
+     */
+    validate(doctype: string, schema: List<SchemaTypes> | SchemaTypes[] | undefined, workflow?: AnyStateNodeConfig, actions?: Map_2<string, string[]> | Map<string, string[]>): ValidationResult;
+    /**
+     * Validates that required schema properties are present
+     * @internal
+     */
+    private validateRequiredProperties;
+    /**
+     * Validates Link field targets exist in registry
+     * @internal
+     */
+    private validateLinkFields;
+    /**
+     * Validates workflow state machine configuration
+     * @internal
+     */
+    private validateWorkflow;
+    /**
+     * Validates that actions are registered in the FieldTriggerEngine
+     * @internal
+     */
+    private validateActionRegistration;
+}
+
 /**
  * Configure rollback behavior for a specific field trigger
  * @param doctype - The doctype name
@@ -2570,15 +2621,12 @@ export declare interface TableColumn {
      */
     label?: string;
     /**
-     * The data-type of the column. Possible values:
-     * - `Data` - the column contains text data
-     * - `Select` - the column contains a select input
-     * - `Date` - the column contains a date input
-     * - `component` - the column contains a custom component
+     * The semantic field type of the column. Uses the same StonecropFieldType enum as forms.
+     * Common values: 'Data', 'Text', 'Int', 'Float', 'Date', 'Select', 'Link', 'Check', etc.
      *
-     * @beta
+     * @public
      */
-    type?: string;
+    fieldtype?: string;
     /**
      * The width of the column. This can be a number (in pixels) or a string (in CSS units).
      *
@@ -3441,6 +3489,84 @@ export declare function useStonecrop(options: {
  */
 export declare function useUndoRedoShortcuts(hstStore: HSTNode, enabled?: boolean): void;
 
+/**
+ * Quick validation helper
+ * @param doctype - Doctype name
+ * @param schema - Schema fields
+ * @param registry - Registry instance
+ * @param workflow - Optional workflow configuration
+ * @param actions - Optional actions map
+ * @returns Validation result
+ * @public
+ */
+export declare function validateSchema(doctype: string, schema: List<SchemaTypes> | SchemaTypes[] | undefined, registry: Registry, workflow?: AnyStateNodeConfig, actions?: Map_2<string, string[]> | Map<string, string[]>): ValidationResult;
+
+/**
+ * Validation issue
+ * @public
+ */
+export declare interface ValidationIssue {
+    /** Severity level */
+    severity: ValidationSeverity;
+    /** Validation rule that failed */
+    rule: string;
+    /** Human-readable message */
+    message: string;
+    /** Doctype name */
+    doctype?: string;
+    /** Field name if applicable */
+    fieldname?: string;
+    /** Additional context */
+    context?: Record<string, unknown>;
+}
+
+/**
+ * Validation result
+ * @public
+ */
+export declare interface ValidationResult {
+    /** Whether validation passed (no blocking errors) */
+    valid: boolean;
+    /** List of validation issues */
+    issues: ValidationIssue[];
+    /** Count of errors */
+    errorCount: number;
+    /** Count of warnings */
+    warningCount: number;
+    /** Count of info messages */
+    infoCount: number;
+}
+
+/**
+ * Validation severity levels
+ * @public
+ */
+export declare enum ValidationSeverity {
+    /** Blocking error that prevents save */
+    ERROR = "error",
+    /** Advisory warning that allows save */
+    WARNING = "warning",
+    /** Informational message */
+    INFO = "info"
+}
+
+/**
+ * Schema validator options
+ * @public
+ */
+export declare interface ValidatorOptions {
+    /** Registry instance for doctype lookups */
+    registry?: Registry;
+    /** Whether to validate Link field targets */
+    validateLinkTargets?: boolean;
+    /** Whether to validate workflow reachability */
+    validateWorkflows?: boolean;
+    /** Whether to validate action registration */
+    validateActions?: boolean;
+    /** Whether to validate required schema properties */
+    validateRequiredProperties?: boolean;
+}
+
 /**
  * Batch operation helper
  * Wraps a function execution in a batch operation