@hiveforge/hivemind-mcp 2.2.0 → 2.3.0

package/dist/templates/registry.js

@@ -0,0 +1,141 @@
+/**
+ * Template registry for managing template lifecycle.
+ *
+ * Provides centralized template management with O(1) lookups
+ * and validation on registration.
+ */
+/**
+ * Manages registered templates with fast lookups.
+ *
+ * Singleton pattern ensures consistent state across the application.
+ * Validates templates on registration and provides O(1) entity type lookups.
+ */
+export class TemplateRegistry {
+    /** Map from template ID to registry entry */
+    templates = new Map();
+    /** ID of the currently active template */
+    activeTemplateId = null;
+    /**
+     * Registers a template in the registry.
+     *
+     * Validates the template definition and creates optimized lookup maps.
+     *
+     * @param template - Template definition to register
+     * @param source - Source of the template (builtin or config)
+     * @throws {Error} If template with this ID is already registered
+     */
+    register(template, source) {
+        if (this.templates.has(template.id)) {
+            throw new Error(`Template "${template.id}" is already registered`);
+        }
+        // Create entity type lookup map for O(1) access
+        const entityTypeMap = new Map();
+        for (const entityType of template.entityTypes) {
+            if (entityTypeMap.has(entityType.name)) {
+                throw new Error(`Duplicate entity type "${entityType.name}" in template "${template.id}"`);
+            }
+            entityTypeMap.set(entityType.name, entityType);
+        }
+        const entry = {
+            ...template,
+            source,
+            entityTypeMap,
+        };
+        this.templates.set(template.id, entry);
+    }
+    /**
+     * Sets the active template by ID.
+     *
+     * @param templateId - ID of template to activate
+     * @throws {Error} If template ID is not registered
+     */
+    activate(templateId) {
+        if (!this.templates.has(templateId)) {
+            throw new Error(`Cannot activate template "${templateId}": not registered. ` +
+                `Available templates: ${Array.from(this.templates.keys()).join(', ')}`);
+        }
+        this.activeTemplateId = templateId;
+    }
+    /**
+     * Gets the currently active template.
+     *
+     * @returns Active template entry, or null if no template is active
+     */
+    getActive() {
+        if (this.activeTemplateId === null) {
+            return null;
+        }
+        return this.templates.get(this.activeTemplateId) ?? null;
+    }
+    /**
+     * Gets a template by ID.
+     *
+     * @param templateId - Template ID to retrieve
+     * @returns Template entry if found, undefined otherwise
+     */
+    get(templateId) {
+        return this.templates.get(templateId);
+    }
+    /**
+     * Checks if a template is registered.
+     *
+     * @param templateId - Template ID to check
+     * @returns True if template exists in registry
+     */
+    has(templateId) {
+        return this.templates.has(templateId);
+    }
+    /**
+     * Lists all registered template IDs.
+     *
+     * @returns Array of template IDs
+     */
+    listTemplates() {
+        return Array.from(this.templates.keys());
+    }
+    /**
+     * Gets an entity type config from the active template.
+     *
+     * O(1) lookup using the entity type map.
+     *
+     * @param name - Entity type name to retrieve
+     * @returns Entity type config if found, undefined otherwise
+     * @throws {Error} If no template is active
+     */
+    getEntityType(name) {
+        const active = this.getActive();
+        if (!active) {
+            throw new Error('Cannot get entity type: no active template');
+        }
+        return active.entityTypeMap.get(name);
+    }
+    /**
+     * Gets all entity type configs from the active template.
+     *
+     * @returns Array of entity type configs
+     * @throws {Error} If no template is active
+     */
+    getEntityTypes() {
+        const active = this.getActive();
+        if (!active) {
+            throw new Error('Cannot get entity types: no active template');
+        }
+        return active.entityTypes;
+    }
+    /**
+     * Clears all registered templates and resets active template.
+     *
+     * Primarily for testing purposes.
+     */
+    clear() {
+        this.templates.clear();
+        this.activeTemplateId = null;
+    }
+}
+/**
+ * Singleton instance of the template registry.
+ *
+ * Use this throughout the application for consistent template state.
+ */
+export const templateRegistry = new TemplateRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/templates/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/templates/registry.ts"],"names":[],"mappings":"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"}

package/dist/templates/schema-factory.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Schema factory for dynamically generating Zod schemas from entity type configurations.
+ *
+ * This module is the core of the template system's runtime validation - it transforms
+ * user-defined EntityTypeConfig objects into Zod schemas that extend the base entity
+ * schema with custom fields.
+ */
+import { z } from 'zod';
+import type { EntityTypeConfig } from './types.js';
+/**
+ * Create a complete Zod schema for an entity type from its configuration.
+ *
+ * The generated schema extends BaseFrontmatterSchema with:
+ * - Type literal enforcement (type must match entity type name)
+ * - All custom fields from the entity config
+ *
+ * @param config - Entity type configuration
+ * @returns Zod schema that validates entities of this type
+ */
+export declare function createEntitySchema(config: EntityTypeConfig): z.ZodObject<any>;
+/**
+ * Factory class for managing schema generation with caching.
+ *
+ * Generates Zod schemas once per entity type and caches them for performance.
+ * Useful when validating multiple entities of the same type.
+ */
+export declare class SchemaFactory {
+    private schemaCache;
+    /**
+     * Get or create a schema for an entity type.
+     *
+     * If a schema for this entity type has been generated before, returns the
+     * cached version. Otherwise, generates and caches a new schema.
+     *
+     * @param config - Entity type configuration
+     * @returns Cached or newly generated Zod schema
+     */
+    getSchema(config: EntityTypeConfig): z.ZodObject<any>;
+    /**
+     * Generate schemas for multiple entity types at once.
+     *
+     * Useful for bulk schema generation (e.g., when loading a template).
+     * Returns a map of entity type name to schema.
+     *
+     * @param configs - Array of entity type configurations
+     * @returns Map from entity type name to Zod schema
+     */
+    generateSchemas(configs: EntityTypeConfig[]): Map<string, z.ZodObject<any>>;
+    /**
+     * Clear the schema cache.
+     *
+     * Useful for testing or when entity type configurations change at runtime.
+     */
+    clearCache(): void;
+    /**
+     * Get the number of cached schemas.
+     *
+     * @returns Number of schemas currently cached
+     */
+    getCacheSize(): number;
+}
+/**
+ * Singleton instance of SchemaFactory for shared caching across the application.
+ */
+export declare const schemaFactory: SchemaFactory;
+/**
+ * Type helper to infer TypeScript type from generated entity schema.
+ *
+ * Usage:
+ * ```ts
+ * const characterSchema = createEntitySchema(characterConfig);
+ * type Character = InferEntityType<typeof characterSchema>;
+ * ```
+ */
+export type InferEntityType<T extends z.ZodObject<any>> = z.infer<T>;
+//# sourceMappingURL=schema-factory.d.ts.map

package/dist/templates/schema-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-factory.d.ts","sourceRoot":"","sources":["../../src/templates/schema-factory.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,YAAY,CAAC;AA2F3E;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAe7E;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,WAAW,CAA4C;IAE/D;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC;IAWrD;;;;;;;;OAQG;IACH,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAU3E;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC"}

package/dist/templates/schema-factory.js

@@ -0,0 +1,171 @@
+/**
+ * Schema factory for dynamically generating Zod schemas from entity type configurations.
+ *
+ * This module is the core of the template system's runtime validation - it transforms
+ * user-defined EntityTypeConfig objects into Zod schemas that extend the base entity
+ * schema with custom fields.
+ */
+import { z } from 'zod';
+import { BaseFrontmatterSchema } from '../types/index.js';
+/**
+ * Build a Zod schema for a primitive field type.
+ * Used for array item types and standalone fields.
+ */
+function buildPrimitiveSchema(type) {
+    switch (type) {
+        case 'string':
+            return z.string();
+        case 'number':
+            return z.number();
+        case 'boolean':
+            return z.boolean();
+        case 'date':
+            return z.string(); // ISO 8601 date string
+        case 'record':
+            return z.record(z.string(), z.any());
+        default:
+            // For enum/array types used as primitives, fall back to string
+            return z.string();
+    }
+}
+/**
+ * Build a Zod schema for a single field based on its configuration.
+ *
+ * Handles all field types: string, number, boolean, enum, array, date, record.
+ * Applies required/optional modifiers and default values.
+ */
+function buildFieldSchema(field) {
+    let schema;
+    switch (field.type) {
+        case 'string':
+            schema = z.string();
+            break;
+        case 'number':
+            schema = z.number();
+            break;
+        case 'boolean':
+            schema = z.boolean();
+            break;
+        case 'enum':
+            if (!field.enumValues || field.enumValues.length === 0) {
+                throw new Error(`Field "${field.name}" of type enum must specify enumValues`);
+            }
+            // Build enum schema from first value + rest
+            schema = z.enum([field.enumValues[0], ...field.enumValues.slice(1)]);
+            break;
+        case 'array':
+            // Determine the item type (default to string if not specified)
+            const itemType = field.arrayItemType || 'string';
+            const itemSchema = buildPrimitiveSchema(itemType);
+            schema = z.array(itemSchema);
+            break;
+        case 'date':
+            // ISO 8601 date string
+            schema = z.string();
+            break;
+        case 'record':
+            // Key-value pairs
+            schema = z.record(z.string(), z.any());
+            break;
+        default:
+            // Fallback for unknown types
+            schema = z.any();
+    }
+    // Apply optional/required modifiers
+    // Fields are optional by default unless explicitly marked required
+    if (!field.required) {
+        schema = schema.optional();
+    }
+    // Apply default value if provided
+    if (field.default !== undefined) {
+        schema = schema.default(field.default);
+    }
+    return schema;
+}
+/**
+ * Create a complete Zod schema for an entity type from its configuration.
+ *
+ * The generated schema extends BaseFrontmatterSchema with:
+ * - Type literal enforcement (type must match entity type name)
+ * - All custom fields from the entity config
+ *
+ * @param config - Entity type configuration
+ * @returns Zod schema that validates entities of this type
+ */
+export function createEntitySchema(config) {
+    // Build the shape for custom fields
+    const customFields = {};
+    for (const field of config.fields) {
+        customFields[field.name] = buildFieldSchema(field);
+    }
+    // Extend BaseFrontmatterSchema with custom fields and enforce type literal
+    const schema = BaseFrontmatterSchema.extend({
+        type: z.literal(config.name), // Enforce this specific entity type
+        ...customFields,
+    });
+    return schema;
+}
+/**
+ * Factory class for managing schema generation with caching.
+ *
+ * Generates Zod schemas once per entity type and caches them for performance.
+ * Useful when validating multiple entities of the same type.
+ */
+export class SchemaFactory {
+    schemaCache = new Map();
+    /**
+     * Get or create a schema for an entity type.
+     *
+     * If a schema for this entity type has been generated before, returns the
+     * cached version. Otherwise, generates and caches a new schema.
+     *
+     * @param config - Entity type configuration
+     * @returns Cached or newly generated Zod schema
+     */
+    getSchema(config) {
+        const cached = this.schemaCache.get(config.name);
+        if (cached) {
+            return cached;
+        }
+        const schema = createEntitySchema(config);
+        this.schemaCache.set(config.name, schema);
+        return schema;
+    }
+    /**
+     * Generate schemas for multiple entity types at once.
+     *
+     * Useful for bulk schema generation (e.g., when loading a template).
+     * Returns a map of entity type name to schema.
+     *
+     * @param configs - Array of entity type configurations
+     * @returns Map from entity type name to Zod schema
+     */
+    generateSchemas(configs) {
+        const schemas = new Map();
+        for (const config of configs) {
+            schemas.set(config.name, this.getSchema(config));
+        }
+        return schemas;
+    }
+    /**
+     * Clear the schema cache.
+     *
+     * Useful for testing or when entity type configurations change at runtime.
+     */
+    clearCache() {
+        this.schemaCache.clear();
+    }
+    /**
+     * Get the number of cached schemas.
+     *
+     * @returns Number of schemas currently cached
+     */
+    getCacheSize() {
+        return this.schemaCache.size;
+    }
+}
+/**
+ * Singleton instance of SchemaFactory for shared caching across the application.
+ */
+export const schemaFactory = new SchemaFactory();
+//# sourceMappingURL=schema-factory.js.map

package/dist/templates/schema-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-factory.js","sourceRoot":"","sources":["../../src/templates/schema-factory.ts"],"names":[],"mappings":"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"}

package/dist/templates/types.d.ts

@@ -99,4 +99,16 @@ export interface TemplateRegistryEntry extends TemplateDefinition {
     /** Fast lookup map from entity type name to config */
     entityTypeMap: Map<string, EntityTypeConfig>;
 }
+/**
+ * Mapping from folder name/pattern to entity type.
+ *
+ * Used by FolderMapper to infer entity types from file paths.
+ * Supports both exact folder name matches and glob-like patterns.
+ */
+export interface FolderMapping {
+    /** Folder name or pattern to match (case-insensitive) */
+    pattern: string;
+    /** Entity type to assign when pattern matches */
+    entityType: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/templates/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/templates/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC;IAEhB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEjC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,wDAAwD;IACxD,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAE7B,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/templates/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,CAAC;AAEb;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,6BAA6B;IAC7B,IAAI,EAAE,SAAS,CAAC;IAEhB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IAEpB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8CAA8C;IAC9C,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IAEX,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IAEb,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6CAA6C;IAC7C,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,mEAAmE;IACnE,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAEjC,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,wDAAwD;IACxD,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAE7B,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/templates/validator.d.ts

@@ -0,0 +1,200 @@
+/**
+ * Template configuration validation using Zod.
+ *
+ * Provides schema validation for template configs to fail fast at startup
+ * before schema generation, ensuring user configs are valid.
+ */
+import { z } from 'zod';
+import type { TemplateConfig } from './types.js';
+/**
+ * Zod schema for field configuration validation.
+ *
+ * Validates:
+ * - Field names are camelCase alphanumeric
+ * - Type is one of the supported FieldType values
+ * - Enum fields have enumValues defined
+ * - Array fields have valid arrayItemType
+ */
+export declare const FieldConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        array: "array";
+        date: "date";
+        record: "record";
+    }>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    default: z.ZodOptional<z.ZodUnknown>;
+    enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    arrayItemType: z.ZodOptional<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        enum: "enum";
+        array: "array";
+        date: "date";
+        record: "record";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for entity type configuration validation.
+ *
+ * Validates:
+ * - Entity type names are lowercase alphanumeric
+ * - Display names and plural names are provided
+ * - Fields array is valid
+ */
+export declare const EntityTypeConfigSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodString;
+    pluralName: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            array: "array";
+            date: "date";
+            record: "record";
+        }>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        arrayItemType: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            enum: "enum";
+            array: "array";
+            date: "date";
+            record: "record";
+        }>>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    icon: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Zod schema for template definition validation.
+ *
+ * Validates:
+ * - Template ID is lowercase alphanumeric with hyphens
+ * - Version follows semantic versioning (X.Y.Z)
+ * - Entity types array is valid and non-empty
+ */
+export declare const TemplateDefinitionSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    entityTypes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        displayName: z.ZodString;
+        pluralName: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        fields: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                array: "array";
+                date: "date";
+                record: "record";
+            }>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            default: z.ZodOptional<z.ZodUnknown>;
+            enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            arrayItemType: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                enum: "enum";
+                array: "array";
+                date: "date";
+                record: "record";
+            }>>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        icon: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Zod schema for full template configuration validation.
+ *
+ * Validates:
+ * - Templates array (if provided) contains valid templates
+ * - activeTemplate is specified
+ */
+export declare const TemplateConfigSchema: z.ZodObject<{
+    templates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        version: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        entityTypes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            displayName: z.ZodString;
+            pluralName: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            fields: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                type: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    enum: "enum";
+                    array: "array";
+                    date: "date";
+                    record: "record";
+                }>;
+                required: z.ZodOptional<z.ZodBoolean>;
+                default: z.ZodOptional<z.ZodUnknown>;
+                enumValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                arrayItemType: z.ZodOptional<z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    enum: "enum";
+                    array: "array";
+                    date: "date";
+                    record: "record";
+                }>>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+            icon: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    activeTemplate: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Custom error class for template validation failures.
+ *
+ * Provides structured error information and user-friendly messages.
+ */
+export declare class TemplateValidationError extends Error {
+    readonly issues: z.ZodIssue[];
+    constructor(message: string, issues: z.ZodIssue[]);
+    /**
+     * Converts Zod validation issues to a user-friendly error message.
+     *
+     * @returns Formatted error message with all validation issues
+     */
+    toUserMessage(): string;
+}
+/**
+ * Validates template configuration against schema.
+ *
+ * @param config - Template configuration to validate
+ * @returns Validated and typed configuration
+ * @throws {TemplateValidationError} If validation fails with details of all issues
+ */
+export declare function validateTemplateConfig(config: unknown): TemplateConfig;
+//# sourceMappingURL=validator.d.ts.map

package/dist/templates/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/templates/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAIV,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;iBAgCM,CAAC;AAErC;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAaK,CAAC;AAEzC;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgBK,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAGK,CAAC;AAEvC;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;aAG9B,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;gBADpC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAMtC;;;;OAIG;IACH,aAAa,IAAI,MAAM;CAUxB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAQtE"}