optionkit 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 optionkit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,134 @@
-# Temporary Holding Version
+# optionkit
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`optionkit` turns a Zod configuration schema into CLI options. It adds
+environment-variable bindings, adds unambiguous short flags, and lazily loads
+the CLI stack without making Fireargs, Commander, or Zod runtime dependencies
+of this package.
+
+```ts
+import { createOptionKit } from 'optionkit';
+
+const { f, z } = await createOptionKit({ moduleUrl: import.meta.url });
+
+const appOptionsSchema = z.object({
+  port: z.number().default(3000).describe('Port to listen on.'),
+  debug: z.boolean().default(false).describe('Write diagnostics to stderr.'),
+  logLevel: z.enum(['info', 'warn', 'error']).default('info')
+    .describe('Minimum log level.'),
+}).readonly();
+
+const serve = f.command({ name: 'serve', description: 'Start the server.' })
+  .input(appOptionsSchema)
+  .output(z.void())
+  .handler(async config => {
+    await startServer(config);
+  });
+
+await serve.parseAsync(process.argv);
+```
+
+If the consuming package is named `my-app`, the fields above receive
+`MY_APP_PORT`, `MY_APP_DEBUG`, and `MY_APP_LOG_LEVEL`. `port`, `debug`, and
+`logLevel` also receive `-p`, `-d`, and `-l` because their initials do not
+conflict. When two options share an initial, neither gets that automatic short
+flag.
+
+Adaptation happens at each command's `.input(...)` boundary. Subcommands need no
+special handling: build each leaf from its own schema, then mount the leaves with
+`f.program(...).router({ serve, status })`. Environment and short-flag conflicts
+are calculated independently for each leaf.
+
+## Lazy CLI dependencies
+
+optionkit first resolves Fireargs and Zod from the consuming CLI package. If
+they are unavailable, it detects the package manager from the invocation
+directory and installs the pinned Fireargs and Zod ranges from the consuming
+package root. `cacheDirectory` opts into an isolated install explicitly; there
+is no default versioned cache. Fireargs' package metadata supplies its remaining
+peer dependencies. Optionkit restores the consuming manifest and lockfile
+byte-for-byte after installation, and installer output stays silent so JSON
+output is not polluted.
+
+Only `@antfu/install-pkg` is a runtime dependency of optionkit. Fireargs,
+Zod, and `clean-stack` are development dependencies whose ranges are generated
+into the build from the catalog in `pnpm-workspace.yaml`. A matching root
+catalog keeps Bun compatible, and verification fails if the two catalogs
+diverge. `src/_generated/catalog.ts` is a one-to-one runtime mirror of the root
+catalog. The stack cleaner is installed separately and best-effort: a failure
+never prevents the CLI from starting, and `formatError` falls back to the
+original stack. Fireargs and Zod are also declared as optional peers, so a
+consumer's compatible installation is reused without making either package a
+required install.
+
+Use the returned `z` when the consuming package does not otherwise depend on
+Zod. It always comes from the same dependency location as the CLI adapter:
+
+```ts
+const { f, z } = await createOptionKit({ moduleUrl: import.meta.url });
+const input = z.object({ verbose: z.boolean().default(false) });
+```
+
+Use `environmentPrefix` or `projectName` to override automatic package-name
+translation. Per-field `env` and `short` values can be overridden or disabled:
+
+```ts
+await createOptionKit({
+  environmentPrefix: 'SERVICE',
+  fields: {
+    debug: { env: false, short: 'x' },
+  },
+  moduleUrl: import.meta.url,
+});
+```
+
+Array, tuple, object, and record options with generated environment bindings try
+JSON first because an environment variable supplies only one string. For example,
+`APP_TAGS='["one","two"]'` and `APP_ENV='{"PORT":"3000"}'` become their
+corresponding Zod input values. Arrays also accept comma- or whitespace-delimited
+shell words, including quotes and backslash escapes. If decoding does not apply,
+the original string reaches Zod as the final authority. Fireargs continues to
+handle scalar coercion. The same structured syntax works when passed as a flag.
+A consumer-supplied Fireargs `parse` function is forwarded unchanged and takes
+precedence over this augmentation. Every other per-option Fireargs configuration
+field is forwarded as well; command and program configuration remains available
+through the returned `f` namespace.
+
+Fireargs programs currently show help when invoked without a subcommand. Optionkit
+does not override that dispatch: Commander only exposes a clean default-command
+switch while adding a command, whereas Fireargs owns that mounting step. A shim
+would either depend on Commander internals or duplicate Fireargs routing.
+
+`resolvePackage` and `importPackageIfAvailable` expose the same resolve-first
+behavior for other optional integrations. They only suppress a genuinely
+missing package; initialization errors from an installed package still surface.
+
+## Pyfig migration
+
+Pyfig can keep `pyfigOptionsSchema` as its API source of truth. Its CLI only
+needs to replace the manual loader; Optionkit adapts every command input:
+
+```ts
+const { f, z } = await createOptionKit({
+  log,
+  moduleUrl: import.meta.url,
+});
+
+const createInput = (passthrough = false) => pyfigOptionsSchema.unwrap().extend({
+  ...(passthrough ? { args: f.argument().schema(passthroughArguments) } : {}),
+});
+```
+
+The command, router, output schemas, handlers, and passthrough behavior do not
+change. `PYFIG_*` names and conflict-free short flags are derived automatically.
+Pyfig needs only `optionkit` for its CLI integration; it does not need its own
+Fireargs peer metadata, Fireargs development dependency, or install helper.
+
+## Install
+
+```sh
+bun add optionkit
+```
+
+## License
+
+MIT

package/dist/_generated/catalog.d.ts

@@ -0,0 +1,6 @@
+export declare const catalog: {
+    readonly "clean-stack": "^7.0.0";
+    readonly fireargs: "^0.6.2";
+    readonly zod: "^4.6.7";
+};
+//# sourceMappingURL=catalog.d.ts.map

package/dist/_generated/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/_generated/catalog.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,OAAO;aAClB,aAAa,EAAE,QAAQ;aACvB,QAAU,EAAE,QAAQ;aACpB,GAAK,EAAE,QAAQ;CACP,CAAC"}

package/dist/_generated/catalog.js

@@ -0,0 +1,7 @@
+// Generated from package.json by scripts/generate-catalog.ts.
+export const catalog = {
+    "clean-stack": "^7.0.0",
+    "fireargs": "^0.6.2",
+    "zod": "^4.6.7"
+};
+//# sourceMappingURL=catalog.js.map

package/dist/_generated/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/_generated/catalog.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,aAAa,EAAE,QAAQ;IACvB,UAAU,EAAE,QAAQ;IACpB,KAAK,EAAE,QAAQ;CACP,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createOptionKit, type ArgumentConfiguration, type CliCommand, type CliParseOptions, type CliProgram, type CliRoute, type CommandConfiguration, type CreateOptionKitSettings, type FieldBuilder, type OptionConfiguration, type OptionKit, type OptionKitAdapter, type OptionKitLogger, type ProgramConfiguration, } from './optionkit.js';
+export { importPackageIfAvailable, resolvePackage } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createOptionKit, } from './optionkit.js';
+export { importPackageIfAvailable, resolvePackage } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAchB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}

package/dist/optionkit.d.ts

@@ -0,0 +1,122 @@
+import type { ZodArray, ZodBoolean, ZodNumber, ZodObject, ZodReadonly, ZodString, ZodType } from 'zod';
+type ZodNamespace = typeof import('zod').z;
+type ZodShape = Record<string, ZodType>;
+type ObjectSchema = ZodObject<ZodShape> | ZodReadonly<ZodObject<ZodShape>>;
+type SchemaInput<Schema extends ZodType> = import('zod').input<Schema>;
+type SchemaOutput<Schema extends ZodType> = import('zod').output<Schema>;
+export interface OptionConfiguration<Value = unknown> {
+    /** Long flag without dashes. Defaults to the kebab-case field key. */
+    name?: string;
+    /** Override the generated environment variable, or disable it for this field. */
+    env?: string | false;
+    /** Override the generated short flag, or disable it for this field. */
+    short?: string | false;
+    conflicts?: string | string[];
+    implies?: Record<string, unknown>;
+    hidden?: boolean;
+    preset?: unknown;
+    helpGroup?: string;
+    defaultDescription?: string;
+    /** Fireargs parser for one CLI or environment string; disables automatic decoding. */
+    parse?: (value: string) => Value;
+}
+export interface ArgumentConfiguration<Value = unknown> {
+    name?: string;
+    defaultDescription?: string;
+    parse?: (value: string) => Value;
+}
+export type CommandConfiguration = Record<string, unknown>;
+export type ProgramConfiguration = Record<string, unknown>;
+export interface CliParseOptions {
+    from?: 'electron' | 'node' | 'user';
+}
+export interface CliRoute {
+    readonly type: 'command' | 'program';
+    helpInformation(): string;
+    parseAsync(argv?: readonly string[], options?: CliParseOptions): Promise<unknown>;
+}
+export interface CliCommand extends CliRoute {
+    readonly type: 'command';
+}
+export interface CliProgram extends CliRoute {
+    readonly type: 'program';
+}
+export interface CommandContext {
+    readonly command: CliCommand;
+    readonly json: boolean;
+}
+export interface RenderContext<Input> {
+    readonly command: CliCommand;
+    readonly input: Input;
+    readonly json: false;
+}
+export interface FieldBuilder<Value = never> {
+    string(): ZodString;
+    number(): ZodNumber;
+    boolean(): ZodBoolean;
+    enum<const Values extends readonly [string, ...string[]]>(values: Values): ZodType<Values[number]>;
+    array<Inner extends ZodType>(inner: Inner): ZodArray<Inner>;
+    schema<Schema extends ZodType>(schema: Schema): Schema;
+}
+interface HandlerBuilder<Input extends ObjectSchema, Output extends ZodType> {
+    handler(handler: (input: SchemaOutput<Input>, context: CommandContext) => SchemaInput<Output> | Promise<SchemaInput<Output>>): CliCommand;
+}
+interface OutputBuilder<Input extends ObjectSchema, Output extends ZodType> extends HandlerBuilder<Input, Output> {
+    render(render: (output: SchemaOutput<Output>, context: RenderContext<SchemaOutput<Input>>) => string | void | Promise<string | void>): HandlerBuilder<Input, Output>;
+}
+export interface OptionKitAdapter {
+    argument<Value = never>(configuration?: ArgumentConfiguration<Value>): FieldBuilder<Value>;
+    command(configuration?: CommandConfiguration): {
+        input<Input extends ObjectSchema>(schema: Input): {
+            output<Output extends ZodType>(schema: Output): OutputBuilder<Input, Output>;
+        };
+    };
+    option<Value = never>(configuration?: OptionConfiguration<Value>): FieldBuilder<Value>;
+    program(configuration?: ProgramConfiguration): {
+        router(routes: Readonly<Record<string, CliRoute>>): CliProgram;
+    };
+}
+export type OptionKitLogger = (message: string, details?: Readonly<Record<string, unknown>>) => void;
+export interface CreateOptionKitSettings {
+    /** Module URL for the consuming CLI; used to find its nearest package.json. */
+    moduleUrl?: string | URL;
+    /** Explicit consuming package root when moduleUrl discovery is not appropriate. */
+    packageRoot?: string;
+    /** Override the consuming package name used to derive the environment prefix. */
+    projectName?: string;
+    /** Override the generated prefix, or disable environment bindings. */
+    environmentPrefix?: string | false;
+    /** Generate non-conflicting single-letter flags. Defaults to true. */
+    shortFlags?: boolean;
+    /** Letters that automatic short-flag generation must not use. */
+    reservedShortFlags?: readonly string[];
+    /** Per-field CLI metadata applied after generated values. */
+    fields?: Readonly<Record<string, OptionConfiguration>>;
+    /** Working directory used to detect the caller's package manager. */
+    invocationDirectory?: string;
+    /** Explicit isolated install directory. By default, missing packages install at packageRoot. */
+    cacheDirectory?: string;
+    /** Optional diagnostics sink. optionkit never writes install progress itself. */
+    log?: OptionKitLogger;
+}
+export interface OptionKit {
+    /** CLI builder namespace, loaded from the project or the lazy cache. */
+    f: OptionKitAdapter;
+    /** Zod from the same dependency location as the CLI adapter. */
+    z: ZodNamespace;
+    /** Prefix used for generated environment variables, including its trailing underscore. */
+    environmentPrefix: string | false;
+    /** The consuming package root discovered for this CLI. */
+    packageRoot: string;
+    /** Where the CLI dependencies were resolved or installed. */
+    dependencySource: 'cache' | 'package-root' | 'project';
+    /** Render an error with clean-stack when the optional dependency is available. */
+    formatError: (error: unknown) => string;
+}
+/**
+ * Load the CLI adapter on demand. Every command input is transparently augmented
+ * with environment bindings and conflict-free short flags.
+ */
+export declare function createOptionKit(settings?: CreateOptionKitSettings): Promise<OptionKit>;
+export {};
+//# sourceMappingURL=optionkit.d.ts.map

package/dist/optionkit.d.ts.map

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

package/dist/optionkit.js

@@ -0,0 +1,501 @@
+import { constants } from 'node:fs';
+import { access, mkdir, readFile, realpath, rm, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { detectPackageManager, installPackage } from '@antfu/install-pkg';
+import { catalog } from './_generated/catalog.js';
+import { importPackageIfAvailable, resolvePackage } from './resolve.js';
+const REQUIRED_CLI_DEPENDENCY_SPECIFIERS = [
+    `fireargs@${catalog.fireargs}`,
+    `zod@${catalog.zod}`,
+];
+const CLEAN_STACK_SPECIFIER = `clean-stack@${catalog['clean-stack']}`;
+const installPromises = new Map();
+const cleanStackPromises = new Map();
+/**
+ * Load the CLI adapter on demand. Every command input is transparently augmented
+ * with environment bindings and conflict-free short flags.
+ */
+export async function createOptionKit(settings = {}) {
+    const packageInfo = await consumingPackage(settings);
+    const loaded = await loadDependencies(packageInfo.root, settings);
+    const environmentPrefix = resolveEnvironmentPrefix(settings.environmentPrefix, settings.projectName ?? packageInfo.name);
+    return {
+        f: createAdapter(loaded.f, loaded.z, environmentPrefix, settings),
+        z: loaded.z,
+        environmentPrefix,
+        packageRoot: packageInfo.root,
+        dependencySource: loaded.source,
+        formatError: error => formatError(error, loaded.cleanStack),
+    };
+}
+async function consumingPackage(settings) {
+    const root = settings.packageRoot
+        ? path.resolve(settings.packageRoot)
+        : await findPackageRoot(await discoveryStart(settings.moduleUrl));
+    const manifest = JSON.parse(await readFile(path.join(root, 'package.json'), 'utf8'));
+    const name = settings.projectName ?? manifest.name;
+    if (typeof name !== 'string' || name.trim() === '') {
+        throw new TypeError('The consuming package must have a name or set projectName.');
+    }
+    return { name, root };
+}
+async function discoveryStart(moduleUrl) {
+    const candidate = moduleUrl === undefined
+        ? process.argv[1] ?? process.cwd()
+        : moduleUrl instanceof URL || moduleUrl.startsWith('file:')
+            ? fileURLToPath(moduleUrl)
+            : moduleUrl;
+    const absolute = path.resolve(candidate);
+    try {
+        return await realpath(absolute);
+    }
+    catch {
+        return absolute;
+    }
+}
+async function findPackageRoot(start) {
+    let current;
+    try {
+        current = (await stat(start)).isDirectory() ? start : path.dirname(start);
+    }
+    catch {
+        current = path.extname(start) === '' ? start : path.dirname(start);
+    }
+    while (true) {
+        const manifest = path.join(current, 'package.json');
+        try {
+            await access(manifest, constants.R_OK);
+            return current;
+        }
+        catch {
+            const parent = path.dirname(current);
+            if (parent === current) {
+                throw new Error(`Could not find a package.json above ${JSON.stringify(start)}.`);
+            }
+            current = parent;
+        }
+    }
+}
+async function loadDependencies(packageRoot, settings) {
+    const project = await importDependencies(packageRoot);
+    const invocationDirectory = path.resolve(settings.invocationDirectory ?? process.cwd());
+    const detected = await detectPackageManager(invocationDirectory);
+    const packageManager = detected ?? 'npm';
+    const installRoot = path.resolve(settings.cacheDirectory ?? packageRoot);
+    const installSource = settings.cacheDirectory ? 'cache' : 'package-root';
+    if (settings.cacheDirectory)
+        await ensureCachePackage(installRoot);
+    if (project) {
+        const projectCleanStack = await importCleanStack(packageRoot, settings.log);
+        const cleanStack = projectCleanStack ?? await cachedCleanStack(installRoot, packageManager, settings.log);
+        return { ...project, cleanStack, source: 'project' };
+    }
+    let installation = installPromises.get(installRoot);
+    if (!installation) {
+        installation = installAndImport(installRoot, packageManager, installSource, settings.log);
+        installPromises.set(installRoot, installation);
+    }
+    try {
+        return await installation;
+    }
+    catch (error) {
+        installPromises.delete(installRoot);
+        throw error;
+    }
+}
+async function installAndImport(installRoot, packageManager, source, log) {
+    const cleanStack = await cachedCleanStack(installRoot, packageManager, log);
+    const existing = await importDependencies(installRoot);
+    if (existing)
+        return { ...existing, cleanStack, source };
+    log?.('Installing required CLI dependencies.', {
+        installDirectory: installRoot,
+        packages: REQUIRED_CLI_DEPENDENCY_SPECIFIERS,
+        packageManager,
+    });
+    try {
+        await installWithoutSaving(REQUIRED_CLI_DEPENDENCY_SPECIFIERS, installRoot, packageManager);
+    }
+    catch (error) {
+        log?.('Could not install required CLI dependencies.', {
+            error: formatError(error, cleanStack),
+        });
+        throw error;
+    }
+    const installed = await importDependencies(installRoot);
+    if (!installed) {
+        const unresolved = ['fireargs', 'zod'].filter(name => !resolvePackage(name, installRoot));
+        throw new Error(`CLI dependencies were installed but ${unresolved.join(' and ') || 'their exports'} could not be resolved from ${installRoot}.`);
+    }
+    log?.('Required CLI dependencies are ready.', { installDirectory: installRoot });
+    return { ...installed, cleanStack, source };
+}
+async function importDependencies(root) {
+    const [adapter, zod] = await Promise.all([
+        importPackageIfAvailable('fireargs', root),
+        importPackageIfAvailable('zod', root),
+    ]);
+    if (!adapter || !zod)
+        return undefined;
+    const requiredBuilders = ['argument', 'command', 'option', 'program'];
+    if (!adapter.f || requiredBuilders.some(name => typeof adapter.f[name] !== 'function')) {
+        throw new TypeError('The resolved CLI adapter does not expose its required builder functions.');
+    }
+    if (!zod.z || typeof zod.z.object !== 'function') {
+        throw new TypeError('The resolved Zod package does not expose z.object().');
+    }
+    return { f: adapter.f, z: zod.z };
+}
+async function cachedCleanStack(cacheRoot, packageManager, log) {
+    let installation = cleanStackPromises.get(cacheRoot);
+    if (!installation) {
+        installation = installCleanStack(cacheRoot, packageManager, log);
+        cleanStackPromises.set(cacheRoot, installation);
+    }
+    return installation;
+}
+async function installCleanStack(installRoot, packageManager, log) {
+    const existing = await importCleanStack(installRoot, log);
+    if (existing)
+        return existing;
+    log?.('Installing optional stack cleaner.', {
+        installDirectory: installRoot,
+        package: CLEAN_STACK_SPECIFIER,
+        packageManager,
+    });
+    try {
+        await installWithoutSaving(CLEAN_STACK_SPECIFIER, installRoot, packageManager);
+        const installed = await importCleanStack(installRoot, log);
+        if (installed)
+            log?.('Optional stack cleaner is ready.', { installDirectory: installRoot });
+        return installed;
+    }
+    catch (error) {
+        log?.('Optional stack cleaner is unavailable.', { error: formatError(error) });
+        return undefined;
+    }
+}
+async function importCleanStack(root, log) {
+    try {
+        return (await importPackageIfAvailable('clean-stack', root))
+            ?.default;
+    }
+    catch (error) {
+        log?.('Optional stack cleaner could not be loaded.', { error: formatError(error) });
+        return undefined;
+    }
+}
+function formatError(error, cleanStack) {
+    const stack = error instanceof Error
+        ? error.stack ?? `${error.name}: ${error.message}`
+        : String(error);
+    if (!cleanStack)
+        return stack;
+    try {
+        return cleanStack(stack, { pretty: true });
+    }
+    catch {
+        return stack;
+    }
+}
+async function ensureCachePackage(cacheRoot) {
+    await mkdir(cacheRoot, { recursive: true });
+    const manifest = path.join(cacheRoot, 'package.json');
+    try {
+        await writeFile(manifest, `${JSON.stringify({ name: 'optionkit-cli-cache', private: true, type: 'module' }, null, 2)}\n`, { encoding: 'utf8', flag: 'wx' });
+    }
+    catch (error) {
+        if (!(error instanceof Error && 'code' in error && error.code === 'EEXIST'))
+            throw error;
+    }
+}
+const INSTALL_STATE_FILES = [
+    'package.json',
+    'bun.lock',
+    'bun.lockb',
+    'package-lock.json',
+    'pnpm-lock.yaml',
+    'yarn.lock',
+];
+async function installWithoutSaving(packages, installRoot, packageManager) {
+    const snapshots = new Map();
+    for (const name of INSTALL_STATE_FILES) {
+        const filename = path.join(installRoot, name);
+        try {
+            snapshots.set(filename, await readFile(filename));
+        }
+        catch (error) {
+            if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT'))
+                throw error;
+            snapshots.set(filename, undefined);
+        }
+    }
+    try {
+        await installPackage(packages, {
+            additionalArgs: agent => noSaveArguments(agent),
+            cwd: installRoot,
+            packageManager,
+            preferOffline: true,
+            silent: true,
+        });
+    }
+    finally {
+        for (const [filename, content] of snapshots) {
+            if (content)
+                await writeFile(filename, content);
+            else
+                await rm(filename, { force: true });
+        }
+    }
+}
+function noSaveArguments(agent) {
+    if (agent === 'bun')
+        return ['--no-save'];
+    if (agent === 'npm')
+        return ['--no-save', '--package-lock=false'];
+    if (agent === 'pnpm')
+        return ['--lockfile=false'];
+    if (agent === 'yarn')
+        return ['--no-lockfile'];
+    return [];
+}
+function createAdapter(adapter, zod, environmentPrefix, settings) {
+    return {
+        ...adapter,
+        command(configuration = {}) {
+            const builder = adapter.command(configuration);
+            return {
+                input(schema) {
+                    const adapted = adaptInputSchema(schema, adapter, zod, environmentPrefix, settings);
+                    return builder.input(adapted);
+                },
+            };
+        },
+    };
+}
+function adaptInputSchema(schema, adapter, zod, environmentPrefix, settings) {
+    const object = objectSchema(schema);
+    const shape = object.shape;
+    const registered = Object.fromEntries(Object.entries(shape).flatMap(([key, field]) => {
+        const configuration = registeredFieldConfiguration(field, zod);
+        return configuration ? [[key, configuration]] : [];
+    }));
+    const configurations = optionConfigurations(shape, environmentPrefix, zod, settings, registered);
+    const fields = Object.fromEntries(Object.entries(shape).map(([key, field]) => {
+        if (registered[key]?.kind === 'argument')
+            return [key, field];
+        return [key, adapter.option(configurations[key]).schema(field)];
+    }));
+    return object.safeExtend(fields);
+}
+function objectShape(schema) {
+    return objectSchema(schema).shape;
+}
+function objectSchema(schema) {
+    let candidate = schema;
+    while (candidate && typeof candidate === 'object') {
+        if ('shape' in candidate) {
+            const shape = candidate.shape;
+            if (shape && typeof shape === 'object')
+                return candidate;
+        }
+        if (!('unwrap' in candidate) || typeof candidate.unwrap !== 'function')
+            break;
+        candidate = candidate.unwrap();
+    }
+    throw new TypeError('createOptionKit requires a Zod object schema, optionally wrapped as readonly.');
+}
+function resolveEnvironmentPrefix(configured, projectName) {
+    if (configured === false)
+        return false;
+    const translated = toEnvironmentKey(configured ?? projectName);
+    if (!translated)
+        throw new TypeError('The environment prefix must contain a letter or number.');
+    return `${translated}_`;
+}
+function optionConfigurations(shape, environmentPrefix, zod, settings, registered = {}) {
+    const keys = Object.keys(shape).filter(key => registered[key]?.kind !== 'argument');
+    const overrides = Object.fromEntries(keys.map(key => {
+        const existing = registered[key];
+        const existingOption = existing?.kind === 'option'
+            ? Object.fromEntries(Object.entries(existing).filter(([name]) => name !== 'kind'))
+            : {};
+        return [key, { ...settings.fields?.[key], ...existingOption }];
+    }));
+    const shorts = generatedShortFlags(keys, overrides, settings);
+    return Object.fromEntries(keys.map(key => {
+        const override = overrides?.[key];
+        const generated = {};
+        if (environmentPrefix !== false && override?.env !== false) {
+            generated.env = override?.env ?? `${environmentPrefix}${toEnvironmentKey(key)}`;
+            const kind = structuredValueKind(shape[key], zod);
+            if (kind && !override?.parse)
+                generated.parse = structuredValueParser(kind);
+        }
+        if (override?.short !== false && (override?.short ?? shorts[key])) {
+            generated.short = typeof override?.short === 'string'
+                ? normalizeShort(override.short, key)
+                : shorts[key];
+        }
+        if (override) {
+            const { env: _env, short: _short, parse, ...rest } = override;
+            Object.assign(generated, rest);
+            if (parse)
+                generated.parse = parse;
+        }
+        return [key, generated];
+    }));
+}
+function registeredFieldConfiguration(schema, zod, seen = new Set()) {
+    if (seen.has(schema))
+        return undefined;
+    seen.add(schema);
+    const metadata = zod.globalRegistry.get(schema);
+    const registered = metadata?.fireargs;
+    if (registered && typeof registered === 'object' && 'kind' in registered) {
+        const kind = registered.kind;
+        if (kind === 'argument' || kind === 'option') {
+            return registered;
+        }
+    }
+    if (schema instanceof zod.ZodPipe) {
+        return registeredFieldConfiguration(schema.in, zod, seen);
+    }
+    const wrapper = schema;
+    return typeof wrapper.unwrap === 'function'
+        ? registeredFieldConfiguration(wrapper.unwrap(), zod, seen)
+        : undefined;
+}
+/**
+ * Fireargs handles structured argv values, but an environment variable reaches
+ * Commander as one string. Detect only unambiguous JSON containers so scalar
+ * coercion and Fireargs' native parsing remain untouched.
+ */
+function structuredValueKind(schema, zod, seen = new Set()) {
+    if (!schema || seen.has(schema))
+        return undefined;
+    seen.add(schema);
+    if (schema instanceof zod.ZodArray || schema instanceof zod.ZodTuple)
+        return 'array';
+    if (schema instanceof zod.ZodObject || schema instanceof zod.ZodRecord)
+        return 'object';
+    if (schema instanceof zod.ZodUnion) {
+        const kinds = schema.options.map(option => (structuredValueKind(option, zod, new Set(seen)))).filter((kind) => kind !== undefined);
+        const unique = new Set(kinds);
+        return unique.size === 1 ? kinds[0] : undefined;
+    }
+    if (schema instanceof zod.ZodPipe) {
+        return structuredValueKind(schema.in, zod, seen);
+    }
+    const wrapper = schema;
+    return typeof wrapper.unwrap === 'function'
+        ? structuredValueKind(wrapper.unwrap(), zod, seen)
+        : undefined;
+}
+function structuredValueParser(kind) {
+    return ((value) => {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            // A non-JSON string may still be useful to an array schema or a union.
+        }
+        return kind === 'array' ? splitArrayValue(value) ?? value : value;
+    });
+}
+/** Split comma- or whitespace-delimited shell words without interpreting operators. */
+function splitArrayValue(value) {
+    const result = [];
+    let token = '';
+    let quote;
+    let escaped = false;
+    let started = false;
+    for (const character of value) {
+        if (escaped) {
+            token += character;
+            escaped = false;
+            started = true;
+        }
+        else if (character === '\\') {
+            escaped = true;
+            started = true;
+        }
+        else if (quote) {
+            if (character === quote)
+                quote = undefined;
+            else
+                token += character;
+            started = true;
+        }
+        else if (character === '"' || character === "'") {
+            quote = character;
+            started = true;
+        }
+        else if (character === ',' || /\s/u.test(character)) {
+            if (started)
+                result.push(token);
+            token = '';
+            started = false;
+        }
+        else {
+            token += character;
+            started = true;
+        }
+    }
+    if (quote || escaped)
+        return undefined;
+    if (started)
+        result.push(token);
+    return result;
+}
+function generatedShortFlags(keys, overrides, settings) {
+    if (settings.shortFlags === false)
+        return {};
+    const reserved = new Set(['h', ...(settings.reservedShortFlags ?? [])].map(value => value.toLowerCase()));
+    const explicit = new Map();
+    for (const key of keys) {
+        const value = overrides?.[key]?.short;
+        if (typeof value !== 'string')
+            continue;
+        const normalized = normalizeShort(value, key);
+        const owner = explicit.get(normalized);
+        if (owner)
+            throw new TypeError(`Short flag -${normalized} is configured for both ${owner} and ${key}.`);
+        if (reserved.has(normalized))
+            throw new TypeError(`Short flag -${normalized} is reserved.`);
+        explicit.set(normalized, key);
+    }
+    const candidates = new Map();
+    for (const key of keys) {
+        if (overrides?.[key]?.short !== undefined)
+            continue;
+        const longName = overrides?.[key]?.name ?? key;
+        const candidate = toEnvironmentKey(longName).charAt(0).toLowerCase();
+        if (!candidate || reserved.has(candidate) || explicit.has(candidate))
+            continue;
+        candidates.set(candidate, [...(candidates.get(candidate) ?? []), key]);
+    }
+    const result = {};
+    for (const [candidate, owners] of candidates) {
+        if (owners.length === 1)
+            result[owners[0]] = candidate;
+    }
+    return result;
+}
+function normalizeShort(value, key) {
+    const normalized = value.replace(/^-+/u, '').toLowerCase();
+    if (!/^[a-z0-9]$/u.test(normalized)) {
+        throw new TypeError(`Short flag for ${key} must be one letter or digit.`);
+    }
+    return normalized;
+}
+function toEnvironmentKey(value) {
+    return value
+        .replace(/([a-z0-9])([A-Z])/gu, '$1_$2')
+        .replace(/^@/u, '')
+        .replace(/[^a-zA-Z0-9]+/gu, '_')
+        .replace(/^_+|_+$/gu, '')
+        .toUpperCase();
+}
+//# sourceMappingURL=optionkit.js.map

package/dist/optionkit.js.map

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

package/dist/resolve.d.ts

@@ -0,0 +1,5 @@
+/** Resolve a package from an explicit package root without importing it. */
+export declare function resolvePackage(packageName: string, packageRoot: string): string | undefined;
+/** Import a package only when it is already resolvable from the supplied package root. */
+export declare function importPackageIfAvailable<Module = unknown>(packageName: string, packageRoot: string): Promise<Module | undefined>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAKA,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQ3F;AAED,0FAA0F;AAC1F,wBAAsB,wBAAwB,CAAC,MAAM,GAAG,OAAO,EAC7D,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAI7B"}

package/dist/resolve.js

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+/** Resolve a package from an explicit package root without importing it. */
+export function resolvePackage(packageName, packageRoot) {
+    const resolver = createRequire(path.join(path.resolve(packageRoot), 'package.json'));
+    try {
+        return resolver.resolve(packageName);
+    }
+    catch (error) {
+        if (isMissingModule(error))
+            return resolveInstalledPackage(packageName, packageRoot);
+        throw error;
+    }
+}
+/** Import a package only when it is already resolvable from the supplied package root. */
+export async function importPackageIfAvailable(packageName, packageRoot) {
+    const resolved = resolvePackage(packageName, packageRoot);
+    if (!resolved)
+        return undefined;
+    return import(pathToFileURL(resolved).href);
+}
+function isMissingModule(error) {
+    return error instanceof Error && 'code' in error && error.code === 'MODULE_NOT_FOUND';
+}
+/** Bypass Node's cached miss after a package was installed during this process. */
+function resolveInstalledPackage(packageName, packageRoot) {
+    if (!/^(?:@[a-z0-9._~-]+\/)?[a-z0-9._~-]+$/iu.test(packageName))
+        return undefined;
+    const directory = path.join(path.resolve(packageRoot), 'node_modules', ...packageName.split('/'));
+    const manifestPath = path.join(directory, 'package.json');
+    if (!existsSync(manifestPath))
+        return undefined;
+    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+    const entry = rootExport(manifest.exports)
+        ?? stringValue(manifest.module)
+        ?? stringValue(manifest.main)
+        ?? './index.js';
+    const resolved = path.resolve(directory, entry);
+    return existsSync(resolved) ? resolved : undefined;
+}
+function rootExport(value) {
+    if (typeof value === 'string')
+        return value;
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const record = value;
+    if (record['.'] !== undefined)
+        return rootExport(record['.']);
+    for (const condition of ['import', 'node', 'default', 'require']) {
+        const resolved = rootExport(record[condition]);
+        if (resolved)
+            return resolved;
+    }
+    return undefined;
+}
+function stringValue(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

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

package/package.json

@@ -1,6 +1,89 @@
 {
   "name": "optionkit",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "description": "Turn Zod configuration schemas into zero-setup CLI options.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "generate": "bun run scripts/generate-catalog.ts",
+    "test": "bun run generate && bun test",
+    "test:packed": "bun run build && bun run scripts/test-packed.ts",
+    "typecheck": "bun run generate && tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.scripts.json && tsc --noEmit -p tests/tsconfig.json",
+    "verify": "bun run typecheck && bun test && bun run build",
+    "release": "bun run scripts/release.ts",
+    "release:pack": "bun run scripts/pack-for-publish.ts",
+    "prepack": "bun run scripts/prepack.ts"
+  },
+  "keywords": [
+    "args",
+    "cli",
+    "config",
+    "environment",
+    "fireargs",
+    "zod"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/regbo/optionkit.git"
+  },
+  "bugs": {
+    "url": "https://github.com/regbo/optionkit/issues"
+  },
+  "homepage": "https://github.com/regbo/optionkit#readme",
+  "workspaces": [
+    "."
+  ],
+  "catalog": {
+    "clean-stack": "^7.0.0",
+    "fireargs": "^0.6.2",
+    "zod": "^4.6.7"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@antfu/install-pkg": "^2.1.0"
+  },
+  "peerDependencies": {
+    "fireargs": "catalog:",
+    "zod": "catalog:"
+  },
+  "peerDependenciesMeta": {
+    "fireargs": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/bun": "^1.4.4",
+    "@types/node": "^26.6.6",
+    "clean-stack": "catalog:",
+    "fireargs": "catalog:",
+    "typescript": "^7.0.2",
+    "zod": "catalog:"
+  },
+  "packageManager": "bun@1.4.4",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org"
+  }
+}