@stonyx/utils 0.2.3-alpha.0 → 0.2.3-alpha.10

package/README.md

@@ -25,10 +25,13 @@ Utilities module for the Stonyx Framework. Provides helpers for files, objects,
 |             | `getOrSet`              | Get or set value in a Map.                               |
 | **String**  | `kebabCaseToCamelCase`  | Convert kebab-case to camelCase.                         |
 |             | `kebabCaseToPascalCase` | Convert kebab-case to PascalCase.                        |
+|             | `camelCaseToKebabCase`  | Convert camelCase to kebab-case.                         |
 |             | `generateRandomString`  | Generate a random alphanumeric string.                   |
 |             | `pluralize`             | Return plural form of English nouns.                     |
 | **Date**    | `getTimestamp`          | Return current UNIX timestamp in seconds.                |
 | **Promise** | `sleep`                 | Async delay for a given number of seconds.               |
+| **Prompt**  | `confirm`               | Prompt user for y/N confirmation.                        |
+|             | `prompt`                | Prompt user for free-text input.                         |
 
 ---
 
@@ -41,6 +44,7 @@ Utilities module for the Stonyx Framework. Provides helpers for files, objects,
 * [String Utils](#string-utils)
 * [Date Utils](#date-utils)
 * [Promise Utils](#promise-utils)
+* [Prompt Utils](#prompt-utils)
 * [License](#license)
 
 ---
@@ -107,6 +111,9 @@ Dynamically imports all `.js` files in a directory and calls `callback(exports,
 |      `fullExport`     | Boolean |  false  | If true, callback receives all exports, not just default. |
 |       `rawName`       | Boolean |  false  | If true, the file name is not converted to camelCase.     |
 | `ignoreAccessFailure` | Boolean |  false  | If true, directory access errors are ignored.             |
+|      `recursive`      | Boolean |  false  | If true, recurse into subdirectories.                     |
+|   `recursiveNaming`   | Boolean |  false  | If true, prefix imported names with their directory path. |
+|      `namePrefix`     | String  |   `""`  | Manual prefix prepended to each imported name.            |
 
 Example:
 
@@ -221,6 +228,35 @@ await sleep(2); // waits 2 seconds
 
 ---
 
+## Prompt Utils
+
+Interactive CLI prompt helpers built on Node's `readline`.
+
+### Functions
+
+#### `confirm(question, options={})`
+
+Prompts the user with `(y/N)` and resolves to `true` only if the answer is `"y"` (case-insensitive).
+
+* `options.input` — Readable stream (default: `process.stdin`).
+* `options.output` — Writable stream (default: `process.stdout`).
+
+#### `prompt(question, options={})`
+
+Prompts the user with a question and resolves to the trimmed input string.
+
+* `options.input` — Readable stream (default: `process.stdin`).
+* `options.output` — Writable stream (default: `process.stdout`).
+
+```js
+import { confirm, prompt } from '@stonyx/utils/prompt';
+
+const name = await prompt('What is your name?');
+const ok = await confirm('Proceed?');
+```
+
+---
+
 ## License
 
 Apache — do what you want, just keep attribution.

package/package.json

@@ -3,18 +3,23 @@
   "keywords": [
     "stonyx-module"
   ],
-  "version": "0.2.3-alpha.0",
+  "version": "0.2.3-alpha.10",
   "description": "Utils module for Stonyx Framework",
   "repository": {
     "type": "git",
-    "url": "https://github.com/abofs/stonyx-utils"
+    "url": "https://github.com/abofs/stonyx-utils.git"
   },
   "type": "module",
+  "files": [
+    "src",
+    "README.md"
+  ],
   "exports": {
     "./date": "./src/date.js",
     "./object": "./src/object.js",
     "./file": "./src/file.js",
     "./promise": "./src/promise.js",
+    "./prompt": "./src/prompt.js",
     "./string": "./src/string.js"
   },
   "publishConfig": {

package/src/object.js

@@ -44,7 +44,7 @@ export function get(obj, path) {
   if (typeof path !== 'string') return console.error('The path provided to get must be a string.');
 
   for (const key of path.split('.')) {
-    if (obj[key] === undefined) return null;
+    if (obj[key] === undefined) return;
 
     obj = obj[key];
   }

package/src/prompt.js

@@ -0,0 +1,29 @@
+import { createInterface } from 'readline';
+
+export function confirm(question, { input, output } = {}) {
+  const rl = createInterface({
+    input: input ?? process.stdin,
+    output: output ?? process.stdout,
+  });
+
+  return new Promise(resolve => {
+    rl.question(`${question} (y/N) `, answer => {
+      rl.close();
+      resolve(answer.trim().toLowerCase() === 'y');
+    });
+  });
+}
+
+export function prompt(question, { input, output } = {}) {
+  const rl = createInterface({
+    input: input ?? process.stdin,
+    output: output ?? process.stdout,
+  });
+
+  return new Promise(resolve => {
+    rl.question(`${question} `, answer => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}

package/src/string.js

@@ -23,6 +23,10 @@ export function kebabCaseToPascalCase(str) {
   return kebabToCase(str, true);
 }
 
+export function camelCaseToKebabCase(str) {
+  return str.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+}
+
 export function generateRandomString(length=8) {
   const characters = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
   return Array(length).fill('').map(() => characters.charAt(Math.floor(Math.random() * characters.length))).join('');

package/.github/workflows/ci.yml

@@ -1,36 +0,0 @@
-name: CI
-
-on:
-  pull_request:
-    branches:
-      - dev
-      - main
-
-concurrency:
-  group: ci-${{ github.head_ref || github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
-
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 24.13.0
-          cache: 'pnpm'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Run tests
-        run: pnpm test

package/.github/workflows/publish.yml

@@ -1,143 +0,0 @@
-name: Publish to NPM
-
-on:
-  # Manual trigger (kept for flexibility)
-  workflow_dispatch:
-    inputs:
-      version-type:
-        description: 'Version type'
-        required: true
-        type: choice
-        options:
-          - alpha
-          - patch
-          - minor
-          - major
-      custom-version:
-        description: 'Custom version (optional, overrides version-type)'
-        required: false
-        type: string
-
-  # Auto-publish alpha on PR
-  pull_request:
-    types: [opened, synchronize, reopened]
-    branches: [main, dev]
-
-  # Auto-publish stable on merge to main
-  push:
-    branches: [main]
-
-permissions:
-  contents: write
-  id-token: write  # Required for npm provenance
-  pull-requests: write  # For PR comments
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v3
-        with:
-          fetch-depth: 0
-          # For PR events, check out the PR branch
-          ref: ${{ github.event_name == 'pull_request' && github.head_ref || github.ref }}
-
-      - name: Setup pnpm
-        uses: pnpm/action-setup@v4
-        with:
-          version: 9
-
-      - name: Set up Node.js
-        uses: actions/setup-node@v3
-        with:
-          node-version: 24.13.0
-          cache: 'pnpm'
-          registry-url: 'https://registry.npmjs.org'
-
-      - name: Install dependencies
-        run: pnpm install --frozen-lockfile
-
-      - name: Run tests
-        run: pnpm test
-
-      - name: Configure git
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-
-      # Determine version type based on trigger
-      - name: Determine version bump type
-        id: version-type
-        run: |
-          if [ "${{ github.event_name }}" = "pull_request" ]; then
-            echo "type=alpha" >> $GITHUB_OUTPUT
-          elif [ "${{ github.event_name }}" = "push" ]; then
-            echo "type=patch" >> $GITHUB_OUTPUT
-          elif [ "${{ github.event.inputs.custom-version }}" != "" ]; then
-            echo "type=custom" >> $GITHUB_OUTPUT
-          else
-            echo "type=${{ github.event.inputs.version-type }}" >> $GITHUB_OUTPUT
-          fi
-
-      # Version bumping
-      - name: Bump version (custom)
-        if: steps.version-type.outputs.type == 'custom'
-        run: pnpm version ${{ github.event.inputs.custom-version }} --no-git-tag-version
-
-      - name: Bump version (alpha)
-        if: steps.version-type.outputs.type == 'alpha'
-        run: pnpm version prerelease --preid=alpha --no-git-tag-version
-
-      - name: Bump version (patch/minor/major)
-        if: steps.version-type.outputs.type == 'patch' || steps.version-type.outputs.type == 'minor' || steps.version-type.outputs.type == 'major'
-        run: pnpm version ${{ steps.version-type.outputs.type }} --no-git-tag-version
-
-      - name: Get package version
-        id: package-version
-        run: echo "version=$(node -p "require('./package.json').version")" >> $GITHUB_OUTPUT
-
-      # Publishing
-      - name: Publish to NPM (alpha)
-        if: contains(steps.package-version.outputs.version, 'alpha')
-        run: pnpm publish --tag alpha --access public --no-git-checks
-
-      - name: Publish to NPM (stable)
-        if: "!contains(steps.package-version.outputs.version, 'alpha')"
-        run: pnpm publish --access public
-
-      # Only commit and tag for stable releases (push to main or manual stable)
-      - name: Commit version bump and create tag
-        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && !contains(steps.package-version.outputs.version, 'alpha'))
-        run: |
-          git add package.json
-          git commit -m "chore: release v${{ steps.package-version.outputs.version }}"
-          git tag v${{ steps.package-version.outputs.version }}
-          git push origin main --tags
-
-      - name: Create GitHub Release
-        if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && !contains(steps.package-version.outputs.version, 'alpha'))
-        uses: actions/create-release@v1
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        with:
-          tag_name: v${{ steps.package-version.outputs.version }}
-          release_name: v${{ steps.package-version.outputs.version }}
-          draft: false
-          prerelease: false
-
-      # Add PR comment with alpha version info
-      - name: Comment on PR with alpha version
-        if: github.event_name == 'pull_request'
-        uses: actions/github-script@v6
-        with:
-          script: |
-            const version = '${{ steps.package-version.outputs.version }}';
-            const packageName = require('./package.json').name;
-            github.rest.issues.createComment({
-              issue_number: context.issue.number,
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              body: `## 🚀 Alpha Version Published\n\n**Version:** \`${version}\`\n\n**Install:**\n\`\`\`bash\npnpm add ${packageName}@${version}\n# or\npnpm add ${packageName}@alpha  # latest alpha\n\`\`\`\n\nThis alpha version is now available for testing!`
-            });