@plasius/hexagons 1.0.6 → 1.0.8

package/CHANGELOG.md

@@ -8,6 +8,35 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 
 ## [Unreleased]
 
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [1.0.8] - 2026-03-01
+
+- **Added**
+  - (placeholder)
+
+- **Changed**
+  - (placeholder)
+
+- **Fixed**
+  - Enforced CommonJS runtime compatibility for dual-build output by generating and validating `dist-cjs/package.json` (`type: commonjs`) during build and package verification.
+  - (placeholder)
+
+- **Security**
+  - (placeholder)
+
+## [1.0.7] - 2026-03-01
+
 - **Added**
   - (placeholder)
 
@@ -90,7 +119,7 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 
 ---
 
-[Unreleased]: https://github.com/Plasius-LTD/hexagons/compare/v1.0.6...HEAD
+[Unreleased]: https://github.com/Plasius-LTD/hexagons/compare/v1.0.8...HEAD
 
 ## [1.0.0] - 2026-02-11
 
@@ -109,3 +138,5 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
 [1.0.4]: https://github.com/Plasius-LTD/hexagons/releases/tag/v1.0.4
 [1.0.5]: https://github.com/Plasius-LTD/hexagons/releases/tag/v1.0.5
 [1.0.6]: https://github.com/Plasius-LTD/hexagons/releases/tag/v1.0.6
+[1.0.7]: https://github.com/Plasius-LTD/hexagons/releases/tag/v1.0.7
+[1.0.8]: https://github.com/Plasius-LTD/hexagons/releases/tag/v1.0.8

package/README.md

@@ -19,6 +19,12 @@ Primary demo surface name: **Generator**.
 npm install @plasius/hexagons
 ```
 
+## Module formats
+
+This package publishes dual ESM and CJS artifacts.
+When CJS output is emitted under `dist-cjs/*.js` with `type: module`, `dist-cjs/package.json` is generated with `{ "type": "commonjs" }` to ensure Node `require(...)` compatibility.
+
+
 ## Usage
 
 ```ts

package/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/docs/adrs/adr-0003-dual-esm-cjs-runtime-compatibility.md

@@ -0,0 +1,22 @@
+# ADR-0003: Dual ESM and CJS Runtime Compatibility
+
+- Date: 2026-03-01
+- Status: Accepted
+
+## Context
+
+`@plasius/hexagons` publishes dual ESM and CJS entry points. This package currently emits CJS output under `dist-cjs/*.js` while the repository root uses `type: module`. Without an explicit CommonJS boundary for `dist-cjs`, Node can interpret those files as ESM and fail at runtime for `require(...)` consumers.
+
+## Decision
+
+Keep dual output and enforce a runtime-compatible CJS boundary by:
+
+- generating `dist-cjs/package.json` with `{ "type": "commonjs" }` as part of `build:cjs`;
+- validating this metadata in `pack:check`;
+- ensuring the packed artifact includes `dist-cjs/package.json`.
+
+## Consequences
+
+- Node CommonJS consumers can reliably load `@plasius/hexagons` via `require(...)`.
+- ESM consumers remain unchanged.
+- CD publish checks fail fast if CJS runtime compatibility metadata is missing.

package/docs/adrs/index.md

@@ -2,3 +2,4 @@
 
 - [ADR-0001: Standalone @plasius/hexagons Package Scope](./adr-0001-hexagons-package-scope.md)
 - [ADR-0002: Public Repository Governance Baseline](./adr-0002-public-repo-governance.md)
+- [ADR-0003: Dual ESM and CJS Runtime Compatibility](./adr-0003-dual-esm-cjs-runtime-compatibility.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/hexagons",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "main": "./dist-cjs/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",
@@ -10,18 +10,19 @@
     "build": "tsc --build --listEmittedFiles && rsync -av --include '*/' --include '*.module.css' --exclude '*' src/ dist/ || true && npm run build:cjs",
     "test": "vitest run",
     "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
     "test:coverage": "vitest run --coverage",
     "test:coverage:watch": "vitest --coverage",
     "clean": "rimraf dist-cjs dist tsconfig.tsbuildinfo",
     "reset:clean": "rm -rf node_modules package-lock.json && npm run clean",
     "audit:ts": "tsc --noEmit --pretty",
-    "audit:eslint": "eslint \"{src,apps,packages}/**/*.{ts,tsx}\" --max-warnings=0 --ext .ts,.tsx",
+    "audit:eslint": "eslint . --max-warnings=0",
     "audit:deps": "npm ls --all --omit=optional --omit=peer > /dev/null 2>&1 || true",
-    "audit:npm": "npm audit --audit-level=moderate || true",
+    "audit:npm": "npm audit --audit-level=high --omit=dev",
     "audit:test": "vitest run --coverage",
     "audit:all": "npm-run-all -l audit:ts audit:eslint audit:deps audit:npm audit:test",
-    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo --listEmittedFiles && rsync -av --include '*/' --include '*.module.css' --exclude '*' src/ dist-cjs/ || true",
-    "lint": "eslint .",
+    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo --listEmittedFiles && rsync -av --include '*/' --include '*.module.css' --exclude '*' src/ dist-cjs/ || true && node scripts/write-cjs-package-json.cjs",
+    "lint": "eslint . --max-warnings=0",
     "prepare": "npm run build",
     "pack:check": "node scripts/verify-public-package.cjs",
     "prepublishOnly": "npm run build && npm run pack:check"
@@ -38,6 +39,7 @@
     "react": "19.1.0"
   },
   "devDependencies": {
+    "@eslint/js": "^10.0.1",
     "@testing-library/react": "^16.3.0",
     "@types/react": "^19.1.8",
     "@types/uuid": "^10.0.0",
@@ -46,6 +48,7 @@
     "@vitest/coverage-v8": "^4.0.18",
     "ajv": "^6.12.6",
     "eslint": "^10.0.1",
+    "globals": "^17.3.0",
     "npm-run-all": "^1.1.3",
     "react": "19.1.0",
     "react-dom": "19.1.0",