@vibesdotdev/config 0.0.1

package/README.md

@@ -0,0 +1,85 @@
+# @vibesdotdev/config
+
+Schema-driven configuration for vibes. Zod schemas define config types; the
+runtime resolves storage, environment overlays, and surface forms.
+
+## Quickstart
+
+### Define a manifest
+
+```ts
+import { z } from 'zod';
+import { createConfigManifest } from '@vibesdotdev/config/manifest';
+import { configField } from '@vibesdotdev/config/schema';
+
+export const appConfig = createConfigManifest({
+  id: 'app-config',
+  name: 'Application Settings',
+  tier: 'user',
+  schema: z.object({
+    apiEndpoint: z.string().url().default('http://localhost:3000'),
+    timeout: z.number().default(30000),
+    features: z.object({
+      experimental: z.boolean().default(false),
+    }),
+  }),
+  fields: {
+    apiEndpoint: configField('API Endpoint').description('Base URL for API requests'),
+    timeout: configField('Timeout').description('Request timeout in milliseconds'),
+    'features.experimental': configField('Experimental Features').component('toggle'),
+  },
+  storage: { namespace: 'app', adapter: 'localdb' },
+});
+```
+
+### Load / get / set
+
+```ts
+import { ConfigManifest } from '@vibesdotdev/config';
+
+const config = new ConfigManifest('app-config');
+const values = await config.load();
+const timeout = await config.get('timeout', 30000);
+await config.set('features.experimental', true);
+```
+
+### Render a form (Svelte)
+
+```svelte
+<script>
+  import ManifestForm from '@vibesdotdev/config/adapters/web/components/ManifestForm.svelte';
+  import { appConfig } from './app-config';
+</script>
+
+<ManifestForm manifest={appConfig} onSubmit={(v) => saveConfig(v)} />
+```
+
+### Render a form (CLI)
+
+```ts
+import { runManifestPrompts } from '@vibesdotdev/config/adapters/cli';
+
+const values = await runManifestPrompts(appConfig);
+```
+
+### Diagnose
+
+```ts
+import { diagnoseConfig } from '@vibesdotdev/config/doctor';
+
+const result = diagnoseConfig(manifest, values);
+for (const issue of result.issues) {
+  console.log(`[${issue.severity}] ${issue.path}: ${issue.message}`);
+}
+```
+
+## Test
+
+```bash
+bun --bun vitest run
+```
+
+## Docs
+
+- [SPEC.md](./SPEC.md) — package contract, owned surfaces, hard rules
+- [runtime](../runtime/SPEC.md), [storage](../storage/SPEC.md), [tui](../tui/SPEC.md), [cli](../cli/SPEC.md)

package/SPEC.md

@@ -0,0 +1,71 @@
+# @vibesdotdev/config
+
+Schema-driven configuration. Zod schemas define config types; the runtime resolves storage, environment overlays, and surface forms.
+
+## Owns
+
+- **Runtime kinds:** `config/manifest`, `config/collection`, `config/environment`, `settings/section`
+- **`ConfigManifest<T>`** (`./manifest`): load, get, set, validate against a Zod schema; resolves storage adapter through the runtime
+- **`ConfigCollection`** (`./collection`): grouped/related manifests
+- **`SettingsSectionDescriptor`** (`./settings`): pure-data contribution kind. Each owning module registers one or more `settings/section` descriptors naming the `config/manifest` IDs in its section. `assembleSettingsSections(runtime)` concatenates every registered section sorted by `order`. Config never enumerates which sections exist.
+- **Environment system** (`./environment`): `local`, `staging`, `production` descriptors + `environment.plugin`; current-environment detection; per-env value overlays
+- **Form core** (`./form/core`): field resolution, Zod validation, visibility rules, groups
+- **Generic env helpers** (`./env`, `./env.runtime`): `getEnv` / `getEnvNumber` / `getEnvBoolean` / `validateRequiredEnv` / `readRuntimeEnv`. Isomorphic (Node + browser). **No monorepo-wide `env` aggregate** — domain env lives with the domain.
+- **Surface adapters:**
+  - `./adapters/cli` — Inquirer-based prompts
+  - `./adapters/web` — `ManifestForm.svelte` and Svelte form components
+  - `./tui` — OpenTUI/React `config-settings` and `config-registry` descriptors + impls
+- **Loader** (`./loader`): file-loader, discovery, merge, validation, server/client entrypoints
+- **Schema utilities** (`./schema`, `./schemas`)
+- **Routing** (`./routing`): config route registry + merge
+- **CRUD primitives** (`./crud`): base types, schemas, shared helpers
+- **Extensions** (`./extensions`): pluggable extension registry
+- **Services** (`./services`): config accessor, manifest utils, encryption (AES-256-GCM + PBKDF2)
+- **Doctor** (`./doctor`): generic `diagnoseConfig(manifest, values, options)`
+- **Plugins:** `./config.plugin` (core), `./environment/environment.plugin`
+- **Context:** `config.context.descriptor` (DI handle for resolved config)
+
+## Does not own
+
+- Storage implementations / adapters → [`storage`](../storage/SPEC.md). Config consumes `storage/adapter` through the runtime.
+- Secrets backends (keychain, OS credential store) → [`secrets`](../secrets/SPEC.md). Encryption hands off to storage's encrypted adapters.
+- TUI substrate (gateway, dispatcher, kinds) → [`tui`](../tui/SPEC.md). Config registers TUI assets against tui-owned kinds.
+- CLI runtime / command dispatcher → [`cli`](../cli/SPEC.md).
+- Domain-specific config manifests (AI providers, chat modes, knowledge sources, etc.). Each owning module defines its own `config/manifest` descriptors.
+- AI-specific diagnostics (`diagnoseAIConfig`), AI source maps, chat-mode normalizers — **migrated to `packages/ai/src/config/` on 2026-05-09.** See [`packages/ai/SPEC.md`](../ai/SPEC.md) and `@vibesdotdev/ai/config/*` exports.
+- **Domain env values.** AI provider URLs/keys, OAuth callback URLs, Linear team/status IDs, SMTP/Proton, scheduler crons, rate limits, etc. — owned by the consuming module (`packages/ai`, `packages/auth`, `packages/workers`, `apps/auth-web`, etc.). Config supplies `getEnv` / `getEnvBoolean` / `getEnvNumber`; the domain builds its own typed env from them. **Removed 2026-05-11** along with `./system`, `./schemas/env`, `./schemas/system`, `./settings`, `./form/navigation`.
+- **Hard-coded global settings layout.** The old `./settings/manifest.ts` enumerated domain manifest IDs (`ai.providers`, `chat.modes`, `knowledge.bases`, …) in a single hard-coded list — that violated the no-domain-manifests rule. The current `./settings` exposes the `settings/section` contribution kind instead: each owning module's plugin registers its section via `descriptors: [...]` and `assembleSettingsSections(runtime)` concatenates them. Config never enumerates which sections exist.
+- **`DEFAULT_PAGES` navigation table.** Same pattern — the deleted `./form/navigation` bundled an `ai`/`knowledge`/`session` page list. If page-tree navigation comes back, the page list is supplied by callers, not baked into config.
+
+## Hard rules
+
+- **All config access goes through `ConfigManifest` or storage manifest.** No raw `fs.readFileSync` / `node:fs/promises` in config code. All persistence is runtime-resolved through storage adapters.
+- **Resolution order is canonical:** env var → env-specific config file → base config file → schema default. Don't invent alternative orders.
+- **Sensitive values use storage-adapter encryption, not Zod markers.** No `.encrypted()` extension on schemas. Encryption is a property of the storage adapter the manifest binds to.
+- **Storage adapter selection is runtime-resolved.** Manifests declare what storage they want; the runtime picks the implementation. No `if (isCloud)` branches in config code.
+- **Bootstrap order:** `storage` plugin → `config.plugin` → `environment.plugin` → consumers. Do not reorder.
+- **`./ai/*` subpath removed (2026-05-09).** AI config utilities now live at `@vibesdotdev/ai/config/*`. Do not recreate.
+- **No `config.ai` state here.** The stable `config.ai` TUI state id is registered by `@vibesdotdev/ai`; consumers resolve it through `runtime.query('tui/state')`.
+- **No domain manifests in this package.** If a manifest is "AI providers" or "chat modes" or "tools agents," it lives in the owning module, not here.
+- **No monorepo-wide `env` aggregate.** `@vibesdotdev/config/env` exports only the generic helpers (`getEnv`, `getEnvNumber`, `getEnvBoolean`, `validateRequiredEnv`). Do not reintroduce a `services.{ollama,…}` / `ai.{openai,…}` / `oauth.{github,…}` / `email.{…}` god-object. Domain env lives with the domain.
+- **Domain env must be Zod-validated at its owning module's boundary.** Each owning module's `src/config/env.schema.ts` defines a Zod schema; `env.ts` parses `process.env` once through that schema and exports a typed value. No untyped `process.env.X` access in feature code.
+- **Global settings layout is contributed, not enumerated.** Surfaces call `assembleSettingsSections(runtime)`; modules contribute `settings/section` descriptors via their plugin's `descriptors: [...]`. The owning module decides which of its `config/manifest` IDs participate in its section.
+
+## Public entrypoints
+
+`package.json#exports` is canonical. Grouped: `.`, `./manifest/*`, `./form` + `./form/core/*`, `./loader/*`, `./schema/*`, `./schemas/*`, `./routing/*`, `./crud/*`, `./collection/*`, `./extensions/*`, `./services/*`, `./settings` + `./settings/*`, `./adapters/cli/*`, `./adapters/web/*`, `./browser`, `./server`, `./common`, `./cli/*`, `./tui/*`, `./environment/*`, `./client/*`, `./env`, `./env.runtime`, `./system-constants`, `./doctor`, `./plugin` (= `./config.plugin`).
+
+Removed entries (do not reintroduce without restoring the domain-ownership review): `./system`, `./form/navigation`, `./form/navigation/*`, `./schemas/env`, `./schemas/system`.
+
+Note: `./settings` is reintroduced as the runtime-first contribution surface (descriptor schema + assembly helper). It does **not** export a hard-coded manifest list — see Hard rules.
+
+## Verification
+
+`bun --bun vitest run` from package root. Covers manifest CRUD, form core (field resolution, validation, visibility), encryption roundtrip, environment detection, doctor diagnostics, loader/merge.
+
+## Links
+
+- [runtime/SPEC.md](../runtime/SPEC.md)
+- [storage/SPEC.md](../storage/SPEC.md)
+- [tui/SPEC.md](../tui/SPEC.md)
+- [cli/SPEC.md](../cli/SPEC.md)

package/dist/adapters/cli/flags.d.ts

@@ -0,0 +1,75 @@
+/**
+ * CLI Flag Config Helpers
+ *
+ * Utilities for accepting config overrides from CLI flags.
+ *
+ * @example
+ * ```typescript
+ * import { parseConfigFlag, parseConfigFlags } from '../../adapters/cli/flags';
+ *
+ * // Single flag: --config maxIterations=5
+ * const override = parseConfigFlag('maxIterations=5');
+ * // { maxIterations: 5 }
+ *
+ * // Nested value: --config git.autoCommit=true
+ * const nested = parseConfigFlag('git.autoCommit=true');
+ * // { git: { autoCommit: true } }
+ *
+ * // Multiple flags: --config foo=1 --config bar=2
+ * const merged = parseConfigFlags(['foo=1', 'bar=2']);
+ * // { foo: 1, bar: 2 }
+ *
+ * // Commander integration
+ * program
+ *   .option('-c, --config <key=value...>', 'Config overrides')
+ *   .action((opts) => {
+ *     const overrides = parseConfigFlags(opts.config);
+ *   });
+ * ```
+ */
+import type { ConfigOverride, ParsedConfigFlag } from './schemas/flags.schema.ts';
+export type { ConfigOverride, ParsedConfigFlag } from './schemas/flags.schema.ts';
+/**
+ * Parse a single config flag value.
+ *
+ * Accepts format: `key=value` or `path.to.key=value`
+ *
+ * @param flag - The flag value (e.g., "maxIterations=5" or "git.autoCommit=true")
+ * @returns Parsed config object with the value set at the appropriate path
+ */
+export declare function parseConfigFlag(flag: string): ParsedConfigFlag;
+/**
+ * Parse multiple config flag values and merge them.
+ *
+ * @param flags - Array of flag values or comma-separated string
+ * @returns Merged config object
+ */
+export declare function parseConfigFlags(flags: string | string[] | undefined): ConfigOverride;
+/**
+ * Create a Commander-compatible option processor.
+ *
+ * @example
+ * ```typescript
+ * import { createConfigFlagCollector } from '../../adapters/cli/flags';
+ *
+ * program
+ *   .option('-c, --config <key=value>', 'Config override', createConfigFlagCollector())
+ *   .action((opts) => {
+ *     // opts.config is a ConfigOverride object
+ *   });
+ * ```
+ */
+export declare function createConfigFlagCollector(): (value: string, previous: ConfigOverride) => ConfigOverride;
+/**
+ * Validate that config overrides match expected schema keys.
+ *
+ * @param overrides - The parsed config overrides
+ * @param allowedKeys - Array of allowed top-level keys
+ * @returns Array of unknown keys found
+ */
+export declare function validateConfigOverrideKeys(overrides: ConfigOverride, allowedKeys: string[]): string[];
+/**
+ * Format config overrides for display.
+ */
+export declare function formatConfigOverrides(overrides: ConfigOverride): string;
+//# sourceMappingURL=flags.d.ts.map

package/dist/adapters/cli/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../src/adapters/cli/flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElF,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA0ElF;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA4B9D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,cAAc,CAmBrF;AAsBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,IAAI,CAC5C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,KACpB,cAAc,CAMlB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACzC,SAAS,EAAE,cAAc,EACzB,WAAW,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAWV;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CAiBvE"}

package/dist/adapters/cli/flags.js

@@ -0,0 +1,221 @@
+/**
+ * CLI Flag Config Helpers
+ *
+ * Utilities for accepting config overrides from CLI flags.
+ *
+ * @example
+ * ```typescript
+ * import { parseConfigFlag, parseConfigFlags } from '../../adapters/cli/flags';
+ *
+ * // Single flag: --config maxIterations=5
+ * const override = parseConfigFlag('maxIterations=5');
+ * // { maxIterations: 5 }
+ *
+ * // Nested value: --config git.autoCommit=true
+ * const nested = parseConfigFlag('git.autoCommit=true');
+ * // { git: { autoCommit: true } }
+ *
+ * // Multiple flags: --config foo=1 --config bar=2
+ * const merged = parseConfigFlags(['foo=1', 'bar=2']);
+ * // { foo: 1, bar: 2 }
+ *
+ * // Commander integration
+ * program
+ *   .option('-c, --config <key=value...>', 'Config overrides')
+ *   .action((opts) => {
+ *     const overrides = parseConfigFlags(opts.config);
+ *   });
+ * ```
+ */
+// Value Parsing
+/**
+ * Parse a string value into its appropriate type.
+ */
+function parseValue(value) {
+    // Trim whitespace
+    const trimmed = value.trim();
+    // Empty string
+    if (trimmed === '')
+        return '';
+    // Boolean
+    if (trimmed === 'true')
+        return true;
+    if (trimmed === 'false')
+        return false;
+    // Null/undefined
+    if (trimmed === 'null')
+        return null;
+    if (trimmed === 'undefined')
+        return undefined;
+    // Number
+    if (/^-?\d+$/.test(trimmed)) {
+        return parseInt(trimmed, 10);
+    }
+    if (/^-?\d+\.\d+$/.test(trimmed)) {
+        return parseFloat(trimmed);
+    }
+    // JSON array or object
+    if ((trimmed.startsWith('[') && trimmed.endsWith(']')) ||
+        (trimmed.startsWith('{') && trimmed.endsWith('}'))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            // Not valid JSON, return as string
+        }
+    }
+    // String (remove quotes if present)
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+/**
+ * Set a nested value in an object using dot notation.
+ */
+function setNestedValue(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        if (!(part in current) || typeof current[part] !== 'object' || current[part] === null) {
+            current[part] = {};
+        }
+        current = current[part];
+    }
+    const lastPart = parts[parts.length - 1];
+    current[lastPart] = value;
+}
+// Main API
+/**
+ * Parse a single config flag value.
+ *
+ * Accepts format: `key=value` or `path.to.key=value`
+ *
+ * @param flag - The flag value (e.g., "maxIterations=5" or "git.autoCommit=true")
+ * @returns Parsed config object with the value set at the appropriate path
+ */
+export function parseConfigFlag(flag) {
+    const equalsIndex = flag.indexOf('=');
+    if (equalsIndex === -1) {
+        // No value, treat as boolean true
+        const config = {};
+        setNestedValue(config, flag, true);
+        return {
+            config,
+            key: flag,
+            rawValue: 'true',
+            value: true
+        };
+    }
+    const key = flag.slice(0, equalsIndex);
+    const rawValue = flag.slice(equalsIndex + 1);
+    const value = parseValue(rawValue);
+    const config = {};
+    setNestedValue(config, key, value);
+    return {
+        config,
+        key,
+        rawValue,
+        value
+    };
+}
+/**
+ * Parse multiple config flag values and merge them.
+ *
+ * @param flags - Array of flag values or comma-separated string
+ * @returns Merged config object
+ */
+export function parseConfigFlags(flags) {
+    if (!flags)
+        return {};
+    const flagArray = typeof flags === 'string'
+        ? flags
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : flags;
+    const result = {};
+    for (const flag of flagArray) {
+        const parsed = parseConfigFlag(flag);
+        deepMerge(result, parsed.config);
+    }
+    return result;
+}
+/**
+ * Deep merge source into target.
+ */
+function deepMerge(target, source) {
+    for (const [key, value] of Object.entries(source)) {
+        if (value !== null &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            target[key] !== null &&
+            typeof target[key] === 'object' &&
+            !Array.isArray(target[key])) {
+            deepMerge(target[key], value);
+        }
+        else {
+            target[key] = value;
+        }
+    }
+}
+/**
+ * Create a Commander-compatible option processor.
+ *
+ * @example
+ * ```typescript
+ * import { createConfigFlagCollector } from '../../adapters/cli/flags';
+ *
+ * program
+ *   .option('-c, --config <key=value>', 'Config override', createConfigFlagCollector())
+ *   .action((opts) => {
+ *     // opts.config is a ConfigOverride object
+ *   });
+ * ```
+ */
+export function createConfigFlagCollector() {
+    return (value, previous = {}) => {
+        const parsed = parseConfigFlag(value);
+        deepMerge(previous, parsed.config);
+        return previous;
+    };
+}
+/**
+ * Validate that config overrides match expected schema keys.
+ *
+ * @param overrides - The parsed config overrides
+ * @param allowedKeys - Array of allowed top-level keys
+ * @returns Array of unknown keys found
+ */
+export function validateConfigOverrideKeys(overrides, allowedKeys) {
+    const unknownKeys = [];
+    const allowedSet = new Set(allowedKeys);
+    for (const key of Object.keys(overrides)) {
+        if (!allowedSet.has(key)) {
+            unknownKeys.push(key);
+        }
+    }
+    return unknownKeys;
+}
+/**
+ * Format config overrides for display.
+ */
+export function formatConfigOverrides(overrides) {
+    const lines = [];
+    function format(obj, prefix = '') {
+        for (const [key, value] of Object.entries(obj)) {
+            const path = prefix ? `${prefix}.${key}` : key;
+            if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                format(value, path);
+            }
+            else {
+                lines.push(`  ${path} = ${JSON.stringify(value)}`);
+            }
+        }
+    }
+    format(overrides);
+    return lines.join('\n');
+}
+//# sourceMappingURL=flags.js.map

package/dist/adapters/cli/flags.js.map

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

package/dist/adapters/cli/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CLI Config Adapter
+ */
+export { getCLIPromptType, CLI_PROMPT_MAP } from './mappings.ts';
+export type { CLIPromptType } from './mappings.ts';
+export { formatFieldPrompt, formatSelectOptions, formatDefaultValue, parseInputValue } from './prompts.ts';
+export type { PromptResult } from './prompts.ts';
+export { createWizardSteps, getStepPrompts, validateWizardResults } from './wizard.ts';
+export type { WizardOptions, WizardStep, WizardResult } from './wizard.ts';
+export { parseConfigFlag, parseConfigFlags, createConfigFlagCollector, validateConfigOverrideKeys, formatConfigOverrides } from './flags.ts';
+export type { ConfigOverride, ParsedConfigFlag } from './flags.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACvF,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3E,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/adapters/cli/index.js

@@ -0,0 +1,9 @@
+/**
+ * CLI Config Adapter
+ */
+export { getCLIPromptType, CLI_PROMPT_MAP } from "./mappings.js";
+export { formatFieldPrompt, formatSelectOptions, formatDefaultValue, parseInputValue } from "./prompts.js";
+export { createWizardSteps, getStepPrompts, validateWizardResults } from "./wizard.js";
+// Config flag helpers
+export { parseConfigFlag, parseConfigFlags, createConfigFlagCollector, validateConfigOverrideKeys, formatConfigOverrides } from "./flags.js";
+//# sourceMappingURL=index.js.map

package/dist/adapters/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/cli/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EACN,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGvF,sBAAsB;AACtB,OAAO,EACN,eAAe,EACf,gBAAgB,EAChB,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,EACrB,MAAM,YAAY,CAAC"}

package/dist/adapters/cli/mappings.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CLI Prompt Mappings
+ *
+ * Maps FieldComponent types to CLI prompt types
+ */
+import type { FieldComponent } from '../../manifest/types.ts';
+import type { CLIPromptType } from './schemas/mappings.schema.ts';
+export type { CLIPromptType } from './schemas/mappings.schema.ts';
+/**
+ * Map field component to CLI prompt type
+ */
+export declare const CLI_PROMPT_MAP: Record<FieldComponent, CLIPromptType>;
+/**
+ * Get CLI prompt type for a field
+ */
+export declare function getCLIPromptType(component: FieldComponent): CLIPromptType;
+//# sourceMappingURL=mappings.d.ts.map

package/dist/adapters/cli/mappings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.d.ts","sourceRoot":"","sources":["../../../src/adapters/cli/mappings.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,aAAa,CAqBhE,CAAC;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,aAAa,CAEzE"}

package/dist/adapters/cli/mappings.js

@@ -0,0 +1,32 @@
+/**
+ * Map field component to CLI prompt type
+ */
+export const CLI_PROMPT_MAP = {
+    input: 'input',
+    textarea: 'input',
+    number: 'number',
+    select: 'select',
+    'multi-select': 'multiselect',
+    'radio-group': 'select',
+    checkbox: 'confirm',
+    switch: 'confirm',
+    slider: 'number',
+    color: 'input',
+    date: 'input',
+    datetime: 'input',
+    file: 'input',
+    password: 'password',
+    secret: 'password',
+    json: 'input',
+    code: 'input',
+    custom: 'input',
+    reference: 'select',
+    'multi-reference': 'multiselect'
+};
+/**
+ * Get CLI prompt type for a field
+ */
+export function getCLIPromptType(component) {
+    return CLI_PROMPT_MAP[component] || 'input';
+}
+//# sourceMappingURL=mappings.js.map

package/dist/adapters/cli/mappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mappings.js","sourceRoot":"","sources":["../../../src/adapters/cli/mappings.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0C;IACpE,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,OAAO;IACjB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,aAAa;IAC7B,aAAa,EAAE,QAAQ;IACvB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,OAAO;IACjB,IAAI,EAAE,OAAO;IACb,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,OAAO;IACf,SAAS,EAAE,QAAQ;IACnB,iBAAiB,EAAE,aAAa;CAChC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAyB;IACzD,OAAO,cAAc,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC;AAC7C,CAAC"}

package/dist/adapters/cli/prompts.d.ts

@@ -0,0 +1,28 @@
+/**
+ * CLI Prompt Utilities
+ *
+ * Functions for prompting users in CLI context
+ */
+import type { ConfigFieldMeta } from '../../manifest/types.ts';
+import type { ResolvedField } from '../../form/core/types.ts';
+export type { PromptResult } from './schemas/prompts.schema.ts';
+/**
+ * Format a field for CLI display
+ */
+export declare function formatFieldPrompt(field: ResolvedField): string;
+/**
+ * Format options for select prompts
+ */
+export declare function formatSelectOptions(meta: ConfigFieldMeta): Array<{
+    value: string;
+    label: string;
+}>;
+/**
+ * Get default value display for CLI
+ */
+export declare function formatDefaultValue(value: unknown): string;
+/**
+ * Parse CLI input to correct type
+ */
+export declare function parseInputValue(input: string, field: ResolvedField): unknown;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/adapters/cli/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/adapters/cli/prompts.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG9D,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAa9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,eAAe,GACnB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAOzC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAa5E"}

package/dist/adapters/cli/prompts.js

@@ -0,0 +1,55 @@
+import { getCLIPromptType } from "./mappings.js";
+/**
+ * Format a field for CLI display
+ */
+export function formatFieldPrompt(field) {
+    const { meta } = field;
+    let prompt = meta.ui.label;
+    if (meta.ui.description) {
+        prompt += ` (${meta.ui.description})`;
+    }
+    if (field.required) {
+        prompt += ' *';
+    }
+    return prompt;
+}
+/**
+ * Format options for select prompts
+ */
+export function formatSelectOptions(meta) {
+    if (!meta.options)
+        return [];
+    return meta.options.map((opt) => ({
+        value: String(opt.value),
+        label: opt.description ? `${opt.label} - ${opt.description}` : opt.label
+    }));
+}
+/**
+ * Get default value display for CLI
+ */
+export function formatDefaultValue(value) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'boolean')
+        return value ? 'yes' : 'no';
+    if (typeof value === 'object')
+        return JSON.stringify(value);
+    return String(value);
+}
+/**
+ * Parse CLI input to correct type
+ */
+export function parseInputValue(input, field) {
+    const promptType = getCLIPromptType(field.component);
+    switch (promptType) {
+        case 'number': {
+            const num = parseFloat(input);
+            return isNaN(num) ? undefined : num;
+        }
+        case 'confirm':
+            return input.toLowerCase() === 'yes' || input.toLowerCase() === 'y' || input === 'true';
+        default:
+            return input;
+    }
+}
+//# sourceMappingURL=prompts.js.map

package/dist/adapters/cli/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/adapters/cli/prompts.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAIjD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACrD,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACvB,IAAI,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC;IAE3B,IAAI,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC,WAAW,GAAG,CAAC;IACvC,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,IAAI,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAClC,IAAqB;IAErB,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAE7B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;QACxB,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK;KACxE,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,KAAoB;IAClE,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAErD,QAAQ,UAAU,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAC9B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;QACrC,CAAC;QACD,KAAK,SAAS;YACb,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM,CAAC;QACzF;YACC,OAAO,KAAK,CAAC;IACf,CAAC;AACF,CAAC"}