@vibesdotdev/config 0.0.1

package/dist/manifest/builder.js

@@ -0,0 +1,336 @@
+/**
+ * Configuration Manifest Builder
+ *
+ * Factory functions for creating configuration manifests with type safety.
+ */
+/**
+ * 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 function createConfigManifest(options) {
+    return new ManifestBuilder(options);
+}
+/**
+ * Builder class for fluent manifest construction
+ */
+export class ManifestBuilder {
+    options;
+    _fields = new Map();
+    _groups = [];
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Add a field group
+     */
+    group(group) {
+        this._groups.push(group);
+        return this;
+    }
+    /**
+     * Add multiple field groups
+     */
+    groups(groups) {
+        this._groups.push(...groups);
+        return this;
+    }
+    /**
+     * Add a field with metadata
+     */
+    field(path, meta) {
+        this._fields.set(path, meta);
+        return this;
+    }
+    /**
+     * Add multiple fields
+     */
+    fields(fields) {
+        for (const [path, meta] of Object.entries(fields)) {
+            this._fields.set(path, meta);
+        }
+        return this;
+    }
+    /**
+     * Build the final manifest
+     */
+    build() {
+        const fields = {};
+        for (const [path, meta] of this._fields) {
+            fields[path] = meta;
+        }
+        return {
+            id: this.options.id,
+            name: this.options.name,
+            description: this.options.description,
+            icon: this.options.icon,
+            version: this.options.version,
+            tier: this.options.tier,
+            category: this.options.category,
+            schema: this.options.schema,
+            fields,
+            groups: this._groups.length > 0 ? this._groups : undefined,
+            storage: this.options.storage,
+            context: this.options.context,
+            navigation: this.options.navigation,
+            onLoad: this.options.onLoad,
+            onSave: this.options.onSave,
+            onFieldChange: this.options.onFieldChange
+        };
+    }
+}
+// Field Builder Helpers
+/**
+ * Create field metadata for a simple input field
+ */
+export function inputField(label, options) {
+    const { ui: uiOptions, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: 'input',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+/**
+ * Create field metadata for a textarea field
+ */
+export function textareaField(label, options) {
+    const { ui: uiOptions, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: 'textarea',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+/**
+ * Create field metadata for a number field
+ */
+export function numberField(label, options) {
+    const { ui: uiOptions, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: 'number',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+/**
+ * Create field metadata for a boolean switch/checkbox field
+ */
+export function booleanField(label, options) {
+    const { ui: uiOptions, asCheckbox, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: asCheckbox ? 'checkbox' : 'switch',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+/**
+ * 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 function selectField(label, fieldOptionsOrConfig, options) {
+    // Handle both signatures
+    if (Array.isArray(fieldOptionsOrConfig)) {
+        // Signature 1: selectField(label, optionsArray, config?)
+        const { ui: uiOptions, ...rest } = options ?? {};
+        return {
+            ui: {
+                label,
+                component: 'select',
+                ...uiOptions
+            },
+            options: fieldOptionsOrConfig,
+            ...rest
+        };
+    }
+    else {
+        // Signature 2: selectField(label, configWithOptions)
+        const { ui: uiOptions, options: fieldOptions, ...rest } = fieldOptionsOrConfig;
+        return {
+            ui: {
+                label,
+                component: 'select',
+                ...uiOptions
+            },
+            options: fieldOptions,
+            ...rest
+        };
+    }
+}
+/**
+ * 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 function radioField(label, fieldOptionsOrConfig, options) {
+    // Handle both signatures
+    if (Array.isArray(fieldOptionsOrConfig)) {
+        // Signature 1: radioField(label, optionsArray, config?)
+        const { ui: uiOptions, ...rest } = options ?? {};
+        return {
+            ui: {
+                label,
+                component: 'radio-group',
+                ...uiOptions
+            },
+            options: fieldOptionsOrConfig,
+            ...rest
+        };
+    }
+    else {
+        // Signature 2: radioField(label, configWithOptions)
+        const { ui: uiOptions, options: fieldOptions, ...rest } = fieldOptionsOrConfig;
+        return {
+            ui: {
+                label,
+                component: 'radio-group',
+                ...uiOptions
+            },
+            options: fieldOptions,
+            ...rest
+        };
+    }
+}
+/**
+ * Create field metadata for a slider field
+ */
+export function sliderField(label, options) {
+    const { ui: uiOptions, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: 'slider',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+/**
+ * Create field metadata for a secret/password field
+ */
+export function secretField(label, options) {
+    const { ui: uiOptions, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: 'secret',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+/**
+ * Create field metadata for a JSON editor field
+ */
+export function jsonField(label, options) {
+    const { ui: uiOptions, ...rest } = options ?? {};
+    return {
+        ui: {
+            label,
+            component: 'json',
+            ...uiOptions
+        },
+        ...rest
+    };
+}
+// Options Builder Helpers
+/**
+ * Create an option for enum/select fields
+ */
+export function option(value, label, extras) {
+    return {
+        value,
+        label,
+        ...extras
+    };
+}
+/**
+ * Create options from an enum-like object
+ */
+export function optionsFromEnum(enumObj, metadata) {
+    return Object.entries(enumObj).map(([value, label]) => ({
+        value: value,
+        label: label,
+        ...metadata?.[value]
+    }));
+}
+// Defaults Builder Helpers
+/**
+ * Create context-aware defaults
+ */
+export function defaults(base, overrides) {
+    return {
+        base,
+        ...overrides
+    };
+}
+// Rules Builder Helpers
+/**
+ * Create a field-based rule
+ */
+export function whenField(field, operator, value) {
+    return { field, operator, value };
+}
+/**
+ * Create a context-based rule
+ */
+export function whenContext(context, operator, value) {
+    return { context, operator, value };
+}
+/**
+ * Combine rules with AND
+ */
+export function allOf(...rules) {
+    return { and: rules };
+}
+/**
+ * Combine rules with OR
+ */
+export function anyOf(...rules) {
+    return { or: rules };
+}
+/**
+ * Negate a rule
+ */
+export function not(rule) {
+    return { not: rule };
+}
+//# sourceMappingURL=builder.js.map

package/dist/manifest/builder.js.map

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

package/dist/manifest/config-manifest.d.ts

@@ -0,0 +1,199 @@
+/**
+ * Config Manifest Class
+ *
+ * Extends StorageManifest with form metadata and UI rendering support.
+ * This is the runtime class used by the config module.
+ */
+import { StorageManifest } from '@vibesdotdev/storage/manifest';
+import type { Unsubscribe } from '@vibesdotdev/storage/interfaces/document-store';
+import type { KindContext } from '@vibesdotdev/runtime/schemas/kind';
+import type { ConfigManifestDescriptor, ConfigFieldMeta, ConfigFieldGroup, ManifestNavigation, ManifestContext, ConfigTier } from '../schemas/config-manifest-descriptor';
+import type { ConfigContext } from '../manifest/types';
+import type { ConfigChangeCallback } from './schemas/config-manifest.schema.ts';
+export type { ConfigChangeCallback };
+/**
+ * Config Manifest - extends StorageManifest with form metadata.
+ *
+ * Provides:
+ * - All StorageManifest operations (load, save, exists, delete)
+ * - Form field metadata for UI rendering
+ * - Context-aware default values
+ * - Conditional visibility rules
+ * - Navigation configuration
+ * - Field-level get/set/subscribe for reactive config access
+ *
+ * @template T - The type of configuration data
+ *
+ * @example
+ * ```ts
+ * // Create from descriptor (runtime instantiation)
+ * const manifest = new ConfigManifest<AIConfig>(descriptor);
+ *
+ * // Load with defaults applied
+ * const config = await manifest.loadWithDefaults(context);
+ *
+ * // Get visible fields for rendering
+ * const fields = manifest.getVisibleFields(currentValues, context);
+ *
+ * // Reactive field-level access (runtime-aligned, replaces createConfigAccessor)
+ * const config = manifest.get();
+ * manifest.setField('temperature', 0.8);
+ * manifest.subscribe((config) => console.log('Config changed:', config));
+ * ```
+ */
+export declare class ConfigManifest<T> extends StorageManifest<T> {
+    protected readonly configDescriptor: ConfigManifestDescriptor;
+    /**
+     * Create a config manifest instance.
+     *
+     * @param descriptorOrId - Either the full descriptor (for runtime instantiation)
+     *                         or the manifest ID string (for manual instantiation)
+     * @param context - Runtime context (optional for manual instantiation, provided by runtime resolution)
+     */
+    constructor(descriptorOrId: ConfigManifestDescriptor | string, context?: KindContext);
+    /**
+     * Create a config manifest by looking up its ID.
+     */
+    static fromId<T>(manifestId: string): ConfigManifest<T>;
+    /**
+     * Get the configuration tier.
+     */
+    get tier(): ConfigTier;
+    /**
+     * Get the manifest name.
+     */
+    get name(): string | undefined;
+    /**
+     * Get the manifest description.
+     */
+    get description(): string | undefined;
+    /**
+     * Get the category within the tier.
+     */
+    get category(): string | undefined;
+    /**
+     * Get field metadata for all fields.
+     */
+    get fields(): Record<string, ConfigFieldMeta>;
+    /**
+     * Get field groups for UI organization.
+     */
+    get groups(): ConfigFieldGroup[];
+    /**
+     * Get navigation configuration.
+     */
+    get navigation(): ManifestNavigation | undefined;
+    /**
+     * Get context constraints for this manifest.
+     * (Named differently from base class 'context' which is runtime context)
+     */
+    get manifestContext(): ManifestContext | undefined;
+    /**
+     * Get the manifest icon.
+     */
+    get icon(): string | undefined;
+    /**
+     * Get sensitive fields list.
+     */
+    get sensitiveFields(): string[] | undefined;
+    /**
+     * Get metadata for a specific field.
+     */
+    getFieldMeta(fieldPath: string): ConfigFieldMeta | undefined;
+    /**
+     * Get all field paths.
+     */
+    getFieldPaths(): string[];
+    /**
+     * Get fields in a specific group.
+     */
+    getFieldsInGroup(groupId: string): string[];
+    /**
+     * Get fields without a group.
+     */
+    getUngroupedFields(): string[];
+    /**
+     * Resolve the default value for a field based on context.
+     */
+    resolveDefault<V>(fieldPath: string, ctx: ConfigContext): V | undefined;
+    /**
+     * Get all default values for the current context.
+     */
+    getDefaults(ctx: ConfigContext): Partial<T>;
+    /**
+     * Check if a field is visible based on current values and context.
+     */
+    isFieldVisible(fieldPath: string, values: Record<string, unknown>, ctx: ConfigContext): boolean;
+    /**
+     * Check if a field is disabled based on current values and context.
+     */
+    isFieldDisabled(fieldPath: string, values: Record<string, unknown>, ctx: ConfigContext): boolean;
+    /**
+     * Check if a field is required based on current values and context.
+     */
+    isFieldRequired(fieldPath: string, values: Record<string, unknown>, ctx: ConfigContext): boolean;
+    /**
+     * Get all visible fields for the current values and context.
+     */
+    getVisibleFields(values: Record<string, unknown>, ctx: ConfigContext): string[];
+    /**
+     * Check if a group is visible based on current values and context.
+     */
+    isGroupVisible(groupId: string, values: Record<string, unknown>, ctx: ConfigContext): boolean;
+    /**
+     * Check if this manifest applies to the given context.
+     */
+    appliesToContext(ctx: ConfigContext): boolean;
+    /**
+     * Load configuration with context-aware defaults applied.
+     *
+     * @param ctx - Current config context
+     * @returns Merged config with defaults applied for missing fields
+     */
+    loadWithDefaults(ctx: ConfigContext): Promise<T>;
+    /**
+     * Save configuration, optionally running onSave lifecycle hook.
+     *
+     * @param data - Configuration data to save
+     * @param ctx - Current config context (for lifecycle hooks)
+     */
+    saveWithHooks(data: T, ctx?: ConfigContext): Promise<void>;
+    /**
+     * Get the current configuration (from cache if available).
+     * Loads from storage if not cached.
+     *
+     * @returns Current config or null if not loaded
+     */
+    get(): T | null;
+    /**
+     * Get a specific field value from the cached config.
+     *
+     * @param fieldPath - Dot-notation path to the field
+     * @returns The field value or undefined if not found
+     */
+    getField<K extends keyof T>(fieldPath: K): T[K] | undefined;
+    getField(fieldPath: string): unknown;
+    /**
+     * Set a single field value and save to storage.
+     *
+     * @param fieldPath - Dot-notation path to the field
+     * @param value - The value to set
+     */
+    setField<K extends keyof T>(fieldPath: K, value: T[K]): Promise<void>;
+    setField(fieldPath: string, value: unknown): Promise<void>;
+    /**
+     * Set multiple field values at once and save to storage.
+     *
+     * @param fields - Partial object with fields to update
+     */
+    setFields(fields: Partial<T>): Promise<void>;
+    /**
+     * Subscribe to configuration changes.
+     * Replaces the createConfigAccessor subscribe pattern.
+     *
+     * @param callback - Function called when config changes
+     * @returns Unsubscribe function
+     */
+    subscribe(callback: ConfigChangeCallback<T>): Unsubscribe;
+}
+//# sourceMappingURL=config-manifest.d.ts.map

package/dist/manifest/config-manifest.d.ts.map

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