@vibesdotdev/config 0.0.1

package/dist/loader/validation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Per-Field Config Validation
+ *
+ * Validates config data field-by-field, keeping valid fields and
+ * discarding invalid ones. This allows multi-source configs to
+ * gracefully merge even when individual sources have invalid fields.
+ *
+ * @example
+ * ```ts
+ * // Project config has invalid toolApprovalMode
+ * const projectData = { name: 'Dev', toolApprovalMode: 'invalid', agentId: 'agent-1' };
+ * const { valid, issues } = validateFieldsGracefully(ChatModeRecordSchema, projectData);
+ * // valid = { name: 'Dev', agentId: 'agent-1' }
+ * // issues = [{ path: ['toolApprovalMode'], message: '...' }]
+ *
+ * // User config has valid toolApprovalMode
+ * const userData = { toolApprovalMode: 'auto-approve-safe' };
+ * const merged = deepMerge(valid, userData);
+ * // merged = { name: 'Dev', toolApprovalMode: 'auto-approve-safe', agentId: 'agent-1' }
+ * ```
+ */
+import type { z } from 'zod/v4';
+import type { FieldValidationIssue, FieldValidationResult, RecordValidationResult } from './schemas/validation.schema.ts';
+export type { FieldValidationIssue, FieldValidationResult, RecordValidationResult } from './schemas/validation.schema.ts';
+/**
+ * Validate data field-by-field against a Zod object schema.
+ * Returns only the fields that pass validation.
+ *
+ * @param schema - Zod object schema
+ * @param data - Data to validate
+ * @param basePath - Base path for error reporting (used in recursion)
+ */
+export declare function validateFieldsGracefully<T extends Record<string, unknown>>(schema: z.ZodObject<z.ZodRawShape>, data: unknown, basePath?: (string | number)[]): FieldValidationResult<T>;
+/**
+ * Validate a record (Record<string, T>) schema field-by-field per record.
+ * Each record is validated independently, and invalid fields within
+ * each record are discarded while keeping valid ones.
+ *
+ * @param schema - Zod record schema
+ * @param data - Data to validate
+ */
+export declare function validateRecordsGracefully<T extends Record<string, unknown>>(schema: z.ZodRecord, data: unknown): RecordValidationResult<T>;
+/**
+ * Validate data gracefully based on schema type.
+ * Automatically detects object vs record schemas.
+ *
+ * @param schema - Zod schema (object or record)
+ * @param data - Data to validate
+ */
+export declare function validateGracefully<T>(schema: z.ZodType<T>, data: unknown): {
+    valid: Partial<T>;
+    issues: FieldValidationIssue[];
+    hasIssues: boolean;
+};
+/**
+ * Format validation issues for logging/display
+ */
+export declare function formatValidationIssues(issues: FieldValidationIssue[], source?: string): string;
+//# sourceMappingURL=validation.d.ts.map

package/dist/loader/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/loader/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAE1H,YAAY,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAyC1H;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAClC,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO,GAChC,qBAAqB,CAAC,CAAC,CAAC,CAqD1B;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1E,MAAM,EAAE,CAAC,CAAC,SAAS,EACnB,IAAI,EAAE,OAAO,GACX,sBAAsB,CAAC,CAAC,CAAC,CAgD3B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EACnC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,OAAO,GACX;IAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAuC3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAW9F"}

package/dist/loader/validation.js

@@ -0,0 +1,218 @@
+/**
+ * Per-Field Config Validation
+ *
+ * Validates config data field-by-field, keeping valid fields and
+ * discarding invalid ones. This allows multi-source configs to
+ * gracefully merge even when individual sources have invalid fields.
+ *
+ * @example
+ * ```ts
+ * // Project config has invalid toolApprovalMode
+ * const projectData = { name: 'Dev', toolApprovalMode: 'invalid', agentId: 'agent-1' };
+ * const { valid, issues } = validateFieldsGracefully(ChatModeRecordSchema, projectData);
+ * // valid = { name: 'Dev', agentId: 'agent-1' }
+ * // issues = [{ path: ['toolApprovalMode'], message: '...' }]
+ *
+ * // User config has valid toolApprovalMode
+ * const userData = { toolApprovalMode: 'auto-approve-safe' };
+ * const merged = deepMerge(valid, userData);
+ * // merged = { name: 'Dev', toolApprovalMode: 'auto-approve-safe', agentId: 'agent-1' }
+ * ```
+ */
+/**
+ * Check if a Zod schema is an object schema
+ */
+function isZodObject(schema) {
+    return schema._zod?.def?.type === 'object';
+}
+/**
+ * Check if a Zod schema is a record schema
+ */
+function isZodRecord(schema) {
+    return schema._zod?.def?.type === 'record';
+}
+/**
+ * Get the shape (field schemas) from a Zod object schema
+ */
+function getObjectShape(schema) {
+    // Access shape from v4 internal structure or fallback to direct property
+    // Cast through unknown to handle Zod v4's readonly shape type
+    const schemaAny = schema;
+    const shape = schemaAny._zod?.def?.shape ?? schemaAny.shape ?? {};
+    return shape;
+}
+/**
+ * Get the value schema from a Zod record schema
+ */
+function getRecordValueSchema(schema) {
+    // Access valueType from v4 internal structure
+    const valueType = schema._zod?.def?.valueType ??
+        schema._def?.valueType;
+    return valueType;
+}
+/**
+ * Validate data field-by-field against a Zod object schema.
+ * Returns only the fields that pass validation.
+ *
+ * @param schema - Zod object schema
+ * @param data - Data to validate
+ * @param basePath - Base path for error reporting (used in recursion)
+ */
+export function validateFieldsGracefully(schema, data, basePath = []) {
+    const valid = {};
+    const issues = [];
+    // Handle non-object data
+    if (typeof data !== 'object' || data === null) {
+        return { valid: valid, issues, hasIssues: false };
+    }
+    const shape = getObjectShape(schema);
+    const dataObj = data;
+    for (const [key, fieldSchema] of Object.entries(shape)) {
+        if (!(key in dataObj)) {
+            continue; // Field not present, skip (defaults will fill in later)
+        }
+        const fieldValue = dataObj[key];
+        const fieldPath = [...basePath, key];
+        // Try to validate this field
+        const result = fieldSchema.safeParse(fieldValue);
+        if (result.success) {
+            valid[key] = result.data;
+        }
+        else if (isZodObject(fieldSchema) && typeof fieldValue === 'object' && fieldValue !== null) {
+            // Recurse into nested object
+            const nestedResult = validateFieldsGracefully(fieldSchema, fieldValue, fieldPath);
+            if (Object.keys(nestedResult.valid).length > 0) {
+                valid[key] = nestedResult.valid;
+            }
+            issues.push(...nestedResult.issues);
+        }
+        else {
+            // Record the issue
+            const issue = result.error.issues[0];
+            // In Zod v4, enum errors use 'invalid_value' code
+            const isEnumError = issue?.code === 'invalid_value' && 'options' in (issue ?? {});
+            issues.push({
+                path: fieldPath,
+                message: issue?.message ?? 'Invalid value',
+                invalidValue: fieldValue,
+                expected: isEnumError
+                    ? `one of: ${issue.options?.join(', ')}`
+                    : undefined
+            });
+        }
+    }
+    return {
+        valid: valid,
+        issues,
+        hasIssues: issues.length > 0
+    };
+}
+/**
+ * Validate a record (Record<string, T>) schema field-by-field per record.
+ * Each record is validated independently, and invalid fields within
+ * each record are discarded while keeping valid ones.
+ *
+ * @param schema - Zod record schema
+ * @param data - Data to validate
+ */
+export function validateRecordsGracefully(schema, data) {
+    const valid = {};
+    const issues = new Map();
+    // Handle non-object data
+    if (typeof data !== 'object' || data === null) {
+        return { valid, issues, hasIssues: false };
+    }
+    const valueSchema = getRecordValueSchema(schema);
+    const dataObj = data;
+    for (const [recordId, recordData] of Object.entries(dataObj)) {
+        if (isZodObject(valueSchema)) {
+            // Validate each record field-by-field
+            const recordResult = validateFieldsGracefully(valueSchema, recordData, [recordId]);
+            // Include record if it has any valid fields
+            if (Object.keys(recordResult.valid).length > 0) {
+                valid[recordId] = recordResult.valid;
+            }
+            if (recordResult.hasIssues) {
+                issues.set(recordId, recordResult.issues);
+            }
+        }
+        else {
+            // Non-object value schema - validate whole record
+            const result = valueSchema.safeParse(recordData);
+            if (result.success) {
+                valid[recordId] = result.data;
+            }
+            else {
+                issues.set(recordId, result.error.issues.map((i) => ({
+                    path: [recordId, ...i.path.filter((p) => typeof p !== 'symbol')],
+                    message: i.message,
+                    invalidValue: recordData
+                })));
+            }
+        }
+    }
+    return {
+        valid,
+        issues,
+        hasIssues: issues.size > 0
+    };
+}
+/**
+ * Validate data gracefully based on schema type.
+ * Automatically detects object vs record schemas.
+ *
+ * @param schema - Zod schema (object or record)
+ * @param data - Data to validate
+ */
+export function validateGracefully(schema, data) {
+    if (isZodRecord(schema)) {
+        const result = validateRecordsGracefully(schema, data);
+        // Flatten issues from Map to array
+        const flatIssues = [];
+        for (const recordIssues of result.issues.values()) {
+            flatIssues.push(...recordIssues);
+        }
+        return {
+            valid: result.valid,
+            issues: flatIssues,
+            hasIssues: result.hasIssues
+        };
+    }
+    if (isZodObject(schema)) {
+        const result = validateFieldsGracefully(schema, data);
+        return {
+            valid: result.valid,
+            issues: result.issues,
+            hasIssues: result.hasIssues
+        };
+    }
+    // For non-object schemas, just do standard validation
+    const result = schema.safeParse(data);
+    if (result.success) {
+        return { valid: result.data, issues: [], hasIssues: false };
+    }
+    return {
+        valid: {},
+        issues: result.error.issues.map((i) => ({
+            path: i.path.filter((p) => typeof p !== 'symbol'),
+            message: i.message,
+            invalidValue: data
+        })),
+        hasIssues: true
+    };
+}
+/**
+ * Format validation issues for logging/display
+ */
+export function formatValidationIssues(issues, source) {
+    if (issues.length === 0)
+        return '';
+    const lines = issues.map((issue) => {
+        const path = issue.path.join('.');
+        const expected = issue.expected ? ` (expected ${issue.expected})` : '';
+        return `  - ${path}: ${issue.message}${expected}`;
+    });
+    const header = source ? `Validation issues in ${source}:` : 'Validation issues:';
+    return [header, ...lines].join('\n');
+}
+//# sourceMappingURL=validation.js.map

package/dist/loader/validation.js.map

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

package/dist/manifest/builder.d.ts

@@ -0,0 +1,172 @@
+/**
+ * Configuration Manifest Builder
+ *
+ * Factory functions for creating configuration manifests with type safety.
+ */
+import type { z } from 'zod/v4';
+import type { ConfigManifest, ConfigFieldMeta, ConfigFieldGroup, ConfigContext, FieldUI, FieldOption, FieldDefaults, FieldRules, HardwareContext, EnvironmentContext, ConfigSurface } from './types.ts';
+import type { CreateManifestOptions } from './schemas/builder.schema.ts';
+export type { CreateManifestOptions };
+/**
+ * Create a configuration manifest
+ *
+ * @example
+ * ```typescript
+ * const aiConfigManifest = createConfigManifest({
+ *   id: 'ai',
+ *   name: 'AI Settings',
+ *   tier: 'user',
+ *   schema: aiConfigSchema,
+ *   storage: {
+ *     adapter: 'json',
+ *     scope: 'global',
+ *     namespace: 'ai'
+ *   }
+ * })
+ *   .group({ id: 'connection', label: 'Connection Settings', order: 1 })
+ *   .field('connectionMode', {
+ *     ui: { label: 'Connection Mode', component: 'radio-group', group: 'connection' },
+ *     options: [
+ *       { value: 'local-first', label: 'Local First', icon: '🔄' },
+ *       { value: 'local-only', label: 'Local Only', icon: '💻' },
+ *       { value: 'cloud', label: 'Cloud', icon: '☁️' }
+ *     ]
+ *   })
+ *   .build();
+ * ```
+ */
+export declare function createConfigManifest<T extends z.ZodTypeAny>(options: CreateManifestOptions<T>): ManifestBuilder<T>;
+/**
+ * Builder class for fluent manifest construction
+ */
+export declare class ManifestBuilder<T extends z.ZodTypeAny> {
+    private readonly options;
+    private readonly _fields;
+    private readonly _groups;
+    constructor(options: CreateManifestOptions<T>);
+    /**
+     * Add a field group
+     */
+    group(group: ConfigFieldGroup): this;
+    /**
+     * Add multiple field groups
+     */
+    groups(groups: ConfigFieldGroup[]): this;
+    /**
+     * Add a field with metadata
+     */
+    field(path: string, meta: ConfigFieldMeta): this;
+    /**
+     * Add multiple fields
+     */
+    fields(fields: Record<string, ConfigFieldMeta>): this;
+    /**
+     * Build the final manifest
+     */
+    build(): ConfigManifest<T>;
+}
+/**
+ * Create field metadata for a simple input field
+ */
+export declare function inputField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta;
+/**
+ * Create field metadata for a textarea field
+ */
+export declare function textareaField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta;
+/**
+ * Create field metadata for a number field
+ */
+export declare function numberField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta;
+/**
+ * Create field metadata for a boolean switch/checkbox field
+ */
+export declare function booleanField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+    asCheckbox?: boolean;
+}): ConfigFieldMeta;
+/**
+ * Create field metadata for a select field
+ * Supports two signatures:
+ * 1. selectField(label, optionsArray, config?) - options as array
+ * 2. selectField(label, configWithOptions) - options nested in config
+ */
+export declare function selectField<T extends string>(label: string, fieldOptionsOrConfig: FieldOption<T>[] | (Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+    options: FieldOption<T>[];
+}), options?: Partial<Omit<ConfigFieldMeta, 'ui' | 'options'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta<T>;
+/**
+ * Create field metadata for a radio group field
+ * Supports two signatures:
+ * 1. radioField(label, optionsArray, config?) - options as array
+ * 2. radioField(label, configWithOptions) - options nested in config
+ */
+export declare function radioField<T extends string>(label: string, fieldOptionsOrConfig: FieldOption<T>[] | (Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+    options: FieldOption<T>[];
+}), options?: Partial<Omit<ConfigFieldMeta, 'ui' | 'options'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta<T>;
+/**
+ * Create field metadata for a slider field
+ */
+export declare function sliderField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta;
+/**
+ * Create field metadata for a secret/password field
+ */
+export declare function secretField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta;
+/**
+ * Create field metadata for a JSON editor field
+ */
+export declare function jsonField(label: string, options?: Partial<Omit<ConfigFieldMeta, 'ui'>> & {
+    ui?: Partial<FieldUI>;
+}): ConfigFieldMeta;
+/**
+ * Create an option for enum/select fields
+ */
+export declare function option<T extends string>(value: T, label: string, extras?: Omit<FieldOption<T>, 'value' | 'label'>): FieldOption<T>;
+/**
+ * Create options from an enum-like object
+ */
+export declare function optionsFromEnum<T extends string>(enumObj: Record<T, string>, metadata?: Partial<Record<T, Omit<FieldOption<T>, 'value' | 'label'>>>): FieldOption<T>[];
+/**
+ * Create context-aware defaults
+ */
+export declare function defaults<T>(base: T, overrides?: {
+    byHardware?: Partial<Record<HardwareContext, T>>;
+    byEnvironment?: Partial<Record<EnvironmentContext, T>>;
+    bySurface?: Partial<Record<ConfigSurface, T>>;
+    resolver?: (ctx: ConfigContext) => T;
+}): FieldDefaults<T>;
+/**
+ * Create a field-based rule
+ */
+export declare function whenField(field: string, operator: 'equals' | 'notEquals' | 'in' | 'notIn' | 'exists' | 'isEmpty', value?: unknown): FieldRules['visibleWhen'];
+/**
+ * Create a context-based rule
+ */
+export declare function whenContext(context: keyof Omit<ConfigContext, 'get' | 'custom'> | `custom.${string}`, operator: 'equals' | 'notEquals' | 'in' | 'notIn' | 'exists', value?: unknown): FieldRules['visibleWhen'];
+/**
+ * Combine rules with AND
+ */
+export declare function allOf(...rules: NonNullable<FieldRules['visibleWhen']>[]): FieldRules['visibleWhen'];
+/**
+ * Combine rules with OR
+ */
+export declare function anyOf(...rules: NonNullable<FieldRules['visibleWhen']>[]): FieldRules['visibleWhen'];
+/**
+ * Negate a rule
+ */
+export declare function not(rule: NonNullable<FieldRules['visibleWhen']>): FieldRules['visibleWhen'];
+//# sourceMappingURL=builder.d.ts.map

package/dist/manifest/builder.d.ts.map

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