@useinsider/guido 1.4.4-beta.9adffb8 → 1.4.4-beta.a48da7f

package/dist/src/@types/config/schemas.d.ts

@@ -0,0 +1,531 @@
+/**
+ * Guido Configuration Schemas
+ *
+ * Valibot schemas for validating and transforming Guido configuration.
+ * All types are inferred from these schemas to ensure single source of truth.
+ * @module @types/config/schemas
+ */
+import type { SavedTemplateDetails } from '../stripo';
+import * as v from 'valibot';
+/**
+ * Handler function for external validation before save
+ * @param data - The template details to validate
+ * @returns Promise<boolean> - true if valid, false to cancel save
+ */
+export type ExternalValidationHandler = (data: SavedTemplateDetails) => Promise<boolean>;
+/**
+ * Message type constants for email templates
+ */
+export declare const MessageType: {
+    /** Promotional/marketing emails */
+    readonly PROMOTIONAL: 1;
+    /** Transactional/system emails */
+    readonly TRANSACTIONAL: 2;
+};
+/**
+ * Product type constants for different Insider products
+ */
+export declare const ProductType: {
+    /** Standard email campaigns */
+    readonly EMAIL: 60;
+    /** Architect journey builder */
+    readonly ARCHITECT: 49;
+    /** Unsubscribe page builder */
+    readonly UNSUBSCRIBE_PAGES: 97;
+};
+/**
+ * Identity configuration - identifies the template and user
+ */
+export declare const IdentitySchema: v.ObjectSchema<{
+    /** Unique identifier for the template being edited */
+    readonly templateId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "templateId is required">]>;
+    /** Unique identifier for the user editing the template */
+    readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "userId is required">]>;
+    /** Optional variation ID for A/B testing */
+    readonly variationId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * Partner configuration - organization and product context
+ */
+export declare const PartnerSchema: v.ObjectSchema<{
+    /** Partner/organization name (required) */
+    readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "partner.name is required">]>;
+    /** Product type identifier */
+    readonly productType: v.OptionalSchema<v.PicklistSchema<[60, 49, 97], undefined>, 60>;
+    /** Message type (promotional or transactional) */
+    readonly messageType: v.OptionalSchema<v.PicklistSchema<[1, 2], undefined>, 1>;
+    /** Display name for the current user */
+    readonly username: v.OptionalSchema<v.StringSchema<undefined>, "Guido User">;
+}, undefined>;
+/**
+ * Dynamic content item schema
+ */
+export declare const DynamicContentSchema: v.ObjectSchema<{
+    /** Display text for the dynamic content */
+    readonly text: v.StringSchema<undefined>;
+    /** Template variable value (e.g., {{username}}) */
+    readonly value: v.StringSchema<undefined>;
+    /** Fallback value if variable is empty */
+    readonly fallback: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Optional formatting options */
+    readonly format: v.OptionalSchema<v.ObjectSchema<{
+        readonly key: v.StringSchema<undefined>;
+        readonly value: v.StringSchema<undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+/**
+ * Template configuration - initial content and preselected values
+ */
+export declare const TemplateSchema: v.ObjectSchema<{
+    /** Initial HTML content */
+    readonly html: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    /** Initial CSS content */
+    readonly css: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    /** Preselected dynamic content items */
+    readonly preselectedDynamicContent: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+        /** Display text for the dynamic content */
+        readonly text: v.StringSchema<undefined>;
+        /** Template variable value (e.g., {{username}}) */
+        readonly value: v.StringSchema<undefined>;
+        /** Fallback value if variable is empty */
+        readonly fallback: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Optional formatting options */
+        readonly format: v.OptionalSchema<v.ObjectSchema<{
+            readonly key: v.StringSchema<undefined>;
+            readonly value: v.StringSchema<undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>, readonly []>;
+    /** Selected unsubscribe page IDs */
+    readonly selectedUnsubscribePages: v.OptionalSchema<v.ArraySchema<v.NumberSchema<undefined>, undefined>, readonly []>;
+}, undefined>;
+/**
+ * Email header configuration (sender name and subject)
+ */
+export declare const EmailHeaderSchema: v.ObjectSchema<{
+    /** Sender display name */
+    readonly senderName: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    /** Email subject line */
+    readonly subject: v.OptionalSchema<v.StringSchema<undefined>, "">;
+}, undefined>;
+/**
+ * Editor configuration - core editor settings
+ */
+export declare const EditorSchema: v.ObjectSchema<{
+    /** Locale for the editor UI */
+    readonly locale: v.OptionalSchema<v.StringSchema<undefined>, "en">;
+    /** Path to translations object */
+    readonly translationsPath: v.OptionalSchema<v.StringSchema<undefined>, "window.trans.en">;
+    /** Migration date for template compatibility */
+    readonly migrationDate: v.OptionalSchema<v.NumberSchema<undefined>, 1759696858>;
+    /** Email header settings */
+    readonly emailHeader: v.OptionalSchema<v.ObjectSchema<{
+        /** Sender display name */
+        readonly senderName: v.OptionalSchema<v.StringSchema<undefined>, "">;
+        /** Email subject line */
+        readonly subject: v.OptionalSchema<v.StringSchema<undefined>, "">;
+    }, undefined>, {
+        readonly senderName: "";
+        readonly subject: "";
+    }>;
+}, undefined>;
+/**
+ * UI configuration - visual elements and layout
+ */
+export declare const UISchema: v.ObjectSchema<{
+    /** Whether to show the header bar */
+    readonly showHeader: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /** Custom label for back button (if shown) */
+    readonly backButtonLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * Features configuration - enable/disable editor features
+ */
+export declare const FeaturesSchema: v.ObjectSchema<{
+    /** Enable dynamic content insertion */
+    readonly dynamicContent: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /** Enable save as template functionality */
+    readonly saveAsTemplate: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /** Enable version history */
+    readonly versionHistory: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /** Enable test message sending */
+    readonly testMessage: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /** Enable display conditions */
+    readonly displayConditions: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    /** Enable unsubscribe block */
+    readonly unsubscribe: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+}, undefined>;
+/**
+ * Default block types available in Stripo
+ */
+export declare const DefaultBlockTypeSchema: v.PicklistSchema<["amp-accordion", "amp-carousel", "amp-form-controls", "banner-block", "button-block", "html-block", "image-block", "menu-block", "social-block", "spacer-block", "text-block", "timer-block", "video-block"], undefined>;
+/**
+ * Custom block types added by Guido
+ */
+export declare const CustomBlockTypeSchema: v.PicklistSchema<["dynamic-content", "checkbox-block", "radio-button-block", "recommendation-block", "unsubscribe-block", "coupon-block", "items-block"], undefined>;
+/**
+ * Blocks configuration - include/exclude specific blocks
+ */
+export declare const BlocksSchema: v.ObjectSchema<{
+    /** Default blocks to exclude from the editor */
+    readonly excludeDefaults: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["amp-accordion", "amp-carousel", "amp-form-controls", "banner-block", "button-block", "html-block", "image-block", "menu-block", "social-block", "spacer-block", "text-block", "timer-block", "video-block"], undefined>, undefined>, readonly []>;
+    /** Custom blocks to include in the editor */
+    readonly includeCustoms: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["dynamic-content", "checkbox-block", "radio-button-block", "recommendation-block", "unsubscribe-block", "coupon-block", "items-block"], undefined>, undefined>, readonly []>;
+}, undefined>;
+/**
+ * Compiler rule types
+ */
+export declare const CompilerRuleTypeSchema: v.PicklistSchema<["replace", "regex", "remove", "custom"], undefined>;
+/**
+ * Replace rule - simple string replacement
+ */
+export declare const ReplaceRuleSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"replace", undefined>;
+    /** String to search for */
+    readonly search: v.StringSchema<undefined>;
+    /** Replacement string */
+    readonly replacement: v.StringSchema<undefined>;
+    /** Replace all occurrences (default: false) */
+    readonly replaceAll: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>;
+/**
+ * Regex rule - regular expression replacement
+ */
+export declare const RegexRuleSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"regex", undefined>;
+    /** Regex pattern string */
+    readonly pattern: v.StringSchema<undefined>;
+    /** Replacement string (supports $1, $2, etc.) */
+    readonly replacement: v.StringSchema<undefined>;
+    /** Regex flags (e.g., 'gi') */
+    readonly flags: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>;
+/**
+ * Remove rule - remove matching content
+ */
+export declare const RemoveRuleSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"remove", undefined>;
+    /** Strings or patterns to remove */
+    readonly targets: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>;
+/**
+ * Custom rule - custom processing function
+ * Note: Functions cannot be validated at runtime, this is for type safety
+ */
+export declare const CustomRuleSchema: v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"custom", undefined>;
+    /** Custom processor function */
+    readonly processor: v.CustomSchema<(html: string) => string, v.ErrorMessage<v.CustomIssue> | undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>;
+/**
+ * Union of all compiler rule types
+ */
+export declare const CompilerRuleSchema: v.VariantSchema<"type", [v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"replace", undefined>;
+    /** String to search for */
+    readonly search: v.StringSchema<undefined>;
+    /** Replacement string */
+    readonly replacement: v.StringSchema<undefined>;
+    /** Replace all occurrences (default: false) */
+    readonly replaceAll: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"regex", undefined>;
+    /** Regex pattern string */
+    readonly pattern: v.StringSchema<undefined>;
+    /** Replacement string (supports $1, $2, etc.) */
+    readonly replacement: v.StringSchema<undefined>;
+    /** Regex flags (e.g., 'gi') */
+    readonly flags: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"remove", undefined>;
+    /** Strings or patterns to remove */
+    readonly targets: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>, v.ObjectSchema<{
+    readonly type: v.LiteralSchema<"custom", undefined>;
+    /** Custom processor function */
+    readonly processor: v.CustomSchema<(html: string) => string, v.ErrorMessage<v.CustomIssue> | undefined>;
+    /** Unique identifier for the rule */
+    readonly id: v.StringSchema<undefined>;
+    /** Human-readable description */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Priority for rule ordering (lower = earlier) */
+    readonly priority: v.NumberSchema<undefined>;
+}, undefined>], undefined>;
+/**
+ * Compiler configuration - HTML compilation settings
+ */
+export declare const CompilerSchema: v.ObjectSchema<{
+    /** Custom compiler rules to apply */
+    readonly customRules: v.OptionalSchema<v.ArraySchema<v.VariantSchema<"type", [v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"replace", undefined>;
+        /** String to search for */
+        readonly search: v.StringSchema<undefined>;
+        /** Replacement string */
+        readonly replacement: v.StringSchema<undefined>;
+        /** Replace all occurrences (default: false) */
+        readonly replaceAll: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** Unique identifier for the rule */
+        readonly id: v.StringSchema<undefined>;
+        /** Human-readable description */
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Priority for rule ordering (lower = earlier) */
+        readonly priority: v.NumberSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"regex", undefined>;
+        /** Regex pattern string */
+        readonly pattern: v.StringSchema<undefined>;
+        /** Replacement string (supports $1, $2, etc.) */
+        readonly replacement: v.StringSchema<undefined>;
+        /** Regex flags (e.g., 'gi') */
+        readonly flags: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Unique identifier for the rule */
+        readonly id: v.StringSchema<undefined>;
+        /** Human-readable description */
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Priority for rule ordering (lower = earlier) */
+        readonly priority: v.NumberSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"remove", undefined>;
+        /** Strings or patterns to remove */
+        readonly targets: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+        /** Unique identifier for the rule */
+        readonly id: v.StringSchema<undefined>;
+        /** Human-readable description */
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Priority for rule ordering (lower = earlier) */
+        readonly priority: v.NumberSchema<undefined>;
+    }, undefined>, v.ObjectSchema<{
+        readonly type: v.LiteralSchema<"custom", undefined>;
+        /** Custom processor function */
+        readonly processor: v.CustomSchema<(html: string) => string, v.ErrorMessage<v.CustomIssue> | undefined>;
+        /** Unique identifier for the rule */
+        readonly id: v.StringSchema<undefined>;
+        /** Human-readable description */
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /** Priority for rule ordering (lower = earlier) */
+        readonly priority: v.NumberSchema<undefined>;
+    }, undefined>], undefined>, undefined>, readonly []>;
+    /** Skip default compiler rules */
+    readonly ignoreDefaultRules: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+}, undefined>;
+/**
+ * Callbacks configuration - event handlers and hooks
+ */
+export declare const CallbacksSchema: v.ObjectSchema<{
+    /**
+     * External validation handler called before save completes.
+     * Return false to cancel the save operation.
+     */
+    readonly externalValidation: v.OptionalSchema<v.CustomSchema<ExternalValidationHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
+}, undefined>;
+/**
+ * Complete Guido configuration schema
+ *
+ * Organized by domain:
+ * - identity: Who is editing what
+ * - partner: Organization context
+ * - template: Initial content
+ * - editor: Core editor settings
+ * - ui: Visual elements
+ * - features: Feature toggles
+ * - blocks: Block configuration
+ * - compiler: HTML compilation
+ * - callbacks: Event handlers and hooks
+ */
+export declare const GuidoConfigSchema: v.ObjectSchema<{
+    /** Identity configuration (required) */
+    readonly identity: v.ObjectSchema<{
+        /** Unique identifier for the template being edited */
+        readonly templateId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "templateId is required">]>;
+        /** Unique identifier for the user editing the template */
+        readonly userId: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "userId is required">]>;
+        /** Optional variation ID for A/B testing */
+        readonly variationId: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+    /** Partner configuration (required) */
+    readonly partner: v.ObjectSchema<{
+        /** Partner/organization name (required) */
+        readonly name: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "partner.name is required">]>;
+        /** Product type identifier */
+        readonly productType: v.OptionalSchema<v.PicklistSchema<[60, 49, 97], undefined>, 60>;
+        /** Message type (promotional or transactional) */
+        readonly messageType: v.OptionalSchema<v.PicklistSchema<[1, 2], undefined>, 1>;
+        /** Display name for the current user */
+        readonly username: v.OptionalSchema<v.StringSchema<undefined>, "Guido User">;
+    }, undefined>;
+    /** Template content and presets */
+    readonly template: v.OptionalSchema<v.ObjectSchema<{
+        /** Initial HTML content */
+        readonly html: v.OptionalSchema<v.StringSchema<undefined>, "">;
+        /** Initial CSS content */
+        readonly css: v.OptionalSchema<v.StringSchema<undefined>, "">;
+        /** Preselected dynamic content items */
+        readonly preselectedDynamicContent: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            /** Display text for the dynamic content */
+            readonly text: v.StringSchema<undefined>;
+            /** Template variable value (e.g., {{username}}) */
+            readonly value: v.StringSchema<undefined>;
+            /** Fallback value if variable is empty */
+            readonly fallback: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** Optional formatting options */
+            readonly format: v.OptionalSchema<v.ObjectSchema<{
+                readonly key: v.StringSchema<undefined>;
+                readonly value: v.StringSchema<undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>, readonly []>;
+        /** Selected unsubscribe page IDs */
+        readonly selectedUnsubscribePages: v.OptionalSchema<v.ArraySchema<v.NumberSchema<undefined>, undefined>, readonly []>;
+    }, undefined>, {}>;
+    /** Editor settings */
+    readonly editor: v.OptionalSchema<v.ObjectSchema<{
+        /** Locale for the editor UI */
+        readonly locale: v.OptionalSchema<v.StringSchema<undefined>, "en">;
+        /** Path to translations object */
+        readonly translationsPath: v.OptionalSchema<v.StringSchema<undefined>, "window.trans.en">;
+        /** Migration date for template compatibility */
+        readonly migrationDate: v.OptionalSchema<v.NumberSchema<undefined>, 1759696858>;
+        /** Email header settings */
+        readonly emailHeader: v.OptionalSchema<v.ObjectSchema<{
+            /** Sender display name */
+            readonly senderName: v.OptionalSchema<v.StringSchema<undefined>, "">;
+            /** Email subject line */
+            readonly subject: v.OptionalSchema<v.StringSchema<undefined>, "">;
+        }, undefined>, {
+            readonly senderName: "";
+            readonly subject: "";
+        }>;
+    }, undefined>, {}>;
+    /** UI configuration */
+    readonly ui: v.OptionalSchema<v.ObjectSchema<{
+        /** Whether to show the header bar */
+        readonly showHeader: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+        /** Custom label for back button (if shown) */
+        readonly backButtonLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, {}>;
+    /** Feature toggles */
+    readonly features: v.OptionalSchema<v.ObjectSchema<{
+        /** Enable dynamic content insertion */
+        readonly dynamicContent: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+        /** Enable save as template functionality */
+        readonly saveAsTemplate: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+        /** Enable version history */
+        readonly versionHistory: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+        /** Enable test message sending */
+        readonly testMessage: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+        /** Enable display conditions */
+        readonly displayConditions: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+        /** Enable unsubscribe block */
+        readonly unsubscribe: v.OptionalSchema<v.BooleanSchema<undefined>, true>;
+    }, undefined>, {}>;
+    /** Block configuration */
+    readonly blocks: v.OptionalSchema<v.ObjectSchema<{
+        /** Default blocks to exclude from the editor */
+        readonly excludeDefaults: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["amp-accordion", "amp-carousel", "amp-form-controls", "banner-block", "button-block", "html-block", "image-block", "menu-block", "social-block", "spacer-block", "text-block", "timer-block", "video-block"], undefined>, undefined>, readonly []>;
+        /** Custom blocks to include in the editor */
+        readonly includeCustoms: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<["dynamic-content", "checkbox-block", "radio-button-block", "recommendation-block", "unsubscribe-block", "coupon-block", "items-block"], undefined>, undefined>, readonly []>;
+    }, undefined>, {}>;
+    /** Compiler configuration */
+    readonly compiler: v.OptionalSchema<v.ObjectSchema<{
+        /** Custom compiler rules to apply */
+        readonly customRules: v.OptionalSchema<v.ArraySchema<v.VariantSchema<"type", [v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"replace", undefined>;
+            /** String to search for */
+            readonly search: v.StringSchema<undefined>;
+            /** Replacement string */
+            readonly replacement: v.StringSchema<undefined>;
+            /** Replace all occurrences (default: false) */
+            readonly replaceAll: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            /** Unique identifier for the rule */
+            readonly id: v.StringSchema<undefined>;
+            /** Human-readable description */
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** Priority for rule ordering (lower = earlier) */
+            readonly priority: v.NumberSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"regex", undefined>;
+            /** Regex pattern string */
+            readonly pattern: v.StringSchema<undefined>;
+            /** Replacement string (supports $1, $2, etc.) */
+            readonly replacement: v.StringSchema<undefined>;
+            /** Regex flags (e.g., 'gi') */
+            readonly flags: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** Unique identifier for the rule */
+            readonly id: v.StringSchema<undefined>;
+            /** Human-readable description */
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** Priority for rule ordering (lower = earlier) */
+            readonly priority: v.NumberSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"remove", undefined>;
+            /** Strings or patterns to remove */
+            readonly targets: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+            /** Unique identifier for the rule */
+            readonly id: v.StringSchema<undefined>;
+            /** Human-readable description */
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** Priority for rule ordering (lower = earlier) */
+            readonly priority: v.NumberSchema<undefined>;
+        }, undefined>, v.ObjectSchema<{
+            readonly type: v.LiteralSchema<"custom", undefined>;
+            /** Custom processor function */
+            readonly processor: v.CustomSchema<(html: string) => string, v.ErrorMessage<v.CustomIssue> | undefined>;
+            /** Unique identifier for the rule */
+            readonly id: v.StringSchema<undefined>;
+            /** Human-readable description */
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /** Priority for rule ordering (lower = earlier) */
+            readonly priority: v.NumberSchema<undefined>;
+        }, undefined>], undefined>, undefined>, readonly []>;
+        /** Skip default compiler rules */
+        readonly ignoreDefaultRules: v.OptionalSchema<v.BooleanSchema<undefined>, false>;
+    }, undefined>, {}>;
+    /** Callbacks and event handlers */
+    readonly callbacks: v.OptionalSchema<v.ObjectSchema<{
+        /**
+         * External validation handler called before save completes.
+         * Return false to cancel the save operation.
+         */
+        readonly externalValidation: v.OptionalSchema<v.CustomSchema<ExternalValidationHandler, v.ErrorMessage<v.CustomIssue> | undefined>, undefined>;
+    }, undefined>, {}>;
+}, undefined>;