@pokit/prompter-clack 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daniel Grant
+
+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

@@ -0,0 +1,57 @@
+# @pokit/prompter-clack
+
+Interactive prompts adapter for pok using [Clack](https://github.com/natemoo-re/clack).
+
+## Installation
+
+```bash
+bun add @pokit/prompter-clack
+```
+
+## Usage
+
+```typescript
+import { run } from '@pokit/core';
+import { createPrompter } from '@pokit/prompter-clack';
+
+await run(args, {
+  prompter: createPrompter(),
+  // ...
+});
+```
+
+## Features
+
+- Text input prompts
+- Password/secret input
+- Confirmation prompts
+- Select menus (single choice)
+- Multi-select menus
+
+## What It Does
+
+When a command defines required context fields that aren't provided via flags, pok uses the prompter to interactively request them:
+
+```typescript
+export const command = defineCommand({
+  context: {
+    env: {
+      from: 'flag',
+      schema: z.enum(['dev', 'staging', 'prod']),
+      description: 'Target environment',
+    },
+  },
+  run: async (r, ctx) => {
+    // If --env not provided, prompter asks user to select
+  },
+});
+```
+
+```bash
+$ mycli deploy
+? Select environment > dev / staging / prod
+```
+
+## Documentation
+
+See the [full documentation](https://github.com/openpok/pok/blob/main/docs/packages/prompter-clack.md).

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @pokit/prompter-clack
+ *
+ * Clack-based implementation of the Prompter interface.
+ * Provides interactive prompts using @clack/prompts.
+ */
+export { createPrompter } from './prompter';
+//# 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;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+/**
+ * @pokit/prompter-clack
+ *
+ * Clack-based implementation of the Prompter interface.
+ * Provides interactive prompts using @clack/prompts.
+ */
+export { createPrompter } from './prompter';

package/dist/prompter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Clack Prompter Implementation
+ *
+ * Implements the Prompter interface using @clack/prompts.
+ */
+import type { Prompter } from '@pokit/core';
+/**
+ * Create a Prompter using @clack/prompts
+ */
+export declare function createPrompter(): Prompter;
+//# sourceMappingURL=prompter.d.ts.map

package/dist/prompter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompter.d.ts","sourceRoot":"","sources":["../src/prompter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,QAAQ,EAKT,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CA2DzC"}

package/dist/prompter.js

@@ -0,0 +1,58 @@
+/**
+ * Clack Prompter Implementation
+ *
+ * Implements the Prompter interface using @clack/prompts.
+ */
+import * as p from '@clack/prompts';
+/**
+ * Create a Prompter using @clack/prompts
+ */
+export function createPrompter() {
+    return {
+        async select(options) {
+            const result = await p.select({
+                message: options.message,
+                options: options.options,
+                initialValue: options.initialValue,
+            });
+            if (p.isCancel(result)) {
+                process.exit(0);
+            }
+            return result;
+        },
+        async multiselect(options) {
+            const result = await p.multiselect({
+                message: options.message,
+                options: options.options,
+                initialValues: options.initialValues,
+                required: options.required,
+            });
+            if (p.isCancel(result)) {
+                process.exit(0);
+            }
+            return result;
+        },
+        async confirm(options) {
+            const result = await p.confirm({
+                message: options.message,
+                initialValue: options.initialValue,
+            });
+            if (p.isCancel(result)) {
+                process.exit(0);
+            }
+            return result;
+        },
+        async text(options) {
+            const result = await p.text({
+                message: options.message,
+                placeholder: options.placeholder,
+                initialValue: options.initialValue,
+                validate: options.validate,
+            });
+            if (p.isCancel(result)) {
+                process.exit(0);
+            }
+            return result;
+        },
+    };
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@pokit/prompter-clack",
+  "version": "0.0.1",
+  "description": "Clack-based prompter adapter for pok CLI applications",
+  "keywords": [
+    "cli",
+    "command-line",
+    "typescript",
+    "bun",
+    "terminal",
+    "pok",
+    "pokjs",
+    "clack",
+    "prompts",
+    "interactive",
+    "input"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/notation-dev/openpok.git",
+    "directory": "packages/prompter-clack"
+  },
+  "homepage": "https://github.com/notation-dev/openpok#readme",
+  "bugs": {
+    "url": "https://github.com/notation-dev/openpok/issues"
+  },
+  "main": "./src/index.ts",
+  "module": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "@pokit/core": "0.0.1"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * @pokit/prompter-clack
+ *
+ * Clack-based implementation of the Prompter interface.
+ * Provides interactive prompts using @clack/prompts.
+ */
+
+export { createPrompter } from './prompter';