politty 0.5.0 → 0.6.0

package/README.md

@@ -297,6 +297,18 @@ Attach metadata to an argument.
 ## Shell Completion
 
 politty provides automatic shell completion generation for bash, zsh, and fish.
+The default generated script is a small runtime dispatcher: when the user
+presses TAB, it resolves the executable currently visible on `PATH` and uses a
+bundled static worker from that executable's package when one is available. If
+no package-relative bundled worker is found, it falls back to a per-binary
+static worker cache and regenerates that cache from the hidden
+`__refresh-completion` command when needed. Sourced workers are memoized for the
+shell session, so warm completions call the worker function directly.
+Completion fields that require runtime JavaScript still delegate to the
+binary's hidden `__complete` command.
+When `NODE_COMPILE_CACHE` is unset, the dispatcher sets it to a
+program-specific cache directory before invoking `__complete`, letting Node.js
+22+ reuse V8 module compile cache across repeated completion requests.
 
 ### Quick Setup
 
@@ -331,6 +343,41 @@ eval "$(mycli completion zsh)"
 mycli completion fish | source
 ```
 
+For project-local CLIs, put the local binary directory in `PATH` with your
+environment manager, for example:
+
+```sh
+# .envrc
+PATH_add node_modules/.bin
+```
+
+Completion then follows the same executable the shell would run.
+
+Published CLIs can ship a fast worker artifact:
+
+```bash
+politty generate-worker --bin dist/cli/index.mjs --program mycli --shell zsh --verify
+```
+
+or call `generateBundledCompletionWorker()` from `politty/completion` in your
+own build script. The default output path is
+`dist/completion/<shell>-worker.<ext>`.
+
+The dispatcher looks for common package-relative worker paths such as
+`dist/completion/zsh-worker.zsh` from the visible binary. Use
+`withCompletionCommand({ bundledWorker: { relativePaths: { zsh: [...] } } })`
+to customize the package-relative lookup. For package layouts that cannot be
+expressed with relative paths, `bundledWorker.queryCommand: true` lets the
+dispatcher ask the binary's hidden `__completion-worker-path` command on the
+miss path.
+
+To generate the older static script with command metadata baked in, use:
+
+```bash
+eval "$(mycli completion bash --static)"
+eval "$(mycli completion zsh --static)"
+```
+
 ### Value Completion
 
 Define completion hints for arguments:

package/dist/{arg-registry-6E0WHOh_.d.ts → arg-registry-BoqVZRFO.d.cts}

@@ -462,9 +462,9 @@ type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
  * A `resolve` callback registered on `arg(...)` receives parsed context
  * (other arg values typed so far, previous values supplied to the same
  * option, the current word being completed, target shell) and returns
- * candidates. The callback runs inside the `__complete` command, so static
- * shell scripts delegate to `<program> __complete` for any spec that uses
- * `resolve`.
+ * candidates. The callback runs inside the `__complete` command. Dispatcher
+ * shell scripts call `__complete` for every completion request; static shell
+ * scripts delegate to it for any spec that uses `resolve`.
  *
  * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
  * reference the resolver type without crossing the lint-enforced
@@ -514,14 +514,15 @@ type DynamicCompletionResolver = (ctx: DynamicCompletionContext) => DynamicCompl
 //#endregion
 //#region src/core/expand-completion-types.d.ts
 /**
- * Types for "expand" completion — candidates that are pre-enumerated at
- * script-generation time and inlined into the static shell script.
+ * Types for "expand" completion — candidates that depend on sibling arg
+ * values.
  *
  * The user provides `dependsOn` (sibling arg names that must have static
- * `choices` or an enum schema) and `enumerate(deps)`. politty walks the
- * cartesian product of the dependsOn values, calls `enumerate` for each
- * combination, and emits a case lookup keyed on the runtime values of those
- * args. No Node process is spawned on TAB.
+ * `choices` or an enum schema) and `enumerate(deps)`. Dispatcher scripts call
+ * `enumerate` inside `__complete` for the dependency values already typed on
+ * the command line. Static scripts walk the cartesian product of the
+ * dependsOn values, call `enumerate` for each combination, and emit a shell
+ * lookup table.
  *
  * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
  * reference these types without crossing the lint-enforced
@@ -546,10 +547,11 @@ interface ResolvedExpandCandidate {
  * order of `dependsOn` is the order in which `deps` keys are exposed to
  * `enumerate`.
  *
- * `enumerate` runs once per cartesian-product combination at the time the
- * shell script is generated (e.g. when the user runs `<program> completion
- * zsh`). It must be a pure function of `deps`; politty does not retain it
- * for runtime use.
+ * In dispatcher mode, `enumerate` runs during `__complete` for the dependency
+ * values already typed by the user. In static mode, it runs once per
+ * cartesian-product combination at script-generation time (e.g. when the user
+ * runs `<program> completion zsh --static`). It must be a pure function of
+ * `deps`.
  */
 interface ExpandCompletion {
   dependsOn: readonly string[];
@@ -575,17 +577,17 @@ interface CustomCompletion {
   /**
    * In-process JS callback for dynamic completion. Receives parsed context
    * (other arg values typed so far, previously supplied values for this same
-   * option) and returns candidates. Static shell scripts delegate to
-   * `<program> __complete` whenever this is set.
+   * option) and returns candidates. Dispatcher scripts call
+   * `<program> __complete` for every completion request; static scripts
+   * delegate to it whenever this is set.
    */
   resolve?: DynamicCompletionResolver;
   /**
-   * Pre-enumerated completion baked into the generated shell script. The
-   * candidate list is computed at script-generation time by calling
-   * `enumerate` for every combination of the sibling arg values listed in
-   * `dependsOn` (each must have a static `choices` or enum schema). The
-   * shell then dispatches via a case lookup keyed by the runtime values of
-   * those args — no Node process is spawned on TAB.
+   * Completion whose candidates depend on sibling arg values. Dispatcher
+   * scripts call `enumerate` inside `__complete` for the dependency values
+   * already typed on the command line. Static scripts pre-enumerate every
+   * combination of `dependsOn` values at script-generation time and dispatch
+   * via a shell lookup table.
    */
   expand?: ExpandCompletion;
 }
@@ -915,4 +917,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M, z.output<T>>): T;
 //#endregion
 export { LogStream as A, SetupContext as B, Example as C, IsEmpty as D, GlobalSetupContext as E, RunCommandOptions as F, lazy as G, SubCommandsRecord as H, RunResult as I, UnknownKeysMode as J, ExtractedFields as K, RunResultFailure as L, MainOptions as M, NonRunnableCommand as N, LogEntry as O, PromptResolver as P, toKebabCase as Q, RunResultSuccess as R, CommandBase as S, GlobalCleanupContext as T, LazyCommand as U, SubCommandValue as V, isLazyCommand as W, getUnknownKeysMode as X, extractFields as Y, toCamelCase as Z, AnyCommand as _, EffectContext as a, CollectedLogs as b, arg as c, ResolvedExpandCandidate as d, CompletionDirectiveMask as f, DynamicCompletionResult as g, DynamicCompletionResolver as h, CustomCompletion as i, Logger as j, LogLevel as k, ExpandCandidate as l, DynamicCompletionContext as m, CompletionMeta as n, PromptMeta as o, DynamicCompletionCandidate as p, ResolvedFieldMeta as q, CompletionType as r, PromptType as s, ArgMeta as t, ExpandCompletion as u, ArgsSchema as v, GlobalArgs as w, Command as x, CleanupContext as y, RunnableCommand as z };
-//# sourceMappingURL=arg-registry-6E0WHOh_.d.ts.map
+//# sourceMappingURL=arg-registry-BoqVZRFO.d.cts.map

package/dist/arg-registry-BoqVZRFO.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-BoqVZRFO.d.cts","names":[],"sources":["../src/core/schema-extractor.ts","../src/lazy.ts","../src/types.ts","../src/core/dynamic-completion-types.ts","../src/core/expand-completion-types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/{arg-registry--NRaNFJM.d.cts → arg-registry-BoqVZRFO.d.ts}

@@ -462,9 +462,9 @@ type RunResult<T = unknown> = RunResultSuccess<T> | RunResultFailure;
  * A `resolve` callback registered on `arg(...)` receives parsed context
  * (other arg values typed so far, previous values supplied to the same
  * option, the current word being completed, target shell) and returns
- * candidates. The callback runs inside the `__complete` command, so static
- * shell scripts delegate to `<program> __complete` for any spec that uses
- * `resolve`.
+ * candidates. The callback runs inside the `__complete` command. Dispatcher
+ * shell scripts call `__complete` for every completion request; static shell
+ * scripts delegate to it for any spec that uses `resolve`.
  *
  * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
  * reference the resolver type without crossing the lint-enforced
@@ -514,14 +514,15 @@ type DynamicCompletionResolver = (ctx: DynamicCompletionContext) => DynamicCompl
 //#endregion
 //#region src/core/expand-completion-types.d.ts
 /**
- * Types for "expand" completion — candidates that are pre-enumerated at
- * script-generation time and inlined into the static shell script.
+ * Types for "expand" completion — candidates that depend on sibling arg
+ * values.
  *
  * The user provides `dependsOn` (sibling arg names that must have static
- * `choices` or an enum schema) and `enumerate(deps)`. politty walks the
- * cartesian product of the dependsOn values, calls `enumerate` for each
- * combination, and emits a case lookup keyed on the runtime values of those
- * args. No Node process is spawned on TAB.
+ * `choices` or an enum schema) and `enumerate(deps)`. Dispatcher scripts call
+ * `enumerate` inside `__complete` for the dependency values already typed on
+ * the command line. Static scripts walk the cartesian product of the
+ * dependsOn values, call `enumerate` for each combination, and emit a shell
+ * lookup table.
  *
  * Defined under `core/` (not `completion/`) so `arg-registry.ts` can
  * reference these types without crossing the lint-enforced
@@ -546,10 +547,11 @@ interface ResolvedExpandCandidate {
  * order of `dependsOn` is the order in which `deps` keys are exposed to
  * `enumerate`.
  *
- * `enumerate` runs once per cartesian-product combination at the time the
- * shell script is generated (e.g. when the user runs `<program> completion
- * zsh`). It must be a pure function of `deps`; politty does not retain it
- * for runtime use.
+ * In dispatcher mode, `enumerate` runs during `__complete` for the dependency
+ * values already typed by the user. In static mode, it runs once per
+ * cartesian-product combination at script-generation time (e.g. when the user
+ * runs `<program> completion zsh --static`). It must be a pure function of
+ * `deps`.
  */
 interface ExpandCompletion {
   dependsOn: readonly string[];
@@ -575,17 +577,17 @@ interface CustomCompletion {
   /**
    * In-process JS callback for dynamic completion. Receives parsed context
    * (other arg values typed so far, previously supplied values for this same
-   * option) and returns candidates. Static shell scripts delegate to
-   * `<program> __complete` whenever this is set.
+   * option) and returns candidates. Dispatcher scripts call
+   * `<program> __complete` for every completion request; static scripts
+   * delegate to it whenever this is set.
    */
   resolve?: DynamicCompletionResolver;
   /**
-   * Pre-enumerated completion baked into the generated shell script. The
-   * candidate list is computed at script-generation time by calling
-   * `enumerate` for every combination of the sibling arg values listed in
-   * `dependsOn` (each must have a static `choices` or enum schema). The
-   * shell then dispatches via a case lookup keyed by the runtime values of
-   * those args — no Node process is spawned on TAB.
+   * Completion whose candidates depend on sibling arg values. Dispatcher
+   * scripts call `enumerate` inside `__complete` for the dependency values
+   * already typed on the command line. Static scripts pre-enumerate every
+   * combination of `dependsOn` values at script-generation time and dispatch
+   * via a shell lookup table.
    */
   expand?: ExpandCompletion;
 }
@@ -915,4 +917,4 @@ declare function arg<T extends z.ZodType>(schema: T): T;
 declare function arg<T extends z.ZodType, M extends ArgMeta<z.output<T>>>(schema: T, meta: ValidateArgMeta<M, z.output<T>>): T;
 //#endregion
 export { LogStream as A, SetupContext as B, Example as C, IsEmpty as D, GlobalSetupContext as E, RunCommandOptions as F, lazy as G, SubCommandsRecord as H, RunResult as I, UnknownKeysMode as J, ExtractedFields as K, RunResultFailure as L, MainOptions as M, NonRunnableCommand as N, LogEntry as O, PromptResolver as P, toKebabCase as Q, RunResultSuccess as R, CommandBase as S, GlobalCleanupContext as T, LazyCommand as U, SubCommandValue as V, isLazyCommand as W, getUnknownKeysMode as X, extractFields as Y, toCamelCase as Z, AnyCommand as _, EffectContext as a, CollectedLogs as b, arg as c, ResolvedExpandCandidate as d, CompletionDirectiveMask as f, DynamicCompletionResult as g, DynamicCompletionResolver as h, CustomCompletion as i, Logger as j, LogLevel as k, ExpandCandidate as l, DynamicCompletionContext as m, CompletionMeta as n, PromptMeta as o, DynamicCompletionCandidate as p, ResolvedFieldMeta as q, CompletionType as r, PromptType as s, ArgMeta as t, ExpandCompletion as u, ArgsSchema as v, GlobalArgs as w, Command as x, CleanupContext as y, RunnableCommand as z };
-//# sourceMappingURL=arg-registry--NRaNFJM.d.cts.map
+//# sourceMappingURL=arg-registry-BoqVZRFO.d.ts.map

package/dist/arg-registry-BoqVZRFO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arg-registry-BoqVZRFO.d.ts","names":[],"sources":["../src/core/schema-extractor.ts","../src/lazy.ts","../src/types.ts","../src/core/dynamic-completion-types.ts","../src/core/expand-completion-types.ts","../src/core/arg-registry.ts"],"mappings":"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"}

package/dist/augment.d.cts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry--NRaNFJM.cjs";
+import { t as ArgMeta } from "./arg-registry-BoqVZRFO.cjs";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/augment.d.ts

@@ -1,4 +1,4 @@
-import { t as ArgMeta } from "./arg-registry-6E0WHOh_.js";
+import { t as ArgMeta } from "./arg-registry-BoqVZRFO.js";
 
 //#region src/augment.d.ts
 declare module "zod" {

package/dist/cli.cjs

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+const require_schema_extractor = require('./schema-extractor-BxSRwLrx.cjs');
+const require_completion = require('./completion-CLHO3Xaz.cjs');
+const require_runner = require('./runner-BloFWJEB.cjs');
+require('./index.cjs');
+let zod = require("zod");
+
+//#region src/cli.ts
+require_runner.runMain(require_completion.defineCommand({
+	name: "politty",
+	description: "politty development utilities",
+	subCommands: { "generate-worker": require_completion.defineCommand({
+		name: "generate-worker",
+		description: "Generate and verify a bundled shell completion worker",
+		args: zod.z.object({
+			bin: require_schema_extractor.arg(zod.z.string(), {
+				description: "CLI binary or built JS entry file to invoke",
+				placeholder: "PATH"
+			}),
+			program: require_schema_extractor.arg(zod.z.string(), {
+				description: "Program name embedded in worker metadata",
+				placeholder: "NAME"
+			}),
+			shell: require_schema_extractor.arg(zod.z.enum([
+				"bash",
+				"zsh",
+				"fish"
+			]), {
+				description: "Shell worker to generate",
+				placeholder: "SHELL"
+			}),
+			out: require_schema_extractor.arg(zod.z.string().optional(), {
+				description: "Output worker path (defaults to dist/completion/<shell>-worker.<ext>)",
+				placeholder: "PATH"
+			}),
+			verify: require_schema_extractor.arg(zod.z.boolean().default(false), { description: "Verify __completion-worker-path resolves to the generated worker" })
+		}),
+		async run(args) {
+			await require_completion.generateBundledCompletionWorker({
+				bin: args.bin,
+				programName: args.program,
+				shell: args.shell,
+				...args.out !== void 0 && { outputPath: args.out },
+				verify: args.verify
+			});
+		}
+	}) }
+})).catch((error) => {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
+});
+
+//#endregion
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","names":["runMain","defineCommand","z","arg","generateBundledCompletionWorker"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { z } from \"zod\";\nimport { arg } from \"./core/arg-registry.js\";\nimport { defineCommand } from \"./core/command.js\";\nimport { runMain } from \"./core/runner.js\";\nimport { generateBundledCompletionWorker } from \"./index.js\";\n\nconst generateWorkerArgsSchema = z.object({\n  bin: arg(z.string(), {\n    description: \"CLI binary or built JS entry file to invoke\",\n    placeholder: \"PATH\",\n  }),\n  program: arg(z.string(), {\n    description: \"Program name embedded in worker metadata\",\n    placeholder: \"NAME\",\n  }),\n  shell: arg(z.enum([\"bash\", \"zsh\", \"fish\"]), {\n    description: \"Shell worker to generate\",\n    placeholder: \"SHELL\",\n  }),\n  out: arg(z.string().optional(), {\n    description: \"Output worker path (defaults to dist/completion/<shell>-worker.<ext>)\",\n    placeholder: \"PATH\",\n  }),\n  verify: arg(z.boolean().default(false), {\n    description: \"Verify __completion-worker-path resolves to the generated worker\",\n  }),\n});\n\ntype GenerateWorkerArgs = z.infer<typeof generateWorkerArgsSchema>;\n\nconst generateWorkerCommand = defineCommand({\n  name: \"generate-worker\",\n  description: \"Generate and verify a bundled shell completion worker\",\n  args: generateWorkerArgsSchema,\n  async run(args: GenerateWorkerArgs) {\n    await generateBundledCompletionWorker({\n      bin: args.bin,\n      programName: args.program,\n      shell: args.shell,\n      ...(args.out !== undefined && { outputPath: args.out }),\n      verify: args.verify,\n    });\n  },\n});\n\nconst cli = defineCommand({\n  name: \"politty\",\n  description: \"politty development utilities\",\n  subCommands: {\n    \"generate-worker\": generateWorkerCommand,\n  },\n});\n\nrunMain(cli).catch((error: unknown) => {\n  console.error(error instanceof Error ? error.message : String(error));\n  process.exit(1);\n});\n"],"mappings":";;;;;;;;AAuDAA,uBARYC,iCAAc;CACxB,MAAM;CACN,aAAa;CACb,aAAa,EACX,mBAnB0BA,iCAAc;EAC1C,MAAM;EACN,aAAa;EACb,MA3B+BC,MAAE,OAAO;GACxC,KAAKC,6BAAID,MAAE,OAAO,GAAG;IACnB,aAAa;IACb,aAAa;GACf,CAAC;GACD,SAASC,6BAAID,MAAE,OAAO,GAAG;IACvB,aAAa;IACb,aAAa;GACf,CAAC;GACD,OAAOC,6BAAID,MAAE,KAAK;IAAC;IAAQ;IAAO;GAAM,CAAC,GAAG;IAC1C,aAAa;IACb,aAAa;GACf,CAAC;GACD,KAAKC,6BAAID,MAAE,OAAO,CAAC,CAAC,SAAS,GAAG;IAC9B,aAAa;IACb,aAAa;GACf,CAAC;GACD,QAAQC,6BAAID,MAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK,GAAG,EACtC,aAAa,mEACf,CAAC;EACH,CAO+B;EAC7B,MAAM,IAAI,MAA0B;GAClC,MAAME,mDAAgC;IACpC,KAAK,KAAK;IACV,aAAa,KAAK;IAClB,OAAO,KAAK;IACZ,GAAI,KAAK,QAAQ,UAAa,EAAE,YAAY,KAAK,IAAI;IACrD,QAAQ,KAAK;GACf,CAAC;EACH;CACF,CAM2C,EACzC;AACF,CAEU,CAAC,CAAC,CAAC,OAAO,UAAmB;CACrC,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;CACpE,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/cli.d.cts

@@ -0,0 +1 @@
+export { };

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/cli.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+import { n as runMain } from "./runner--Zn4KN9B.js";
+import { h as arg } from "./schema-extractor-Dqe7_kyQ.js";
+import { S as defineCommand, p as generateBundledCompletionWorker } from "./completion-DHnVx9Zk.js";
+import "./index.js";
+import { z } from "zod";
+
+//#region src/cli.ts
+runMain(defineCommand({
+	name: "politty",
+	description: "politty development utilities",
+	subCommands: { "generate-worker": defineCommand({
+		name: "generate-worker",
+		description: "Generate and verify a bundled shell completion worker",
+		args: z.object({
+			bin: arg(z.string(), {
+				description: "CLI binary or built JS entry file to invoke",
+				placeholder: "PATH"
+			}),
+			program: arg(z.string(), {
+				description: "Program name embedded in worker metadata",
+				placeholder: "NAME"
+			}),
+			shell: arg(z.enum([
+				"bash",
+				"zsh",
+				"fish"
+			]), {
+				description: "Shell worker to generate",
+				placeholder: "SHELL"
+			}),
+			out: arg(z.string().optional(), {
+				description: "Output worker path (defaults to dist/completion/<shell>-worker.<ext>)",
+				placeholder: "PATH"
+			}),
+			verify: arg(z.boolean().default(false), { description: "Verify __completion-worker-path resolves to the generated worker" })
+		}),
+		async run(args) {
+			await generateBundledCompletionWorker({
+				bin: args.bin,
+				programName: args.program,
+				shell: args.shell,
+				...args.out !== void 0 && { outputPath: args.out },
+				verify: args.verify
+			});
+		}
+	}) }
+})).catch((error) => {
+	console.error(error instanceof Error ? error.message : String(error));
+	process.exit(1);
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport { z } from \"zod\";\nimport { arg } from \"./core/arg-registry.js\";\nimport { defineCommand } from \"./core/command.js\";\nimport { runMain } from \"./core/runner.js\";\nimport { generateBundledCompletionWorker } from \"./index.js\";\n\nconst generateWorkerArgsSchema = z.object({\n  bin: arg(z.string(), {\n    description: \"CLI binary or built JS entry file to invoke\",\n    placeholder: \"PATH\",\n  }),\n  program: arg(z.string(), {\n    description: \"Program name embedded in worker metadata\",\n    placeholder: \"NAME\",\n  }),\n  shell: arg(z.enum([\"bash\", \"zsh\", \"fish\"]), {\n    description: \"Shell worker to generate\",\n    placeholder: \"SHELL\",\n  }),\n  out: arg(z.string().optional(), {\n    description: \"Output worker path (defaults to dist/completion/<shell>-worker.<ext>)\",\n    placeholder: \"PATH\",\n  }),\n  verify: arg(z.boolean().default(false), {\n    description: \"Verify __completion-worker-path resolves to the generated worker\",\n  }),\n});\n\ntype GenerateWorkerArgs = z.infer<typeof generateWorkerArgsSchema>;\n\nconst generateWorkerCommand = defineCommand({\n  name: \"generate-worker\",\n  description: \"Generate and verify a bundled shell completion worker\",\n  args: generateWorkerArgsSchema,\n  async run(args: GenerateWorkerArgs) {\n    await generateBundledCompletionWorker({\n      bin: args.bin,\n      programName: args.program,\n      shell: args.shell,\n      ...(args.out !== undefined && { outputPath: args.out }),\n      verify: args.verify,\n    });\n  },\n});\n\nconst cli = defineCommand({\n  name: \"politty\",\n  description: \"politty development utilities\",\n  subCommands: {\n    \"generate-worker\": generateWorkerCommand,\n  },\n});\n\nrunMain(cli).catch((error: unknown) => {\n  console.error(error instanceof Error ? error.message : String(error));\n  process.exit(1);\n});\n"],"mappings":";;;;;;;;AAuDA,QARY,cAAc;CACxB,MAAM;CACN,aAAa;CACb,aAAa,EACX,mBAnB0B,cAAc;EAC1C,MAAM;EACN,aAAa;EACb,MA3B+B,EAAE,OAAO;GACxC,KAAK,IAAI,EAAE,OAAO,GAAG;IACnB,aAAa;IACb,aAAa;GACf,CAAC;GACD,SAAS,IAAI,EAAE,OAAO,GAAG;IACvB,aAAa;IACb,aAAa;GACf,CAAC;GACD,OAAO,IAAI,EAAE,KAAK;IAAC;IAAQ;IAAO;GAAM,CAAC,GAAG;IAC1C,aAAa;IACb,aAAa;GACf,CAAC;GACD,KAAK,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,GAAG;IAC9B,aAAa;IACb,aAAa;GACf,CAAC;GACD,QAAQ,IAAI,EAAE,QAAQ,CAAC,CAAC,QAAQ,KAAK,GAAG,EACtC,aAAa,mEACf,CAAC;EACH,CAO+B;EAC7B,MAAM,IAAI,MAA0B;GAClC,MAAM,gCAAgC;IACpC,KAAK,KAAK;IACV,aAAa,KAAK;IAClB,OAAO,KAAK;IACZ,GAAI,KAAK,QAAQ,UAAa,EAAE,YAAY,KAAK,IAAI;IACrD,QAAQ,KAAK;GACf,CAAC;EACH;CACF,CAM2C,EACzC;AACF,CAEU,CAAC,CAAC,CAAC,OAAO,UAAmB;CACrC,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;CACpE,QAAQ,KAAK,CAAC;AAChB,CAAC"}

package/dist/completion/index.cjs

@@ -1,18 +1,23 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_completion = require('../completion-Cqs1Ja7C.cjs');
+const require_completion = require('../completion-CLHO3Xaz.cjs');
 
 exports.CompletionDirective = require_completion.CompletionDirective;
+exports.bundledWorkerShellExtension = require_completion.bundledWorkerShellExtension;
 exports.createCompletionCommand = require_completion.createCompletionCommand;
+exports.createCompletionWorkerPathCommand = require_completion.createCompletionWorkerPathCommand;
 exports.createDynamicCompleteCommand = require_completion.createDynamicCompleteCommand;
 exports.createRefreshCompletionCommand = require_completion.createRefreshCompletionCommand;
+exports.defaultBundledWorkerOutputPath = require_completion.defaultBundledWorkerOutputPath;
 exports.detectShell = require_completion.detectShell;
 exports.extractCompletionData = require_completion.extractCompletionData;
 exports.extractPositionals = require_completion.extractPositionals;
 exports.formatForShell = require_completion.formatForShell;
+exports.generateBundledCompletionWorker = require_completion.generateBundledCompletionWorker;
 exports.generateCandidates = require_completion.generateCandidates;
 exports.generateCompletion = require_completion.generateCompletion;
 exports.getSupportedShells = require_completion.getSupportedShells;
 exports.hasCompleteCommand = require_completion.hasCompleteCommand;
 exports.parseCompletionContext = require_completion.parseCompletionContext;
 exports.resolveValueCompletion = require_completion.resolveValueCompletion;
+exports.validateBundledWorkerFile = require_completion.validateBundledWorkerFile;
 exports.withCompletionCommand = require_completion.withCompletionCommand;

package/dist/completion/index.d.cts

@@ -1,3 +1,3 @@
-import { f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, m as DynamicCompletionContext, p as DynamicCompletionCandidate } from "../arg-registry--NRaNFJM.cjs";
-import { C as CompletableOption, D as CompletionOptions, E as CompletionGenerator, O as CompletionResult, S as parseCompletionContext, T as CompletionData, _ as CompletionCandidate, a as generateCompletion, b as CompletionContext, c as ValueCompletionField, d as extractPositionals, f as ShellFormatOptions, g as CandidateResult, h as hasCompleteCommand, i as detectShell, k as ShellType, l as resolveValueCompletion, m as createDynamicCompleteCommand, n as createCompletionCommand, o as getSupportedShells, p as formatForShell, r as createRefreshCompletionCommand, s as withCompletionCommand, t as WithCompletionOptions, u as extractCompletionData, v as CompletionDirective, w as CompletableSubcommand, x as CompletionType, y as generateCandidates } from "../index-DJp8k5Bq.cjs";
-export { type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionDirectiveMask, type CompletionGenerator, type CompletionOptions, type CompletionResult, type CompletionType, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type ShellFormatOptions, type ShellType, type ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };
+import { f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, m as DynamicCompletionContext, p as DynamicCompletionCandidate } from "../arg-registry-BoqVZRFO.cjs";
+import { A as BundledWorkerOptions, C as CandidateResult, D as CompletionContext, E as generateCandidates, F as CompletionMode, I as CompletionOptions, L as CompletionResult, M as CompletableSubcommand, N as CompletionData, O as CompletionType, P as CompletionGenerator, R as ShellType, S as hasCompleteCommand, T as CompletionDirective, _ as extractCompletionData, a as detectShell, b as formatForShell, c as withCompletionCommand, d as GenerateBundledCompletionWorkerOptions, f as GenerateBundledCompletionWorkerResult, g as validateBundledWorkerFile, h as generateBundledCompletionWorker, i as createRefreshCompletionCommand, j as CompletableOption, k as parseCompletionContext, l as ValueCompletionField, m as defaultBundledWorkerOutputPath, n as createCompletionCommand, o as generateCompletion, p as bundledWorkerShellExtension, r as createCompletionWorkerPathCommand, s as getSupportedShells, t as WithCompletionOptions, u as resolveValueCompletion, v as extractPositionals, w as CompletionCandidate, x as createDynamicCompleteCommand, y as ShellFormatOptions } from "../index-Ct48_myg.cjs";
+export { type BundledWorkerOptions, type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionDirectiveMask, type CompletionGenerator, type CompletionMode, type CompletionOptions, type CompletionResult, type CompletionType, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type GenerateBundledCompletionWorkerOptions, type GenerateBundledCompletionWorkerResult, type ShellFormatOptions, type ShellType, type ValueCompletionField, WithCompletionOptions, bundledWorkerShellExtension, createCompletionCommand, createCompletionWorkerPathCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, defaultBundledWorkerOutputPath, detectShell, extractCompletionData, extractPositionals, formatForShell, generateBundledCompletionWorker, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, validateBundledWorkerFile, withCompletionCommand };

package/dist/completion/index.d.ts

@@ -1,3 +1,3 @@
-import { f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, m as DynamicCompletionContext, p as DynamicCompletionCandidate } from "../arg-registry-6E0WHOh_.js";
-import { C as CompletableOption, D as CompletionOptions, E as CompletionGenerator, O as CompletionResult, S as parseCompletionContext, T as CompletionData, _ as CompletionCandidate, a as generateCompletion, b as CompletionContext, c as ValueCompletionField, d as extractPositionals, f as ShellFormatOptions, g as CandidateResult, h as hasCompleteCommand, i as detectShell, k as ShellType, l as resolveValueCompletion, m as createDynamicCompleteCommand, n as createCompletionCommand, o as getSupportedShells, p as formatForShell, r as createRefreshCompletionCommand, s as withCompletionCommand, t as WithCompletionOptions, u as extractCompletionData, v as CompletionDirective, w as CompletableSubcommand, x as CompletionType, y as generateCandidates } from "../index-DBMfKZ34.js";
-export { type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionDirectiveMask, type CompletionGenerator, type CompletionOptions, type CompletionResult, type CompletionType, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type ShellFormatOptions, type ShellType, type ValueCompletionField, WithCompletionOptions, createCompletionCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };
+import { f as CompletionDirectiveMask, g as DynamicCompletionResult, h as DynamicCompletionResolver, m as DynamicCompletionContext, p as DynamicCompletionCandidate } from "../arg-registry-BoqVZRFO.js";
+import { A as BundledWorkerOptions, C as CandidateResult, D as CompletionContext, E as generateCandidates, F as CompletionMode, I as CompletionOptions, L as CompletionResult, M as CompletableSubcommand, N as CompletionData, O as CompletionType, P as CompletionGenerator, R as ShellType, S as hasCompleteCommand, T as CompletionDirective, _ as extractCompletionData, a as detectShell, b as formatForShell, c as withCompletionCommand, d as GenerateBundledCompletionWorkerOptions, f as GenerateBundledCompletionWorkerResult, g as validateBundledWorkerFile, h as generateBundledCompletionWorker, i as createRefreshCompletionCommand, j as CompletableOption, k as parseCompletionContext, l as ValueCompletionField, m as defaultBundledWorkerOutputPath, n as createCompletionCommand, o as generateCompletion, p as bundledWorkerShellExtension, r as createCompletionWorkerPathCommand, s as getSupportedShells, t as WithCompletionOptions, u as resolveValueCompletion, v as extractPositionals, w as CompletionCandidate, x as createDynamicCompleteCommand, y as ShellFormatOptions } from "../index-Csk1VFou.js";
+export { type BundledWorkerOptions, type CandidateResult, type CompletableOption, type CompletableSubcommand, type CompletionCandidate, type CompletionContext, type CompletionData, CompletionDirective, type CompletionDirectiveMask, type CompletionGenerator, type CompletionMode, type CompletionOptions, type CompletionResult, type CompletionType, type DynamicCompletionCandidate, type DynamicCompletionContext, type DynamicCompletionResolver, type DynamicCompletionResult, type GenerateBundledCompletionWorkerOptions, type GenerateBundledCompletionWorkerResult, type ShellFormatOptions, type ShellType, type ValueCompletionField, WithCompletionOptions, bundledWorkerShellExtension, createCompletionCommand, createCompletionWorkerPathCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, defaultBundledWorkerOutputPath, detectShell, extractCompletionData, extractPositionals, formatForShell, generateBundledCompletionWorker, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, validateBundledWorkerFile, withCompletionCommand };

package/dist/completion/index.js

@@ -1,3 +1,3 @@
-import { a as getSupportedShells, c as hasCompleteCommand, d as extractPositionals, f as CompletionDirective, h as resolveValueCompletion, i as generateCompletion, l as formatForShell, m as parseCompletionContext, n as createRefreshCompletionCommand, o as withCompletionCommand, p as generateCandidates, r as detectShell, s as createDynamicCompleteCommand, t as createCompletionCommand, u as extractCompletionData } from "../completion-BA5JMvVG.js";
+import { _ as CompletionDirective, a as generateCompletion, b as resolveValueCompletion, c as createDynamicCompleteCommand, d as bundledWorkerShellExtension, f as defaultBundledWorkerOutputPath, g as extractPositionals, h as extractCompletionData, i as detectShell, l as hasCompleteCommand, m as validateBundledWorkerFile, n as createCompletionWorkerPathCommand, o as getSupportedShells, p as generateBundledCompletionWorker, r as createRefreshCompletionCommand, s as withCompletionCommand, t as createCompletionCommand, u as formatForShell, v as generateCandidates, y as parseCompletionContext } from "../completion-DHnVx9Zk.js";
 
-export { CompletionDirective, createCompletionCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, detectShell, extractCompletionData, extractPositionals, formatForShell, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, withCompletionCommand };
+export { CompletionDirective, bundledWorkerShellExtension, createCompletionCommand, createCompletionWorkerPathCommand, createDynamicCompleteCommand, createRefreshCompletionCommand, defaultBundledWorkerOutputPath, detectShell, extractCompletionData, extractPositionals, formatForShell, generateBundledCompletionWorker, generateCandidates, generateCompletion, getSupportedShells, hasCompleteCommand, parseCompletionContext, resolveValueCompletion, validateBundledWorkerFile, withCompletionCommand };