@vibesdotdev/config 0.0.1

package/package.json

@@ -0,0 +1,417 @@
+{
+  "name": "@vibesdotdev/config",
+  "version": "0.0.1",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "bun": "./src/manifest/index.ts",
+      "import": "./dist/manifest/index.js",
+      "default": "./dist/manifest/index.js"
+    },
+    "./manifest/builder": {
+      "types": "./dist/manifest/builder.d.ts",
+      "bun": "./src/manifest/builder.ts",
+      "import": "./dist/manifest/builder.js",
+      "default": "./dist/manifest/builder.js"
+    },
+    "./manifest/config-manifest": {
+      "types": "./dist/manifest/config-manifest.d.ts",
+      "bun": "./src/manifest/config-manifest.ts",
+      "import": "./dist/manifest/config-manifest.js",
+      "default": "./dist/manifest/config-manifest.js"
+    },
+    "./manifest/types": {
+      "types": "./dist/manifest/types.d.ts",
+      "bun": "./src/manifest/types.ts",
+      "import": "./dist/manifest/types.js",
+      "default": "./dist/manifest/types.js"
+    },
+    "./manifest/*": {
+      "types": "./dist/manifest/*.d.ts",
+      "bun": "./src/manifest/*.ts",
+      "import": "./dist/manifest/*.js",
+      "default": "./dist/manifest/*.js"
+    },
+    "./form": {
+      "types": "./dist/form/index.d.ts",
+      "bun": "./src/form/index.ts",
+      "import": "./dist/form/index.js",
+      "default": "./dist/form/index.js"
+    },
+    "./form/*": {
+      "types": "./dist/form/*.d.ts",
+      "bun": "./src/form/*.ts",
+      "import": "./dist/form/*.js",
+      "default": "./dist/form/*.js"
+    },
+    "./form/core": {
+      "types": "./dist/form/core/index.d.ts",
+      "bun": "./src/form/core/index.ts",
+      "import": "./dist/form/core/index.js",
+      "default": "./dist/form/core/index.js"
+    },
+    "./form/core/*": {
+      "types": "./dist/form/core/*.d.ts",
+      "bun": "./src/form/core/*.ts",
+      "import": "./dist/form/core/*.js",
+      "default": "./dist/form/core/*.js"
+    },
+    "./loader": {
+      "types": "./dist/loader/index.d.ts",
+      "bun": "./src/loader/index.ts",
+      "import": "./dist/loader/index.js",
+      "default": "./dist/loader/index.js"
+    },
+    "./loader/client": {
+      "types": "./dist/loader/client.d.ts",
+      "bun": "./src/loader/client.ts",
+      "import": "./dist/loader/client.js",
+      "default": "./dist/loader/client.js"
+    },
+    "./loader/cli": {
+      "types": "./dist/loader/cli/index.d.ts",
+      "bun": "./src/loader/cli/index.ts",
+      "import": "./dist/loader/cli/index.js",
+      "default": "./dist/loader/cli/index.js"
+    },
+    "./loader/cli/*": {
+      "types": "./dist/loader/cli/*.d.ts",
+      "bun": "./src/loader/cli/*.ts",
+      "import": "./dist/loader/cli/*.js",
+      "default": "./dist/loader/cli/*.js"
+    },
+    "./loader/discovery": {
+      "types": "./dist/loader/discovery.d.ts",
+      "bun": "./src/loader/discovery.ts",
+      "import": "./dist/loader/discovery.js",
+      "default": "./dist/loader/discovery.js"
+    },
+    "./loader/index.server": {
+      "types": "./dist/loader/index.server.d.ts",
+      "bun": "./src/loader/index.server.ts",
+      "import": "./dist/loader/index.server.js",
+      "default": "./dist/loader/index.server.js"
+    },
+    "./loader/*": {
+      "types": "./dist/loader/*.d.ts",
+      "bun": "./src/loader/*.ts",
+      "import": "./dist/loader/*.js",
+      "default": "./dist/loader/*.js"
+    },
+    "./loader/server": {
+      "types": "./dist/loader/server.d.ts",
+      "bun": "./src/loader/server.ts",
+      "import": "./dist/loader/server.js",
+      "default": "./dist/loader/server.js"
+    },
+    "./schema": {
+      "types": "./dist/schema/index.d.ts",
+      "bun": "./src/schema/index.ts",
+      "import": "./dist/schema/index.js",
+      "default": "./dist/schema/index.js"
+    },
+    "./schema/*": {
+      "types": "./dist/schema/*.d.ts",
+      "bun": "./src/schema/*.ts",
+      "import": "./dist/schema/*.js",
+      "default": "./dist/schema/*.js"
+    },
+    "./schemas": {
+      "types": "./dist/schemas/index.d.ts",
+      "bun": "./src/schemas/index.ts",
+      "import": "./dist/schemas/index.js",
+      "default": "./dist/schemas/index.js"
+    },
+    "./schemas/*": {
+      "types": "./dist/schemas/*.d.ts",
+      "bun": "./src/schemas/*.ts",
+      "import": "./dist/schemas/*.js",
+      "default": "./dist/schemas/*.js"
+    },
+    "./routing": {
+      "types": "./dist/routing/index.d.ts",
+      "bun": "./src/routing/index.ts",
+      "import": "./dist/routing/index.js",
+      "default": "./dist/routing/index.js"
+    },
+    "./routing/types": {
+      "types": "./dist/routing/types.d.ts",
+      "bun": "./src/routing/types.ts",
+      "import": "./dist/routing/types.js",
+      "default": "./dist/routing/types.js"
+    },
+    "./routing/*": {
+      "types": "./dist/routing/*.d.ts",
+      "bun": "./src/routing/*.ts",
+      "import": "./dist/routing/*.js",
+      "default": "./dist/routing/*.js"
+    },
+    "./crud": {
+      "types": "./dist/crud/index.d.ts",
+      "bun": "./src/crud/index.ts",
+      "import": "./dist/crud/index.js",
+      "default": "./dist/crud/index.js"
+    },
+    "./crud/types": {
+      "types": "./dist/crud/types.d.ts",
+      "bun": "./src/crud/types.ts",
+      "import": "./dist/crud/types.js",
+      "default": "./dist/crud/types.js"
+    },
+    "./crud/*": {
+      "types": "./dist/crud/*.d.ts",
+      "bun": "./src/crud/*.ts",
+      "import": "./dist/crud/*.js",
+      "default": "./dist/crud/*.js"
+    },
+    "./collection": {
+      "types": "./dist/collection/index.d.ts",
+      "bun": "./src/collection/index.ts",
+      "import": "./dist/collection/index.js",
+      "default": "./dist/collection/index.js"
+    },
+    "./collection/*": {
+      "types": "./dist/collection/*.d.ts",
+      "bun": "./src/collection/*.ts",
+      "import": "./dist/collection/*.js",
+      "default": "./dist/collection/*.js"
+    },
+    "./extensions": {
+      "types": "./dist/extensions/index.d.ts",
+      "bun": "./src/extensions/index.ts",
+      "import": "./dist/extensions/index.js",
+      "default": "./dist/extensions/index.js"
+    },
+    "./extensions/*": {
+      "types": "./dist/extensions/*.d.ts",
+      "bun": "./src/extensions/*.ts",
+      "import": "./dist/extensions/*.js",
+      "default": "./dist/extensions/*.js"
+    },
+    "./services": {
+      "types": "./dist/services/index.d.ts",
+      "bun": "./src/services/index.ts",
+      "import": "./dist/services/index.js",
+      "default": "./dist/services/index.js"
+    },
+    "./services/config": {
+      "types": "./dist/services/config.d.ts",
+      "bun": "./src/services/config.ts",
+      "import": "./dist/services/config.js",
+      "default": "./dist/services/config.js"
+    },
+    "./services/*": {
+      "types": "./dist/services/*.d.ts",
+      "bun": "./src/services/*.ts",
+      "import": "./dist/services/*.js",
+      "default": "./dist/services/*.js"
+    },
+    "./services/config-storage": {
+      "types": "./dist/services/config-storage/index.d.ts",
+      "bun": "./src/services/config-storage/index.ts",
+      "import": "./dist/services/config-storage/index.js",
+      "default": "./dist/services/config-storage/index.js"
+    },
+    "./services/config-storage/*": {
+      "types": "./dist/services/config-storage/*.d.ts",
+      "bun": "./src/services/config-storage/*.ts",
+      "import": "./dist/services/config-storage/*.js",
+      "default": "./dist/services/config-storage/*.js"
+    },
+    "./settings": {
+      "types": "./dist/settings/index.d.ts",
+      "bun": "./src/settings/index.ts",
+      "import": "./dist/settings/index.js",
+      "default": "./dist/settings/index.js"
+    },
+    "./settings/*": {
+      "types": "./dist/settings/*.d.ts",
+      "bun": "./src/settings/*.ts",
+      "import": "./dist/settings/*.js",
+      "default": "./dist/settings/*.js"
+    },
+    "./adapters/cli": {
+      "types": "./dist/adapters/cli/index.d.ts",
+      "bun": "./src/adapters/cli/index.ts",
+      "import": "./dist/adapters/cli/index.js",
+      "default": "./dist/adapters/cli/index.js"
+    },
+    "./adapters/cli/*": {
+      "types": "./dist/adapters/cli/*.d.ts",
+      "bun": "./src/adapters/cli/*.ts",
+      "import": "./dist/adapters/cli/*.js",
+      "default": "./dist/adapters/cli/*.js"
+    },
+    "./cli/settings.descriptor": {
+      "types": "./dist/cli/settings.descriptor.d.ts",
+      "bun": "./src/cli/settings.descriptor.ts",
+      "import": "./dist/cli/settings.descriptor.js",
+      "default": "./dist/cli/settings.descriptor.js"
+    },
+    "./cli/*": {
+      "types": "./dist/cli/*.d.ts",
+      "bun": "./src/cli/*.ts",
+      "import": "./dist/cli/*.js",
+      "default": "./dist/cli/*.js"
+    },
+    "./browser": {
+      "types": "./dist/browser/index.d.ts",
+      "bun": "./src/browser/index.ts",
+      "import": "./dist/browser/index.js",
+      "default": "./dist/browser/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "bun": "./src/server/index.ts",
+      "import": "./dist/server/index.js",
+      "default": "./dist/server/index.js"
+    },
+    "./common": {
+      "types": "./dist/common/index.d.ts",
+      "bun": "./src/common/index.ts",
+      "import": "./dist/common/index.js",
+      "default": "./dist/common/index.js"
+    },
+    "./config.plugin": {
+      "types": "./dist/config.plugin.d.ts",
+      "bun": "./src/config.plugin.ts",
+      "import": "./dist/config.plugin.js",
+      "default": "./dist/config.plugin.js"
+    },
+    "./env": {
+      "types": "./dist/env.d.ts",
+      "bun": "./src/env.ts",
+      "import": "./dist/env.js",
+      "default": "./dist/env.js"
+    },
+    "./system-constants": {
+      "types": "./dist/system-constants.d.ts",
+      "bun": "./src/system-constants.ts",
+      "import": "./dist/system-constants.js",
+      "default": "./dist/system-constants.js"
+    },
+    "./doctor": {
+      "types": "./dist/doctor.d.ts",
+      "bun": "./src/doctor.ts",
+      "import": "./dist/doctor.js",
+      "default": "./dist/doctor.js"
+    },
+    "./environment/*": {
+      "types": "./dist/environment/*.d.ts",
+      "bun": "./src/environment/*.ts",
+      "import": "./dist/environment/*.js",
+      "default": "./dist/environment/*.js"
+    },
+    "./env.runtime": {
+      "types": "./dist/env.runtime.d.ts",
+      "bun": "./src/env.runtime.ts",
+      "import": "./dist/env.runtime.js",
+      "default": "./dist/env.runtime.js"
+    },
+    "./adapters/web/*": {
+      "types": "./dist/adapters/web/*.d.ts",
+      "bun": "./src/adapters/web/*.ts",
+      "import": "./dist/adapters/web/*.js",
+      "default": "./dist/adapters/web/*.js"
+    },
+    "./adapters/web/components/*": {
+      "types": "./dist/adapters/web/components/*.d.ts",
+      "bun": "./src/adapters/web/components/*",
+      "import": "./dist/adapters/web/components/*.js",
+      "default": "./dist/adapters/web/components/*.js"
+    },
+    "./client/*": {
+      "types": "./dist/client/*.d.ts",
+      "bun": "./src/client/*.ts",
+      "import": "./dist/client/*.js",
+      "default": "./dist/client/*.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "bun": "./src/client/index.ts",
+      "import": "./dist/client/index.js",
+      "default": "./dist/client/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage/index.d.ts",
+      "bun": "./src/storage/index.ts",
+      "import": "./dist/storage/index.js",
+      "default": "./dist/storage/index.js"
+    },
+    "./storage/*": {
+      "types": "./dist/storage/*.d.ts",
+      "bun": "./src/storage/*.ts",
+      "import": "./dist/storage/*.js",
+      "default": "./dist/storage/*.js"
+    },
+    "./plugin": {
+      "types": "./dist/config.plugin.d.ts",
+      "bun": "./src/config.plugin.ts",
+      "import": "./dist/config.plugin.js",
+      "default": "./dist/config.plugin.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vibesdotdev/monorepo.git",
+    "directory": "packages/config"
+  },
+  "peerDependencies": {
+    "@vibesdotdev/runtime": "0.0.1"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1",
+    "zod": "^4.3.6"
+  },
+  "optionalDependencies": {
+    "react": "^19.2.6"
+  },
+  "scripts": {
+    "test:unit": "bun --bun vitest run",
+    "test": "bun --bun vitest run",
+    "test:ci": "bun --bun vitest run --reporter=verbose",
+    "check": "bun --bun tsc -p tsconfig.json --noEmit",
+    "build": "tsc -p tsconfig.json"
+  },
+  "license": "MIT",
+  "files": [
+    "dist",
+    "src",
+    "bin",
+    "README.md",
+    "SPEC.md",
+    "LICENSE",
+    "!src/**/__tests__/**",
+    "!src/**/__stubs__/**",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
+    "!src/**/*.spec.ts",
+    "!src/**/*.spec.tsx",
+    "!dist/**/__tests__/**",
+    "!dist/**/__stubs__/**",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.d.ts.map",
+    "!dist/**/*.spec.js",
+    "!dist/**/*.spec.js.map",
+    "!dist/**/*.spec.d.ts",
+    "!dist/**/*.spec.d.ts.map"
+  ],
+  "vibes": {
+    "visibility": "public-framework"
+  }
+}

package/src/adapters/cli/flags.ts

@@ -0,0 +1,260 @@
+/**
+ * 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';
+
+// Value Parsing
+
+/**
+ * Parse a string value into its appropriate type.
+ */
+function parseValue(value: string): unknown {
+	// 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: ConfigOverride, path: string, value: unknown): void {
+	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] as ConfigOverride;
+	}
+
+	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: string): ParsedConfigFlag {
+	const equalsIndex = flag.indexOf('=');
+
+	if (equalsIndex === -1) {
+		// No value, treat as boolean true
+		const config: ConfigOverride = {};
+		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: ConfigOverride = {};
+	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: string | string[] | undefined): ConfigOverride {
+	if (!flags) return {};
+
+	const flagArray =
+		typeof flags === 'string'
+			? flags
+					.split(',')
+					.map((s) => s.trim())
+					.filter(Boolean)
+			: flags;
+
+	const result: ConfigOverride = {};
+
+	for (const flag of flagArray) {
+		const parsed = parseConfigFlag(flag);
+		deepMerge(result, parsed.config);
+	}
+
+	return result;
+}
+
+/**
+ * Deep merge source into target.
+ */
+function deepMerge(target: ConfigOverride, source: ConfigOverride): void {
+	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] as ConfigOverride, value as ConfigOverride);
+		} 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(): (
+	value: string,
+	previous: ConfigOverride
+) => ConfigOverride {
+	return (value: string, previous: ConfigOverride = {}) => {
+		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: ConfigOverride,
+	allowedKeys: string[]
+): string[] {
+	const unknownKeys: string[] = [];
+	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: ConfigOverride): string {
+	const lines: string[] = [];
+
+	function format(obj: ConfigOverride, prefix = ''): void {
+		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 as ConfigOverride, path);
+			} else {
+				lines.push(`  ${path} = ${JSON.stringify(value)}`);
+			}
+		}
+	}
+
+	format(overrides);
+	return lines.join('\n');
+}