@hyperfrontend/questions 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## 0.1.0 - 2026-04-17
+
+### Features
+
+- new package for terminal questions

package/FUNDING.md

@@ -0,0 +1,141 @@
+# Funding & Support
+
+Thank you for considering supporting hyperfrontend! Your contributions help maintain and improve this project.
+
+## Why Support hyperfrontend?
+
+hyperfrontend is an open-source project that provides:
+
+- 🔧 Framework-agnostic micro-frontend architecture
+- 📦 Multiple packages and tools for building scalable web applications
+- 📚 Comprehensive documentation and examples
+- 🆓 Free for everyone to use
+
+Your support helps:
+
+- ⏰ Dedicate more time to development and maintenance
+- 🐛 Fix bugs and address issues faster
+- ✨ Build new features and improvements
+- 📖 Create better documentation and tutorials
+- 🌟 Keep the project sustainable long-term
+
+## How to Support
+
+### 💖 GitHub Sponsors
+
+You can sponsor the project through GitHub Sponsors:
+
+**[Sponsor @AndrewRedican on GitHub](https://github.com/sponsors/AndrewRedican)**
+
+GitHub Sponsors benefits:
+
+- Direct support to the maintainer
+- No platform fees (GitHub covers them)
+- Various sponsorship tiers available
+- Recognition in the project
+
+### 🌐 One-time Donations
+
+You can also make a one-time contribution:
+
+**[Donate via hyperfrontend.dev](https://hyperfrontend.dev/sponsor)**
+
+### 🏢 Corporate Sponsorship
+
+If your company uses hyperfrontend in production, consider becoming a corporate sponsor:
+
+- **Bronze Sponsor** ($100/month) - Logo in README
+- **Silver Sponsor** ($500/month) - Logo in README + website
+- **Gold Sponsor** ($1000/month) - Logo placement + priority support
+- **Platinum Sponsor** ($2500/month) - All benefits + consulting hours
+
+Contact: andrew.redican.mejia@gmail.com
+
+## Other Ways to Contribute
+
+Not everyone can contribute financially, and that's okay! There are many other ways to support:
+
+### 💻 Code Contributions
+
+- Submit bug fixes
+- Add new features
+- Improve documentation
+- Write tests
+
+See our [Contributing Guide](CONTRIBUTING.md) for details.
+
+### 📣 Spread the Word
+
+- ⭐ Star the repository on GitHub
+- 🐦 Share on social media
+- 📝 Write blog posts or tutorials
+- 🎤 Give talks about hyperfrontend at meetups/conferences
+
+### 🐛 Bug Reports
+
+- Report issues you encounter
+- Help triage existing issues
+- Provide detailed reproduction steps
+
+### 📚 Documentation
+
+- Improve existing docs
+- Write tutorials and guides
+- Translate documentation
+- Create video tutorials
+
+### 💬 Community Support
+
+- Answer questions in issues
+- Help other users on discussions
+- Share your use cases and examples
+
+## Current Sponsors
+
+Thank you to all our sponsors and backers! 🙏
+
+<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+
+[![All Contributors](https://img.shields.io/github/all-contributors/AndrewRedican/hyperfrontend?color=ee8449&style=flat-square)](#contributors)
+
+<!-- ALL-CONTRIBUTORS-BADGE:END -->
+
+### Corporate Sponsors
+
+<!-- Corporate sponsors will be listed here -->
+
+_Interested in corporate sponsorship? [Contact us](mailto:andrew.redican.mejia@gmail.com)_
+
+### Individual Sponsors
+
+<!-- Sponsors will be automatically listed through GitHub Sponsors -->
+
+_Become the first sponsor!_ ❤️
+
+## Recognition
+
+All sponsors and contributors are recognized in:
+
+- Project README
+- Project website (coming soon)
+- Release notes (for significant contributions)
+
+## Transparency
+
+All sponsorship funds are used for:
+
+- Development time and effort
+- Infrastructure costs (hosting, CI/CD, domains)
+- Development tools and services
+- Community building and events
+
+## Questions?
+
+If you have questions about sponsorship or funding, please contact:
+
+**Email**: andrew.redican.mejia@gmail.com
+**GitHub**: [@AndrewRedican](https://github.com/AndrewRedican)
+
+---
+
+Thank you for your support! Every contribution, whether code, documentation, or financial, helps make hyperfrontend better for everyone. 🚀

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andrew Redican
+
+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,147 @@
+# @hyperfrontend/questions
+
+<p align="center">
+  <a href="https://github.com/AndrewRedican/hyperfrontend/actions/workflows/ci-lib-questions.yml">
+    <img src="https://img.shields.io/github/actions/workflow/status/AndrewRedican/hyperfrontend/ci-lib-questions.yml?style=flat-square&logo=github&label=build" alt="Build">
+  </a>
+  <a href="https://codecov.io/gh/AndrewRedican/hyperfrontend/flags?flags%5B0%5D=questions">
+    <img src="https://codecov.io/gh/AndrewRedican/hyperfrontend/graph/badge.svg?flag=questions" alt="Coverage">
+  </a>
+  <a href="https://www.npmjs.com/package/@hyperfrontend/questions">
+    <img src="https://img.shields.io/npm/v/@hyperfrontend/questions?style=flat-square" alt="npm version">
+  </a>
+  <a href="https://bundlephobia.com/package/@hyperfrontend/questions">
+    <img src="https://img.shields.io/bundlephobia/min/%40hyperfrontend%2Fquestions?style=flat-square" alt="npm bundle size">
+  </a>
+</p>
+<p align="center">
+  <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
+  <a href="#contributors">
+    <img src="https://img.shields.io/github/all-contributors/AndrewRedican/hyperfrontend?color=ee8449&style=flat-square" alt="All Contributors">
+  </a>
+  <!-- ALL-CONTRIBUTORS-BADGE:END -->
+  <a href="https://github.com/AndrewRedican/hyperfrontend/blob/main/LICENSE.md">
+    <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License">
+  </a>
+  <a href="https://www.npmjs.com/package/@hyperfrontend/questions">
+    <img src="https://img.shields.io/npm/dm/@hyperfrontend/questions?style=flat-square" alt="npm downloads">
+  </a>
+  <a href="https://github.com/AndrewRedican/hyperfrontend">
+    <img src="https://img.shields.io/github/stars/AndrewRedican/hyperfrontend?style=flat-square" alt="GitHub stars">
+  </a>
+  <img src="https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=flat-square&logo=node.js" alt="Node Version">
+  <img src="https://img.shields.io/badge/tree%20shakeable-%E2%9C%93-success?style=flat-square" alt="Tree Shakeable">
+</p>
+
+Terminal prompting library with composable, functional API for text, select, confirm, and multiselect prompts
+
+• 👉 See [**documentation**](https://www.hyperfrontend.dev/docs/libraries/questions/)
+
+## What is @hyperfrontend/questions?
+
+A terminal prompting library built on functional programming principles. Create interactive CLI experiences with composable, type-safe prompts that return structured outcomes.
+
+### Key Features
+
+- **Pure Functions** — Every prompt is a pure function returning `Promise<PromptOutcome<T>>`, making results predictable and easily testable
+- **Composable API** — Build complex interactive flows by combining simple prompt functions
+- **Type-Safe** — Full TypeScript support with discriminated unions for prompt outcomes
+- **Zero External Dependencies** — Uses only Node.js built-ins and `@hyperfrontend` utilities
+- **Searchable Multiselect** — Type-to-filter functionality for large option lists
+
+### Architecture Highlights
+
+Each prompt follows a functional state machine pattern:
+
+- **Immutable State** — All prompt state is frozen; updates create new state objects
+- **Explicit Outcomes** — Prompts return either `{ result: 'submitted', value: T }` or `{ result: 'cancelled', value: undefined }`
+- **Terminal Abstraction** — Low-level I/O is encapsulated in a `Terminal` interface for testability
+
+## Why Use @hyperfrontend/questions?
+
+When building CLI tools, you need interactive prompts that are:
+
+1. **Predictable** — Know exactly what a prompt returns, always
+2. **Composable** — Chain prompts without callback hell
+3. **Cancellable** — Handle Ctrl+C gracefully with structured cancellation
+4. **Lightweight** — No large dependency trees for simple prompts
+
+This library provides all four while staying true to functional programming principles.
+
+## Installation
+
+```bash
+npm install @hyperfrontend/questions
+```
+
+## Quick Start
+
+```typescript
+import { text, confirm, select, multiselect, PromptResult } from '@hyperfrontend/questions'
+
+// Text input
+const nameResult = await text({
+  message: 'What is your name?',
+  validate: (value) => (value.length < 2 ? 'Name too short' : undefined),
+})
+
+if (nameResult.result === PromptResult.Submitted) {
+  console.log(`Hello, ${nameResult.value}!`)
+}
+
+// Confirmation
+const continueResult = await confirm({
+  message: 'Continue?',
+  initial: true,
+})
+
+// Single select
+const colorResult = await select({
+  message: 'Pick a color:',
+  choices: [
+    { label: 'Red', value: 'red' },
+    { label: 'Green', value: 'green', hint: 'recommended' },
+    { label: 'Blue', value: 'blue' },
+  ],
+})
+
+// Multiselect with search
+const featuresResult = await multiselect({
+  message: 'Select features:',
+  choices: [
+    { label: 'TypeScript', value: 'ts' },
+    { label: 'ESLint', value: 'eslint' },
+    { label: 'Prettier', value: 'prettier' },
+  ],
+  searchable: true,
+  min: 1,
+})
+```
+
+## API Overview
+
+| Function       | Description                                       |
+| -------------- | ------------------------------------------------- |
+| `text`         | Free-form text input with optional validation     |
+| `confirm`      | Yes/no confirmation prompt                        |
+| `select`       | Single selection from a list of choices           |
+| `multiselect`  | Multiple selections with optional search          |
+| `PromptResult` | Discriminated union: `'submitted' \| 'cancelled'` |
+
+All prompts return `Promise<PromptOutcome<T>>` where:
+
+```typescript
+type PromptOutcome<T> = { result: 'submitted'; value: T } | { result: 'cancelled'; value: undefined }
+```
+
+## Compatibility
+
+| Environment    | Supported |
+| -------------- | --------- |
+| Node.js >= 18  | ✅        |
+| TTY Terminal   | ✅        |
+| Tree Shakeable | ✅        |
+
+## License
+
+[MIT](https://github.com/AndrewRedican/hyperfrontend/blob/main/LICENSE.md)

package/SECURITY.md

@@ -0,0 +1,82 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+We take the security of hyperfrontend seriously. If you discover a security vulnerability, please help us protect our users by following responsible disclosure practices.
+
+### How to Report
+
+**Please DO NOT report security vulnerabilities through public GitHub issues.**
+
+Instead, please report security vulnerabilities directly via email to:
+
+**<andrew.redican.mejia@gmail.com>**
+
+### What to Include
+
+To help us understand and resolve the issue quickly, please include the following information in your report:
+
+- **Description**: A clear description of the vulnerability
+- **Impact**: The potential impact and severity of the issue
+- **Reproduction Steps**: Detailed steps to reproduce the vulnerability
+- **Environment**: The version of hyperfrontend affected, browser/Node.js version, operating system, etc.
+- **Proof of Concept**: If possible, include a minimal code example or proof of concept
+- **Suggested Fix**: If you have ideas on how to fix the issue (optional)
+
+### Response Timeline
+
+- **Acknowledgment**: We will acknowledge receipt of your vulnerability report within 2 business days
+- **Initial Assessment**: We will provide an initial assessment within 5 business days
+- **Patch Development**: We aim to develop and test a patch within 10 days of acknowledgment
+- **Public Disclosure**: Please allow at least **10 days** from the initial report before making the vulnerability publicly known
+
+This grace period gives us time to:
+
+- Verify and reproduce the issue
+- Develop and test a fix
+- Release a patched version
+- Notify users to update their dependencies
+
+### Coordinated Disclosure
+
+We believe in coordinated disclosure and appreciate your cooperation in:
+
+- Not exploiting the vulnerability beyond what is necessary to demonstrate it
+- Not accessing, modifying, or deleting data that doesn't belong to you
+- Allowing us reasonable time to address the issue before public disclosure
+- Making a good faith effort to avoid privacy violations, data destruction, and service interruption
+
+### Recognition
+
+Once the vulnerability is patched and publicly disclosed, we will acknowledge your responsible disclosure in:
+
+- Our release notes
+- Our security advisories (if applicable)
+- This SECURITY.md file (with your permission)
+
+Thank you for helping keep hyperfrontend and its users safe!
+
+## Security Best Practices
+
+When using hyperfrontend in your applications:
+
+1. **Keep Dependencies Updated**: Regularly update to the latest version to receive security patches
+2. **Content Security Policy**: Implement appropriate CSP headers when embedding features
+3. **Input Validation**: Validate and sanitize all data passed between features
+4. **Origin Verification**: Always verify the origin of messages in cross-frame communication
+5. **Authentication**: Implement proper authentication and authorization for sensitive features
+6. **HTTPS**: Always serve hyperfrontend features over HTTPS in production
+
+## Security Updates
+
+Security updates will be released as patch versions and documented in the [CHANGELOG](https://github.com/AndrewRedican/hyperfrontend/releases) and GitHub Security Advisories.
+
+## Supported Versions
+
+We currently provide security updates for:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.0.x   | :white_check_mark: |
+
+As the project matures, we will update this table to reflect our long-term support policy.