readmes

Author: pyramation

README.md

@@ -15,193 +15,25 @@
 
 A comprehensive collection of TypeScript utilities for working with schemas, JSON-LD, API clients, and general-purpose development tools.
 
-## Overview
-
-This monorepo provides a curated set of packages for building modern web applications, with a focus on:
-
-- **Type-Safe Schema Processing**: Convert JSON Schema and OpenAPI specifications to TypeScript
-- **JSON-LD Tooling**: Advanced JSON-LD processing with filtering and graph operations
-- **API Clients**: Lightweight HTTP clients for Node.js and browsers
-- **Developer Utilities**: String manipulation, package detection, and object handling
-
 ## Packages
 
-### Schema & TypeScript Generation
-
-#### [`schema-typescript`](./packages/schema-typescript)
-Convert JSON schemas to TypeScript interfaces automatically with full support for `$ref` and `$defs`.
-
-```bash
-npm install schema-typescript
-```
-
-**Features:**
-- JSON Schema to TypeScript conversion
-- Full support for references and definitions
-- Type-safe interface generation
-- Minimal dependencies
-
-#### [`schema-sdk`](./packages/schema-sdk)
-Generate TypeScript clients from OpenAPI specifications with comprehensive type safety.
-
-```bash
-npm install schema-sdk
-```
-
-**Features:**
-- OpenAPI Specification (Swagger) support
-- Automatic TypeScript client generation
-- JSON Patch support for schema modifications
-- Modular and reusable design
-
-#### [`@schema-typescript/cli`](./packages/cli)
-Command-line interface for schema-typescript operations.
-
-```bash
-npm install @schema-typescript/cli
-```
-
-### JSON-LD Tools
-
-#### [`jsonldjs`](./packages/jsonld-tools)
-A powerful, generic JSON-LD builder with comprehensive entity and property filtering capabilities.
-
-```bash
-npm install jsonldjs
-```
-
-**Features:**
-- Configuration-first design with immutable builders
-- Fluent interface for building complex filtering logic
-- Property-level filtering by entity IDs or types
-- Subgraph extraction with reference following
-- Full TypeScript support with type inference
-
-**Quick Example:**
-```typescript
-import { createJsonLdBuilder } from 'jsonldjs';
-
-const result = createJsonLdBuilder()
-  .baseGraph(jsonldGraph)
-  .includeTypes(['Organization', 'Person'])
-  .excludeTypes(['ImageObject'])
-  .build({ prettyPrint: true });
-```
-
-### API Clients
-
-#### [`@interweb/node-api-client`](./packages/node-api-client)
-Lightweight and flexible HTTP client for Node.js applications.
-
-```bash
-npm install @interweb/node-api-client
-```
-
-**Features:**
-- Support for GET, POST, PUT, PATCH, DELETE
-- Customizable headers and query parameters
-- Timeout configuration
-- Node.js optimized
-
-#### [`@interweb/fetch-api-client`](./packages/fetch-api-client)
-Universal HTTP client supporting both Node.js and browser environments.
-
-```bash
-npm install @interweb/fetch-api-client
-```
-
-**Features:**
-- Works in Node.js and browsers
-- Fetch API based
-- Common HTTP methods support
-- Customizable options
-
-#### [`@interweb/http-errors`](./packages/http-errors)
-HTTP error handling utilities for API clients.
-
-```bash
-npm install @interweb/http-errors
-```
-
-### Utilities
-
-#### [`komoji`](./packages/komoji)
-the tiny case transformer — effortlessly transform strings between naming conventions
-
-```bash
-npm install komoji
-```
-
-#### [`@interweb/find-pkg`](./packages/find-pkg)
-Locate and parse `package.json` files from within build directories or packages.
-
-```bash
-npm install @interweb/find-pkg
-```
-
-**Example:**
-```javascript
-import { findPackageJson } from '@interweb/find-pkg';
-
-const packageJson = findPackageJson();
-console.log('Package name:', packageJson.name);
-console.log('Version:', packageJson.version);
-```
-
-#### [`nested-obj`](./packages/nested-obj)
-Simple and lightweight utility for safely accessing and modifying nested object properties.
-
-```bash
-npm install nested-obj
-```
-
-**Features:**
-- Safe nested property access
-- Set values at specific paths
-- Check if paths exist
-- TypeScript support
-
-**Example:**
-```typescript
-import objectPath from 'nested-obj';
-
-const obj = { user: { name: 'John', address: { city: 'NYC' } } };
-
-// Get nested values
-const name = objectPath.get(obj, 'user.name'); // 'John'
-
-// Set nested values
-objectPath.set(obj, 'user.address.zip', '10001');
-
-// Check if path exists
-const hasCity = objectPath.has(obj, 'user.address.city'); // true
-```
-
-#### [`strfy-js`](./packages/strfy-js)
-Stringify JSON as JavaScript with extended serialization capabilities.
-
-```bash
-npm install strfy-js
-```
-
-**Features:**
-- Extended serialization beyond standard JSON
-- Properties without quotes
-- Customizable output (camelCase, quotes, etc.)
-- Lightweight and optimized for performance
-
-**Example:**
-```javascript
-import { jsStringify } from 'strfy-js';
-
-const obj = {
-  "$schema": "schema.json",
-  "chain_id": "cosmos-1"
-};
-
-console.log(jsStringify(obj, { camelCase: true, quotes: 'single' }));
-// Output: { $schema: 'schema.json', chainId: 'cosmos-1' }
-```
+| Package | npm | Source | Description |
+|---------|-----|--------|-------------|
+| **appstash** | [![npm](https://img.shields.io/npm/v/appstash.svg)](https://www.npmjs.com/package/appstash) | [GitHub](./packages/appstash) | Simple, clean application directory resolution |
+| **create-gen-app** | [![npm](https://img.shields.io/npm/v/create-gen-app.svg)](https://www.npmjs.com/package/create-gen-app) | [GitHub](./packages/create-gen-app) | Clone and customize template repositories with variable replacement |
+| **inquirerer** | [![npm](https://img.shields.io/npm/v/inquirerer.svg)](https://www.npmjs.com/package/inquirerer) | [GitHub](./packages/inquirerer) | TypeScript-first library for building beautiful CLI interfaces with interactive prompts |
+| **jsonldjs** | [![npm](https://img.shields.io/npm/v/jsonldjs.svg)](https://www.npmjs.com/package/jsonldjs) | [GitHub](./packages/jsonld-tools) | Powerful JSON-LD builder with comprehensive filtering and subgraph extraction |
+| **komoji** | [![npm](https://img.shields.io/npm/v/komoji.svg)](https://www.npmjs.com/package/komoji) | [GitHub](./packages/komoji) | the tiny case transformer — effortlessly transform strings between naming conventions |
+| **nested-obj** | [![npm](https://img.shields.io/npm/v/nested-obj.svg)](https://www.npmjs.com/package/nested-obj) | [GitHub](./packages/nested-obj) | Safely access and modify nested object properties using string paths |
+| **schema-sdk** | [![npm](https://img.shields.io/npm/v/schema-sdk.svg)](https://www.npmjs.com/package/schema-sdk) | [GitHub](./packages/schema-sdk) | Convert JSON Schema OpenAPI Spec to TypeScript Clients |
+| **schema-typescript** | [![npm](https://img.shields.io/npm/v/schema-typescript.svg)](https://www.npmjs.com/package/schema-typescript) | [GitHub](./packages/schema-typescript) | Convert JSON Schema to TypeScript Definitions |
+| **strfy-js** | [![npm](https://img.shields.io/npm/v/strfy-js.svg)](https://www.npmjs.com/package/strfy-js) | [GitHub](./packages/strfy-js) | Stringify JSON as JavaScript with extended serialization capabilities |
+| **yanse** | [![npm](https://img.shields.io/npm/v/yanse.svg)](https://www.npmjs.com/package/yanse) | [GitHub](./packages/yanse) | Fast and lightweight terminal color styling library with chalk-like API |
+| **@interweb/fetch-api-client** | [![npm](https://img.shields.io/npm/v/@interweb/fetch-api-client.svg)](https://www.npmjs.com/package/@interweb/fetch-api-client) | [GitHub](./packages/fetch-api-client) | Universal Fetch-based HTTP client for Node.js and browsers |
+| **@interweb/find-pkg** | [![npm](https://img.shields.io/npm/v/@interweb/find-pkg.svg)](https://www.npmjs.com/package/@interweb/find-pkg) | [GitHub](./packages/find-pkg) | Find the package.json file from within a build/package |
+| **@interweb/http-errors** | [![npm](https://img.shields.io/npm/v/@interweb/http-errors.svg)](https://www.npmjs.com/package/@interweb/http-errors) | [GitHub](./packages/http-errors) | HTTP error handling utilities for API clients |
+| **@interweb/node-api-client** | [![npm](https://img.shields.io/npm/v/@interweb/node-api-client.svg)](https://www.npmjs.com/package/@interweb/node-api-client) | [GitHub](./packages/node-api-client) | Lightweight HTTP client for Node.js RESTful APIs |
+| **@schema-typescript/cli** | [![npm](https://img.shields.io/npm/v/@schema-typescript/cli.svg)](https://www.npmjs.com/package/@schema-typescript/cli) | [GitHub](./packages/schema-ts-cli) | schema-typescript CLI |
 
 ## Development
 
@@ -238,31 +70,6 @@ pnpm test
 pnpm lint
 ```
 
-## Development
-
-### Setup
-
-1. Clone the repository:
-
-```bash
-git clone https://github.com/hyperweb-io/dev-utils.git
-```
-
-2. Install dependencies:
-
-```bash
-cd dev-utils
-pnpm install
-pnpm build
-```
-
-3. Test the package of interest:
-
-```bash
-cd packages/<packagename>
-pnpm test:watch
-```
-
 ## Disclaimer
 
 AS DESCRIBED IN THE LICENSES, THE SOFTWARE IS PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND.

packages/create-gen-app/package.json

@@ -2,7 +2,7 @@
   "name": "create-gen-app",
   "version": "0.1.2",
   "author": "Dan Lynch <[email protected]>",
-  "description": "Clone and customize template repositories",
+  "description": "Clone and customize template repositories with variable replacement",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",

packages/fetch-api-client/package.json

@@ -2,7 +2,7 @@
   "name": "@interweb/fetch-api-client",
   "version": "0.7.3",
   "author": "Dan Lynch <[email protected]>",
-  "description": "Node.js API Client",
+  "description": "Universal Fetch-based HTTP client for Node.js and browsers",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",

packages/http-errors/package.json

@@ -2,7 +2,7 @@
   "name": "@interweb/http-errors",
   "version": "0.2.3",
   "author": "Dan Lynch <[email protected]>",
-  "description": "http errors",
+  "description": "HTTP error handling utilities for API clients",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",

packages/inquirerer/package.json

@@ -2,7 +2,7 @@
   "name": "inquirerer",
   "version": "2.1.2",
   "author": "Dan Lynch <[email protected]>",
-  "description": "inquirerer",
+  "description": "TypeScript-first library for building beautiful CLI interfaces with interactive prompts",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",

packages/jsonld-tools/package.json

@@ -1,7 +1,7 @@
 {
   "name": "jsonldjs",
   "version": "0.2.4",
-  "description": "JSON-LD Tooling",
+  "description": "Powerful JSON-LD builder with comprehensive filtering and subgraph extraction",
   "author": "Dan Lynch <[email protected]>",
   "homepage": "https://github.com/hyperweb-io/dev-utils",
   "license": "MIT",

packages/nested-obj/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nested-obj",
   "version": "0.1.2",
-  "description": "manipulate deep objects safely and simply",
+  "description": "Safely access and modify nested object properties using string paths",
   "author": "Dan Lynch <[email protected]>",
   "homepage": "https://github.com/hyperweb-io/dev-utils",
   "license": "MIT",

packages/node-api-client/package.json

@@ -2,7 +2,7 @@
   "name": "@interweb/node-api-client",
   "version": "0.8.3",
   "author": "Dan Lynch <[email protected]>",
-  "description": "Node.js API Client",
+  "description": "Lightweight HTTP client for Node.js RESTful APIs",
   "main": "index.js",
   "module": "esm/index.js",
   "types": "index.d.ts",

packages/strfy-js/package.json

@@ -1,7 +1,7 @@
 {
   "name": "strfy-js",
   "version": "3.1.2",
-  "description": "kinda like JSON.stringify, but for generating JSON that is meant for JS objects",
+  "description": "Stringify JSON as JavaScript with extended serialization capabilities",
   "author": "Dan Lynch <[email protected]>",
   "homepage": "https://github.com/hyperweb-io/dev-utils",
   "license": "MIT",