@vibesdotdev/config 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.schema.d.ts","sourceRoot":"","sources":["../../../src/manifest/schemas/builder.schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAGX,UAAU,EACV,eAAe,EACf,eAAe,EAQf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAiB,MAAM,aAAa,CAAC;AAErF,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,CAAC;IACV,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrC,aAAa,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CACnD"}

package/dist/manifest/schemas/builder.schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=builder.schema.js.map

package/dist/manifest/schemas/builder.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.schema.js","sourceRoot":"","sources":["../../../src/manifest/schemas/builder.schema.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+export type ConfigChangeCallback<T> = (config: T | null) => void;
+//# sourceMappingURL=config-manifest.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config-manifest.schema.d.ts","sourceRoot":"","sources":["../../../src/manifest/schemas/config-manifest.schema.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC"}

package/dist/manifest/schemas/config-manifest.schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config-manifest.schema.js.map

package/dist/manifest/schemas/config-manifest.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manifest.schema.js","sourceRoot":"","sources":["../../../src/manifest/schemas/config-manifest.schema.ts"],"names":[],"mappings":""}

package/dist/manifest/schemas/schema.schema.d.ts

@@ -0,0 +1,83 @@
+export type ConfigTier = 'system' | 'user' | 'internal';
+export type StorageAdapter = 'auto' | 'json' | 'localdb' | 'cloud' | 'database' | 'env' | 'encrypted' | 'memory';
+export type StorageScope = 'global' | 'project' | 'auto';
+export type ConfigSurface = 'tui' | 'cli' | 'web' | 'bridge';
+export type HardwareContext = 'cloud' | 'consumer' | 'gpu' | 'cpu-only';
+export type EnvironmentContext = 'development' | 'staging' | 'production';
+export type FieldComponent = 'input' | 'textarea' | 'number' | 'select' | 'multi-select' | 'radio-group' | 'checkbox' | 'switch' | 'slider' | 'color' | 'date' | 'datetime' | 'file' | 'password' | 'secret' | 'json' | 'code' | 'custom';
+export type FieldWidth = 'full' | 'half' | 'third' | 'quarter';
+export interface FieldUI {
+    label: string;
+    description?: string;
+    helpText?: string;
+    placeholder?: string;
+    icon?: string;
+    component?: FieldComponent;
+    customComponent?: string;
+    order?: number;
+    group?: string;
+    width?: FieldWidth;
+    hideLabel?: boolean;
+    className?: string;
+}
+export interface FieldOption<T extends string = string> {
+    value: T;
+    label: string;
+    description?: string;
+    icon?: string;
+    disabledWhen?: unknown;
+    hiddenWhen?: unknown;
+}
+export interface FieldAccess {
+    isPublic?: boolean;
+    isEditable?: boolean;
+    requiredRole?: string;
+    surfaces?: ConfigSurface[];
+}
+export interface FieldRules {
+    visibleWhen?: unknown;
+    disabledWhen?: unknown;
+    requiredWhen?: unknown;
+    warnWhen?: unknown;
+    warnMessage?: string;
+}
+export interface FieldDefaults<T = unknown> {
+    base: T;
+    byHardware?: Partial<Record<HardwareContext, T>>;
+    byEnvironment?: Partial<Record<EnvironmentContext, T>>;
+    bySurface?: Partial<Record<ConfigSurface, T>>;
+}
+export interface ConfigFieldMeta {
+    ui: FieldUI;
+    rules?: FieldRules;
+    defaults?: FieldDefaults;
+    options?: FieldOption[];
+    access?: FieldAccess;
+    dependsOn?: string[];
+    tags?: string[];
+}
+export interface ConfigFieldGroup {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    order?: number;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    visibleWhen?: unknown;
+}
+export interface ManifestStorage {
+    adapter: StorageAdapter;
+    scope?: StorageScope;
+    namespace: string;
+    encryptSensitive?: boolean;
+    sensitiveFields?: string[];
+    version?: number;
+}
+export interface ManifestContext {
+    hardware?: HardwareContext[];
+    environment?: EnvironmentContext[];
+    surfaces?: ConfigSurface[];
+    requiredFeatures?: string[];
+}
+//# sourceMappingURL=schema.schema.d.ts.map

package/dist/manifest/schemas/schema.schema.d.ts.map

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

package/dist/manifest/schemas/schema.schema.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=schema.schema.js.map

package/dist/manifest/schemas/schema.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.schema.js","sourceRoot":"","sources":["../../../src/manifest/schemas/schema.schema.ts"],"names":[],"mappings":""}

package/dist/manifest/types.d.ts

@@ -0,0 +1,563 @@
+/**
+ * Configuration Manifest Types
+ *
+ * Core type definitions for the universal configuration system.
+ * Manifests define configuration schemas with UI hints, context rules,
+ * and storage configuration.
+ */
+import type { z } from 'zod/v4';
+/**
+ * Configuration tiers determine storage location, visibility, and access patterns
+ *
+ * - system: Platform-level settings (database-backed, admin-only)
+ * - user: User-facing configuration (JSON for CLI/TUI, database for web)
+ * - internal: Developer/tooling configuration (env vars, constants)
+ */
+export type ConfigTier = 'system' | 'user' | 'internal';
+/**
+ * Storage adapter types
+ *
+ * - auto: Automatically resolve based on tier and surface
+ * - json: JSON file storage (CLI/TUI)
+ * - localdb: LocalDB SQLite storage (unified with CLI config system)
+ * - cloud: Cloud settings API (Web/Bridge)
+ * - database: Database storage (system settings)
+ * - encrypted: Encrypted JSON storage
+ * - memory: In-memory storage (testing)
+ * - env: Environment variables (internal config)
+ */
+export type StorageAdapterType = 'auto' | 'json' | 'localdb' | 'cloud' | 'database' | 'env' | 'encrypted' | 'memory';
+/**
+ * Storage scope for file-based adapters
+ */
+export type StorageScope = 'global' | 'project' | 'auto';
+/**
+ * UI surfaces that can render configuration forms
+ */
+export type ConfigSurface = 'tui' | 'cli' | 'web' | 'bridge';
+/**
+ * Hardware context for context-aware defaults
+ */
+export type HardwareContext = 'cloud' | 'consumer' | 'gpu' | 'cpu-only';
+/**
+ * Environment context
+ */
+export type EnvironmentContext = 'development' | 'staging' | 'production';
+/**
+ * Predefined pages in the application
+ * Can be extended with string for custom pages
+ */
+export type NavigationPage = 'settings' | 'settings/account' | 'settings/storage' | 'ai' | 'knowledge' | 'session' | string | null;
+/**
+ * Predefined sections within pages
+ */
+export type NavigationSection = 'general' | 'account' | 'preferences' | 'appearance' | 'privacy' | 'advanced' | 'admin' | string;
+/**
+ * Navigation configuration for a manifest
+ */
+export interface ManifestNavigation {
+    /**
+     * Page/route where this manifest appears
+     * - null = Don't show in any navigation (accessed programmatically only)
+     * - 'settings' = Global settings page
+     * - 'ai' = AI configuration page (/ai)
+     */
+    page: NavigationPage;
+    /**
+     * Section within the page for grouping multiple manifests
+     * Sections become tabs or collapsible groups in the UI
+     */
+    section?: NavigationSection;
+    /**
+     * Display order within the section (lower = first)
+     * @default 100
+     */
+    order?: number;
+    /**
+     * Whether to include in global settings page
+     * Set false for domain-specific configs (AI, Knowledge, etc.)
+     * @default true (unless page is domain-specific)
+     */
+    showInGlobalSettings?: boolean;
+    /**
+     * Parent manifest ID for hierarchical organization
+     * Child manifests appear nested under parent
+     */
+    parent?: string;
+    /**
+     * Custom navigation label (defaults to manifest.name)
+     */
+    label?: string;
+    /**
+     * Icon for navigation (overrides manifest.icon for nav only)
+     */
+    icon?: string;
+    /**
+     * Tags for custom filtering beyond page/section
+     */
+    tags?: string[];
+    /**
+     * Additional route parameters or query strings
+     */
+    params?: Record<string, string>;
+}
+/**
+ * Runtime context available for conditional logic in manifests
+ */
+export interface ConfigContext {
+    /** Current hardware target */
+    hardware: HardwareContext;
+    /** Current environment */
+    environment: EnvironmentContext;
+    /** Current UI surface */
+    surface: ConfigSurface;
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** User's role (if authenticated) */
+    userRole?: string;
+    /** Feature flags that are enabled */
+    enabledFeatures: Set<string>;
+    /** Get a config value from another field or manifest */
+    get: <T = unknown>(path: string) => T | undefined;
+    /** Custom context values */
+    custom: Record<string, unknown>;
+}
+/**
+ * Rule for conditional visibility, disabled state, or requirements
+ */
+export type ConfigRule = ConfigFieldRule | ConfigContextRule | ConfigAndRule | ConfigOrRule | ConfigNotRule | ConfigFunctionRule;
+/** Rule based on another field's value */
+export interface ConfigFieldRule {
+    field: string;
+    operator: 'equals' | 'notEquals' | 'in' | 'notIn' | 'exists' | 'isEmpty';
+    value?: unknown;
+}
+/** Rule based on context */
+export interface ConfigContextRule {
+    context: keyof Omit<ConfigContext, 'get' | 'custom'> | `custom.${string}`;
+    operator: 'equals' | 'notEquals' | 'in' | 'notIn' | 'exists';
+    value?: unknown;
+}
+/** Combine rules with AND */
+export interface ConfigAndRule {
+    and: ConfigRule[];
+}
+/** Combine rules with OR */
+export interface ConfigOrRule {
+    or: ConfigRule[];
+}
+/** Negate a rule */
+export interface ConfigNotRule {
+    not: ConfigRule;
+}
+/** Custom function rule (for complex logic) */
+export interface ConfigFunctionRule {
+    fn: (ctx: ConfigContext, allValues: Record<string, unknown>) => boolean;
+}
+/**
+ * UI component types for rendering fields
+ */
+export type FieldComponent = 'input' | 'textarea' | 'number' | 'select' | 'multi-select' | 'radio-group' | 'checkbox' | 'switch' | 'slider' | 'color' | 'date' | 'datetime' | 'file' | 'password' | 'secret' | 'json' | 'code' | 'reference' | 'multi-reference' | 'custom';
+/**
+ * Field width in form layout
+ */
+export type FieldWidth = 'full' | 'half' | 'third' | 'quarter';
+/**
+ * UI configuration for a field
+ */
+export interface FieldUI {
+    /** Display label */
+    label: string;
+    /** Short description (shown near field) */
+    description?: string;
+    /** Longer help text (shown on hover/focus) */
+    helpText?: string;
+    /** Placeholder text for inputs */
+    placeholder?: string;
+    /** Icon (emoji or icon name) */
+    icon?: string;
+    /** Component to render */
+    component?: FieldComponent;
+    /** Custom component reference (when component is 'custom') */
+    customComponent?: string;
+    /** Display order within group */
+    order?: number;
+    /** Group this field belongs to */
+    group?: string;
+    /** Field width in form layout */
+    width?: FieldWidth;
+    /** Whether to hide the label */
+    hideLabel?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+/**
+ * Option for enum/select fields
+ */
+export interface FieldOption<T = string> {
+    /** Option value */
+    value: T;
+    /** Display label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Optional icon */
+    icon?: string;
+    /** When this option should be disabled */
+    disabledWhen?: ConfigRule;
+    /** When this option should be hidden */
+    hiddenWhen?: ConfigRule;
+}
+/**
+ * Access control for system-tier fields
+ */
+export interface FieldAccess {
+    /** Whether this setting is visible to non-admin users */
+    isPublic?: boolean;
+    /** Whether this setting can be modified (vs read-only) */
+    isEditable?: boolean;
+    /** Required role to view/edit */
+    requiredRole?: string;
+    /** Surfaces where this field is available */
+    surfaces?: ConfigSurface[];
+}
+/**
+ * Conditional rules for field behavior
+ */
+export interface FieldRules {
+    /** When this field should be visible */
+    visibleWhen?: ConfigRule;
+    /** When this field should be disabled */
+    disabledWhen?: ConfigRule;
+    /** When this field is required (beyond schema) */
+    requiredWhen?: ConfigRule;
+    /** When to show a warning */
+    warnWhen?: ConfigRule;
+    /** Warning message */
+    warnMessage?: string;
+}
+/**
+ * Context-aware default values
+ */
+export interface FieldDefaults<T = unknown> {
+    /** Base default value (from schema or override) */
+    base: T;
+    /** Override defaults by hardware context */
+    byHardware?: Partial<Record<HardwareContext, T>>;
+    /** Override defaults by environment */
+    byEnvironment?: Partial<Record<EnvironmentContext, T>>;
+    /** Override defaults by surface */
+    bySurface?: Partial<Record<ConfigSurface, T>>;
+    /** Custom default resolver */
+    resolver?: (ctx: ConfigContext) => T;
+}
+/**
+ * Reference field configuration for entity lookups
+ */
+export interface ReferenceConfig {
+    /**
+     * Entity type to reference (e.g., 'model', 'provider', 'tool', 'prompt')
+     */
+    entity: string;
+    /**
+     * Field to use as the value (default: 'id')
+     */
+    valueField?: string;
+    /**
+     * Field to use as the display label (default: 'name')
+     */
+    labelField?: string;
+    /**
+     * Optional description field for richer display
+     */
+    descriptionField?: string;
+    /**
+     * API endpoint to fetch options (if not using default entity resolution)
+     */
+    endpoint?: string;
+    /**
+     * Static filter to apply when fetching options
+     */
+    filter?: Record<string, unknown>;
+    /**
+     * Dynamic filter based on other field values
+     * Key = filter param, Value = field path to get value from
+     */
+    dynamicFilter?: Record<string, string>;
+    /**
+     * Whether to allow creating new entities inline
+     */
+    allowCreate?: boolean;
+    /**
+     * For multi-reference: whether ordering matters (enables drag/drop)
+     */
+    orderable?: boolean;
+    /**
+     * Maximum number of selections (for multi-reference)
+     */
+    maxItems?: number;
+    /**
+     * Minimum number of selections (for multi-reference)
+     */
+    minItems?: number;
+    /**
+     * Custom component name for specialized rendering
+     * e.g., 'ModelAndProviderSelect', 'ToolSelector'
+     */
+    customRenderer?: string;
+    /**
+     * Additional props to pass to the custom renderer
+     */
+    customRendererProps?: Record<string, unknown>;
+}
+/**
+ * Complete field metadata
+ */
+export interface ConfigFieldMeta<T = unknown> {
+    /** UI configuration */
+    ui: FieldUI;
+    /** Conditional behavior rules */
+    rules?: FieldRules;
+    /** Context-aware defaults */
+    defaults?: FieldDefaults<T>;
+    /** Options for enum/select fields */
+    options?: FieldOption<T extends string ? T : string>[];
+    /** Reference configuration for entity lookup fields */
+    reference?: ReferenceConfig;
+    /** Access control (for system tier) */
+    access?: FieldAccess;
+    /** Dependencies on other fields (for validation/updates) */
+    dependsOn?: string[];
+    /** Tags for categorization/filtering */
+    tags?: string[];
+}
+/**
+ * Group of related fields for UI organization
+ */
+export interface ConfigFieldGroup {
+    /** Group identifier */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Optional description */
+    description?: string;
+    /** Optional icon */
+    icon?: string;
+    /** Display order */
+    order?: number;
+    /** Whether group is collapsible */
+    collapsible?: boolean;
+    /** Whether group starts collapsed */
+    defaultCollapsed?: boolean;
+    /** When this group should be visible */
+    visibleWhen?: ConfigRule;
+}
+/**
+ * Storage source with priority for config loading
+ * Configs are loaded from all sources and merged by priority (higher = wins)
+ */
+export interface StorageSource {
+    /** Source type */
+    type: 'cwd-file' | 'user-file' | 'cwd-db' | 'user-db' | 'cloud';
+    /** Priority for merging (higher wins conflicts) */
+    priority: number;
+    /** Whether this source is read-only */
+    readonly?: boolean;
+    /** Adapter to use for this source */
+    adapter?: StorageAdapterType;
+}
+/**
+ * Storage configuration for a manifest
+ */
+export interface ManifestStorage {
+    /** Storage adapter to use (default: 'auto') */
+    adapter?: StorageAdapterType;
+    /** Scope for file-based adapters */
+    scope?: StorageScope;
+    /** Namespace/table/key prefix */
+    namespace: string;
+    /** Whether to encrypt sensitive fields */
+    encryptSensitive?: boolean;
+    /** Fields that should be encrypted */
+    sensitiveFields?: string[];
+    /** Migration version for schema changes */
+    version?: number;
+    /**
+     * Multi-source configuration (optional)
+     * When specified, config is loaded from all sources and merged by priority
+     * Default priority: cwd-file(1) < user-file(2) < cwd-db(3) < user-db(4) < cloud(5)
+     */
+    sources?: StorageSource[];
+    /**
+     * Where new values are saved by default
+     * @default 'user-file' for user tier, 'cwd-db' for system tier
+     */
+    defaultSaveTarget?: StorageSource['type'];
+}
+/**
+ * Lazy-loaded component override
+ * Uses dynamic import for code-splitting
+ */
+export type ComponentLoader<T = any> = () => Promise<{
+    default: T;
+}>;
+/**
+ * CRUD component overrides per surface
+ */
+export interface CRUDComponentOverrides {
+    /** Custom list/table view component */
+    list?: ComponentLoader;
+    /** Custom create form component */
+    create?: ComponentLoader;
+    /** Custom edit form component */
+    edit?: ComponentLoader;
+    /** Custom detail/read view component */
+    detail?: ComponentLoader;
+    /** Custom delete confirmation component */
+    delete?: ComponentLoader;
+}
+/**
+ * Component overrides for different surfaces
+ */
+export interface ManifestComponents {
+    /** TUI (terminal) component overrides */
+    tui?: {
+        /** Main page component for this manifest */
+        page?: ComponentLoader;
+        /** CRUD component overrides */
+        crud?: CRUDComponentOverrides;
+    };
+    /** Web (Svelte) component overrides */
+    web?: {
+        /** Main page component for this manifest */
+        page?: ComponentLoader;
+        /** CRUD component overrides */
+        crud?: CRUDComponentOverrides;
+    };
+    /** CLI (non-interactive) component overrides */
+    cli?: {
+        /** Main page component for this manifest */
+        page?: ComponentLoader;
+    };
+}
+/**
+ * Constraints on when a manifest applies
+ */
+export interface ManifestContext {
+    /** Hardware contexts where this manifest applies */
+    hardware?: HardwareContext[];
+    /** Environments where this manifest applies */
+    environment?: EnvironmentContext[];
+    /** Surfaces where this manifest applies */
+    surfaces?: ConfigSurface[];
+    /** Feature flags required for this manifest */
+    requiredFeatures?: string[];
+}
+/**
+ * Configuration for loading config from TypeScript/JavaScript files.
+ * Allows manifests to specify optional config file patterns like 'vibes.example.ts'.
+ */
+export interface ConfigFileLocation {
+    /**
+     * File pattern to look for in project root.
+     * Examples: 'vibes.example.ts', 'vibes.config.ts'
+     */
+    pattern: string;
+    /**
+     * Named export to look for in the file.
+     * - 'default' = use default export
+     * - string = use named export (e.g., 'exampleConfig')
+     * - undefined = try default, then try export matching manifest id
+     */
+    exportName?: string;
+    /**
+     * For record-type manifests, a 'configs' export can contain multiple named configs.
+     * This specifies the property name within that export.
+     * Example: vibes.autoloop.ts exports { configs: { simple: {...}, full: {...} } }
+     */
+    configsExport?: string;
+    /**
+     * Priority relative to other sources (higher wins in merge).
+     * @default 3 (above localdb at 2, below CLI overrides at 4)
+     */
+    priority?: number;
+    /**
+     * Whether this file is required (error if missing) or optional.
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * Additional file patterns to search (e.g., for legacy names).
+     * Searched in order, first match wins.
+     */
+    fallbackPatterns?: string[];
+}
+/**
+ * Complete configuration manifest
+ *
+ * Defines a configuration namespace with its schema, field metadata,
+ * storage configuration, and context constraints.
+ *
+ * @template T - Zod schema type for the configuration
+ */
+export interface ConfigManifest<T extends z.ZodTypeAny = z.ZodTypeAny> {
+    /** Unique identifier (e.g., 'ai', 'storage', 'system.settings') */
+    id: string;
+    /** Display name */
+    name: string;
+    /** Description */
+    description?: string;
+    /** Icon (emoji or icon name) */
+    icon?: string;
+    /** Schema version for migrations */
+    version?: number;
+    /** Configuration tier */
+    tier: ConfigTier;
+    /** Category within the tier (for organization) */
+    category?: string;
+    /** Zod schema (source of truth for validation) */
+    schema: T;
+    /** Field metadata keyed by field path */
+    fields: Record<string, ConfigFieldMeta>;
+    /** Field groups for UI organization */
+    groups?: ConfigFieldGroup[];
+    /** Storage configuration */
+    storage: ManifestStorage;
+    /**
+     * Optional config file location(s) for loading config from project files.
+     * Config loaded from files is merged with storage-based config.
+     * Multiple locations are searched in order; all matching files are merged.
+     */
+    configFiles?: ConfigFileLocation | ConfigFileLocation[];
+    /** Context constraints for when this manifest applies */
+    context?: ManifestContext;
+    /**
+     * Navigation and UI placement configuration
+     * Determines where this manifest appears in the UI hierarchy
+     * If omitted, manifest won't appear in any navigation
+     */
+    navigation?: ManifestNavigation;
+    /**
+     * Component overrides for different surfaces
+     * Allows customizing how this manifest renders in TUI, Web, CLI
+     * Uses lazy loading for code-splitting
+     */
+    components?: ManifestComponents;
+    /** Called after config is loaded */
+    onLoad?: (config: z.infer<T>, ctx: ConfigContext) => z.infer<T> | Promise<z.infer<T>>;
+    /** Called before config is saved */
+    onSave?: (config: z.infer<T>, ctx: ConfigContext) => z.infer<T> | Promise<z.infer<T>>;
+    /** Called when a field changes */
+    onFieldChange?: (field: string, value: unknown, allValues: Record<string, unknown>, ctx: ConfigContext) => Record<string, unknown> | void;
+}
+/**
+ * Extract the config type from a manifest
+ */
+export type InferConfigType<M extends ConfigManifest> = M extends ConfigManifest<infer T> ? z.infer<T> : never;
+/**
+ * Extract field paths from a Zod schema
+ */
+export type FieldPaths<T> = T extends z.ZodObject<infer Shape> ? {
+    [K in keyof Shape]: Shape[K] extends z.ZodObject<any> ? `${K & string}` | `${K & string}.${FieldPaths<Shape[K]>}` : K & string;
+}[keyof Shape] : never;
+//# sourceMappingURL=types.d.ts.map