apparel 0.0.1

package/README.md

@@ -0,0 +1,176 @@
+# Apparel
+
+A powerful NPX script that fills templates with variables from configuration files. Supports multiple config formats and template engines.
+
+## Features
+
+- **Multiple Config Formats**: JSON, JSON5, YAML, TOML, XML
+- **Multiple Template Engines**: Handlebars, EJS, Liquid, Jinja/Nunjucks
+- **Local and Remote Files**: Support for local files, URLs, and GitHub repos
+- **GitHub Integration**: Use `@repo/file` format to fetch from n-p-x organization
+- **Flexible Output**: Write to file or stdout
+
+## Installation
+
+Install globally to use as an NPX command:
+
+```bash
+npm install -g apparel
+```
+
+Or use directly with npx:
+
+```bash
+npx apparel <src> <tpl> [dst]
+```
+
+## Usage
+
+```bash
+apparel <src> <tpl> [dst]
+```
+
+### Arguments
+
+- `src` (required): Config file path
+- `tpl` (required): Template file path  
+- `dst` (optional): Output file path (defaults to stdout)
+
+### File Sources
+
+Files can be loaded from:
+
+1. **Local files**: `./config.json`, `../templates/email.hbs`
+2. **URLs**: `https://example.com/config.json`
+3. **GitHub repos**: `@myrepo/config.json` (fetches from `n-p-x/myrepo`)
+
+## Supported Config Formats
+
+| Extension | Format | Parser |
+|-----------|--------|---------|
+| `.json` | JSON | Native JSON.parse |
+| `.json5` | JSON5 | json5 |
+| `.yml`, `.yaml` | YAML | js-yaml |
+| `.toml` | TOML | toml |
+| `.xml` | XML | fast-xml-parser |
+
+## Supported Template Engines
+
+| Extension | Engine | Library |
+|-----------|--------|---------|
+| `.hbs`, `.handlebars` | Handlebars | handlebars |
+| `.ejs` | EJS | ejs |
+| `.liquid` | Liquid | liquidjs |
+| `.jinja`, `.j2` | Jinja | nunjucks |
+
+## Examples
+
+### Basic Usage
+
+```bash
+# JSON config with Handlebars template
+apparel config.json template.hbs output.txt
+
+# YAML config with EJS template to stdout
+apparel config.yml template.ejs
+
+# Remote config with local template
+apparel https://example.com/config.json template.hbs
+```
+
+### GitHub Integration
+
+```bash
+# Fetch config from n-p-x/configs repo
+apparel @configs/prod.json template.hbs
+
+# Fetch both config and template from GitHub
+apparel @configs/prod.json @templates/email.hbs output.html
+```
+
+### Example Files
+
+#### Config (config.json)
+```json
+{
+  "name": "John Doe",
+  "email": "john@example.com",
+  "role": "Developer",
+  "skills": ["JavaScript", "TypeScript", "Node.js"]
+}
+```
+
+#### Handlebars Template (template.hbs)
+```handlebars
+Hello {{name}},
+
+Your role: {{role}}
+Skills: {{#each skills}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}
+```
+
+#### Output
+```
+Hello John Doe,
+
+Your role: Developer
+Skills: JavaScript, TypeScript, Node.js
+```
+
+## Template Syntax Examples
+
+### Handlebars
+```handlebars
+{{name}} - {{email}}
+{{#each skills}}
+- {{this}}
+{{/each}}
+```
+
+### EJS
+```ejs
+<%= name %> - <%= email %>
+<% skills.forEach(skill => { %>
+- <%= skill %>
+<% }); %>
+```
+
+### Liquid
+```liquid
+{{ name }} - {{ email }}
+{% for skill in skills %}
+- {{ skill }}
+{% endfor %}
+```
+
+### Jinja/Nunjucks
+```jinja
+{{ name }} - {{ email }}
+{% for skill in skills %}
+- {{ skill }}
+{% endfor %}
+```
+
+## Error Handling
+
+The script provides detailed error messages for:
+- File not found or network errors
+- Invalid config file format
+- Template rendering errors
+- Missing required arguments
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Test locally
+node dist/index.js examples/config.json examples/template.hbs
+```
+
+## License
+
+ISC

package/dist/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{Command as h}from"commander";import{promises as f}from"fs";import m from"js-yaml";import*as d from"toml";import g from"json5";import{XMLParser as y}from"fast-xml-parser";import p from"handlebars";import{Liquid as $}from"liquidjs";import x from"ejs";import w from"nunjucks";import s from"path";import{fileURLToPath as b}from"url";var j=b(import.meta.url),U=s.dirname(j);w.configure({autoescape:!1});async function l(r){let e=await fetch(r);if(!e.ok)throw new Error(`Failed to fetch ${r}: ${e.status} ${e.statusText}`);return e.text()}async function u(r){if(r.startsWith("@")){let[,e,...t]=r.split("/"),o=t.join("/"),a=`https://raw.githubusercontent.com/n-p-x/${e}/main/${o}`;return l(a)}return r.startsWith("http://")||r.startsWith("https://")?l(r):f.readFile(r,"utf8")}function L(r,e){let t=s.extname(e).toLowerCase();try{switch(t){case".json":return JSON.parse(r);case".json5":return g.parse(r);case".yml":case".yaml":return m.load(r);case".toml":return d.parse(r);case".xml":return new y({ignoreAttributes:!1,attributeNamePrefix:"@_",parseAttributeValue:!0}).parse(r);default:try{return JSON.parse(r)}catch{return m.load(r)}}}catch(o){throw new Error(`Failed to parse config file ${e}: ${o.message}`)}}async function F(r,e,t){let o=s.extname(e).toLowerCase();try{switch(o){case".hbs":case".handlebars":return p.compile(r)(t);case".liquid":return new $().parseAndRender(r,t);case".ejs":return x.render(r,t);case".jinja":case".j2":return w.renderString(r,t);default:return p.compile(r)(t)}}catch(a){throw new Error(`Failed to render template ${e}: ${a.message}`)}}async function T(){let r=new h;r.name("apparel").description("Fill templates with variables from config files").version("0.0.1").argument("<src>","Config file path (local file, URL, or @repo/file format)").argument("<tpl>","Template file path (local file, URL, or @repo/file format)").argument("[dst]","Output file path (optional, defaults to stdout)").action(async(e,t,o)=>{try{console.error(`Loading config from: ${e}`);let a=await u(e),n=L(a,e);console.error(`Loading template from: ${t}`);let i=await u(t);console.error("Rendering template...");let c=await F(i,t,n);o?(await f.writeFile(o,c,"utf8"),console.error(`Output written to: ${o}`)):process.stdout.write(c)}catch(a){console.error(`Error: ${a.message}`),process.exit(1)}}),await r.parseAsync()}(async()=>await T())();

package/examples/config.json

@@ -0,0 +1,8 @@
+{
+  "name": "John Doe",
+  "email": "john.doe@example.com",
+  "role": "Software Engineer",
+  "company": "Tech Corp",
+  "skills": ["JavaScript", "TypeScript", "Node.js", "React"],
+  "experience": 5
+}

package/examples/config.toml

@@ -0,0 +1,6 @@
+name = "John Doe"
+email = "john.doe@example.com"
+role = "Software Engineer"
+company = "Tech Corp"
+skills = ["JavaScript", "TypeScript", "Node.js", "React"]
+experience = 5

package/examples/config.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<config>
+  <name>John Doe</name>
+  <email>john.doe@example.com</email>
+  <role>Software Engineer</role>
+  <company>Tech Corp</company>
+  <skills>
+    <skill>JavaScript</skill>
+    <skill>TypeScript</skill>
+    <skill>Node.js</skill>
+    <skill>React</skill>
+  </skills>
+  <experience>5</experience>
+</config>

package/examples/config.yml

@@ -0,0 +1,10 @@
+name: Jane Smith
+email: jane.smith@example.com
+role: Product Manager
+company: Innovation Labs
+skills:
+  - Product Strategy
+  - User Research
+  - Agile
+  - Data Analysis
+experience: 7

package/examples/output.txt

@@ -0,0 +1,22 @@
+name: John Doe
+email: john.doe@example.com
+role: Software Engineer
+company: Tech Corp
+experience: 5 years
+
+Skills:
+- JavaScript
+- TypeScript
+- Node.js
+- React
+
+---
+
+Hello John Doe,
+
+Thank you for your interest in joining Tech Corp as a Software Engineer. 
+With 5 years of experience and your skills in JavaScript, TypeScript, Node.js, React, 
+you would be a great fit for our team.
+
+Best regards,
+HR Team

package/examples/template.ejs

@@ -0,0 +1,15 @@
+Hello <%= name %>,
+
+Welcome to <%= company %>! We're excited to have you join our team as a <%= role %>.
+
+Your profile:
+- Email: <%= email %>
+- Experience: <%= experience %> years
+- Skills: <% skills.forEach((skill, index) => { %>
+  • <%= skill %><% if (index < skills.length - 1) { %>,<% } %>
+<% }); %>
+
+We look forward to working with you!
+
+Best regards,
+The <%= company %> Team

package/examples/template.hbs

@@ -0,0 +1,21 @@
+name: {{name}}
+email: {{email}}
+role: {{role}}
+company: {{company}}
+experience: {{experience}} years
+
+Skills:
+{{#each skills}}
+- {{this}}
+{{/each}}
+
+---
+
+Hello {{name}},
+
+Thank you for your interest in joining {{company}} as a {{role}}. 
+With {{experience}} years of experience and your skills in {{#each skills}}{{this}}{{#unless @last}}, {{/unless}}{{/each}}, 
+you would be a great fit for our team.
+
+Best regards,
+HR Team

package/examples/template.j2

@@ -0,0 +1,21 @@
+name: {{ name }}
+email: {{ email }}
+role: {{ role }}
+company: {{ company }}
+experience: {{ experience }} years
+
+Skills:
+{% for skill in skills %}
+- {{ skill }}
+{% endfor %}
+
+---
+
+Hello {{ name }},
+
+Thank you for your interest in joining {{ company }} as a {{ role }}. 
+With {{ experience }} years of experience and your skills in {% for skill in skills %}{{ skill }}{% if not loop.last %}, {% endif %}{% endfor %}, 
+you would be a great fit for our team.
+
+Best regards,
+HR Team

package/examples/template.liquid

@@ -0,0 +1,21 @@
+name: {{ name }}
+email: {{ email }}
+role: {{ role }}
+company: {{ company }}
+experience: {{ experience }} years
+
+Skills:
+{% for skill in skills %}
+- {{ skill }}
+{% endfor %}
+
+---
+
+Hello {{ name }},
+
+Thank you for your interest in joining {{ company }} as a {{ role }}. 
+With {{ experience }} years of experience and your skills in {% for skill in skills %}{{ skill }}{% unless forloop.last %}, {% endunless %}{% endfor %}, 
+you would be a great fit for our team.
+
+Best regards,
+HR Team

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "apparel",
+  "version": "0.0.1",
+  "description": "Dress templates with variables.",
+  "type": "module",
+  "bin": "./dist/index.js",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "tsup"
+  },
+  "keywords": [],
+  "author": "Asfandyar Sheikh",
+  "license": "ISC",
+  "dependencies": {
+    "commander": "^14.0.3",
+    "ejs": "^4.0.1",
+    "fast-xml-parser": "^5.3.7",
+    "handlebars": "^4.7.8",
+    "js-yaml": "^4.1.1",
+    "json5": "^2.2.3",
+    "liquidjs": "^10.24.0",
+    "nunjucks": "^3.2.4",
+    "toml": "^3.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/asfandyarsheikh/apparel.git"
+  }
+}

package/tsup.config.js

@@ -0,0 +1,8 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: { index: 'src/index.js' },
+  format: ['esm'],
+  clean: false,
+  minify: true,
+});