import { LifecycleHooks } from '@b64hub/sfpm-core';
import type { PicklistHooksOptions } from './types.js';
/**
 * Creates lifecycle hooks for enabling picklist values post-deployment.
 *
 * Registers a hook on `install:post` that synchronises picklist values
 * from the package source into the target org via the Tooling API.
 *
 * The hook reads picklist definitions from the package's
 * `ComponentSet` (exposed through `SfpmMetadataPackage.customFields`)
 * and compares them with the current org state. Only unlocked packages
 * are processed — source packages are deployed directly and don't need
 * this fixup.
 *
 * @param options - Hook configuration options
 * @returns A LifecycleHooks instance to pass to `defineConfig({ hooks: [...] })`
 *
 * @example
 * ```typescript
 * // sfpm.config.ts
 * import { defineConfig } from '@b64hub/sfpm-core';
 * import { picklistHooks } from '@b64hub/sfpm-hooks';
 *
 * export default defineConfig({
 *   hooks: [
 *     picklistHooks({ activationStrategy: 'all' }),
 *   ],
 * });
 * ```
 */
export declare function picklistHooks(options?: PicklistHooksOptions): LifecycleHooks;