@stonyx/utils 0.2.3-alpha.3 → 0.2.3-alpha.4

package/.claude/project-structure.md

@@ -1,5 +1,25 @@
 # Project Structure
 
+## Index
+
+- [Overview](#overview)
+- [Tech Stack](#tech-stack)
+- [File Structure](#file-structure)
+- [Package Exports](#package-exports)
+- [Module Documentation](#module-documentation)
+  - [date.js](#srcdate.js)
+  - [file.js](#srcfile.js)
+  - [object.js](#srcobject.js)
+  - [plurarize.js](#srcplurarize.js)
+  - [promise.js](#srcpromise.js)
+  - [prompt.js](#srcprompt.js)
+  - [string.js](#srcstring.js)
+- [Dependencies](#dependencies)
+- [Test Patterns](#test-patterns)
+- [CI/CD](#cicd)
+
+---
+
 ## Overview
 
 `@stonyx/utils` is a utilities module for the Stonyx Framework. It provides pure JavaScript helper functions for file system operations, object manipulation, string transformations, date handling, promises, and interactive CLI prompts.
@@ -26,7 +46,6 @@
 stonyx-utils/
   .claude/                        # Claude project memory
     project-structure.md          # This file
-    improvements.md               # Known issues and improvement ideas
   .github/
     workflows/
       ci.yml                      # CI on PRs to dev/main (reusable workflow)

package/.github/workflows/publish.yml

@@ -1,6 +1,8 @@
 name: Publish to NPM
 
 on:
+  repository_dispatch:
+    types: [cascade-publish]
   workflow_dispatch:
     inputs:
       version-type:
@@ -17,10 +19,14 @@ on:
         type: string
   pull_request:
     types: [opened, synchronize, reopened]
-    branches: [main, dev]
+    branches: [main]
   push:
     branches: [main]
 
+concurrency:
+  group: ${{ github.event_name == 'repository_dispatch' && 'cascade-update' || format('publish-{0}', github.ref) }}
+  cancel-in-progress: false
+
 permissions:
   contents: write
   id-token: write
@@ -28,8 +34,18 @@ permissions:
 
 jobs:
   publish:
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
     uses: abofs/stonyx-workflows/.github/workflows/npm-publish.yml@main
     with:
       version-type: ${{ github.event.inputs.version-type }}
       custom-version: ${{ github.event.inputs.custom-version }}
+      cascade-source: ${{ github.event.client_payload.source_package || '' }}
+    secrets: inherit
+
+  cascade:
+    needs: publish
+    uses: abofs/stonyx-workflows/.github/workflows/cascade.yml@main
+    with:
+      package-name: ${{ needs.publish.outputs.package-name }}
+      published-version: ${{ needs.publish.outputs.published-version }}
     secrets: inherit

package/package.json

@@ -3,7 +3,7 @@
   "keywords": [
     "stonyx-module"
   ],
-  "version": "0.2.3-alpha.3",
+  "version": "0.2.3-alpha.4",
   "description": "Utils module for Stonyx Framework",
   "repository": {
     "type": "git",

package/.claude/improvements.md

@@ -1,73 +0,0 @@
-# Improvements
-
-Known code issues and suggested fixes for `@stonyx/utils`.
-
----
-
-## 1. Filename typo: `plurarize.js` should be `pluralize.js`
-
-**Files affected:**
-- `src/plurarize.js` (source)
-- `test/unit/string/plurarize-test.js` (test)
-- `src/string.js` (re-export references `./plurarize.js`)
-
-**Details:**
-The filename `plurarize.js` is missing the second "l" — it should be `pluralize.js`. The typo is propagated to the test file (`plurarize-test.js`) and the re-export in `src/string.js`:
-
-```js
-// src/string.js, line 35
-export { default as pluralize } from './plurarize.js';
-```
-
-**Suggested fix:**
-Rename `src/plurarize.js` to `src/pluralize.js`, rename `test/unit/string/plurarize-test.js` to `test/unit/string/pluralize-test.js`, and update the import path in `src/string.js`.
-
----
-
-## 2. Self-referential package imports in `src/file.js`
-
-**File:** `src/file.js`
-
-**Details:**
-`src/file.js` imports from its own package using the published package specifier:
-
-```js
-// src/file.js, lines 1-3
-import { getTimestamp } from '@stonyx/utils/date';
-import { kebabCaseToCamelCase } from '@stonyx/utils/string';
-import { objToJson } from '@stonyx/utils/object';
-```
-
-These self-referential imports resolve correctly in local development (Node respects the `exports` map for the current package) but are fragile for a published package — they rely on Node's self-referencing behavior, which can break in certain bundler or monorepo resolution scenarios.
-
-**Suggested fix:**
-Use relative imports instead:
-
-```js
-import { getTimestamp } from './date.js';
-import { kebabCaseToCamelCase } from './string.js';
-import { objToJson } from './object.js';
-```
-
----
-
-## 3. `get()` uses `console.error` instead of throwing
-
-**File:** `src/object.js`, lines 42-44
-
-**Details:**
-The `get()` function uses `console.error` and returns `undefined` for invalid arguments:
-
-```js
-export function get(obj, path) {
-  if (arguments.length !== 2) return console.error('Get must be called with two arguments; an object and a property key.');
-  if (!obj) return console.error(`Cannot call get with '${path}' on an undefined object.`);
-  if (typeof path !== 'string') return console.error('The path provided to get must be a string.');
-  ...
-}
-```
-
-This is inconsistent with other functions in the same module — `mergeObject` throws `new Error('Cannot merge arrays.')` and `getOrSet` throws `new Error('First argument to getOrSet must be a Map.')`. The `console.error` approach silently returns `undefined` (the return value of `console.error`), making bugs harder to catch in calling code.
-
-**Suggested fix:**
-Replace `console.error` calls with `throw new Error(...)` to match the error-handling pattern used by `mergeObject` and `getOrSet`. This would also require updating the tests in `test/unit/object/get-test.js` to use `assert.throws` instead of spying on `console.error`.