@pixid/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 thilllon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+import{randomUUID as h}from"crypto";import{writeFileSync as b}from"fs";import{resolve as v}from"path";import{parseArgs as y}from"util";import{toPng as x}from"@pixid/png";import{toSvg as _}from"@pixid/svg";var w="0.1.0",$=`pixid - blocky identicon generator
+
+Usage:
+  pixid [seed] [options]
+
+Options:
+  -s, --seed <seed>       seed string (same as the positional argument)
+  -o, --out <file>        output path (default: <seed>.<format>)
+  -f, --format <format>   png or svg (default: inferred from --out, else png)
+      --size <n>          cells per side (default: 8)
+      --scale <n>         pixels per cell (default: 16)
+      --color <color>     foreground color, #rgb or #rrggbb
+      --bgcolor <color>   background color, #rgb or #rrggbb
+      --spotcolor <color> accent color, #rgb or #rrggbb
+  -h, --help              show this message
+  -v, --version           show the version
+
+Examples:
+  npx pixid
+  npx pixid 0x8ba1f109551bd432803012645ac136ddd64dba72
+  npx pixid --seed alice --out alice.svg --scale 32
+  npx pixid --format svg --bgcolor "#ffffff"
+`,t=s=>{process.stderr.write(`pixid: ${s}
+
+Run "pixid --help" for usage.
+`),process.exit(1)},l=(s,n)=>{let e=Number(n);return!Number.isInteger(e)||e<1?t(`--${s} must be a positive integer, got ${JSON.stringify(n)}`):e},d=(s=process.argv.slice(2))=>{let n;try{n=y({args:s,allowPositionals:!0,options:{seed:{type:"string",short:"s"},out:{type:"string",short:"o"},format:{type:"string",short:"f"},size:{type:"string"},scale:{type:"string"},color:{type:"string"},bgcolor:{type:"string"},spotcolor:{type:"string"},help:{type:"boolean",short:"h"},version:{type:"boolean",short:"v"}}})}catch(r){return t(r instanceof Error?r.message:String(r))}let{values:e,positionals:g}=n;if(e.help){process.stdout.write($);return}if(e.version){process.stdout.write(`${w}
+`);return}if(g.length>1)return t(`expected at most one positional argument, got ${g.length}`);if(e.seed!==void 0&&g.length>0)return t("pass the seed either as a positional argument or with --seed, not both");let p=e.seed??g[0]??h(),o=e.format;if(o===void 0&&e.out!==void 0&&(o=e.out.toLowerCase().endsWith(".svg")?"svg":"png"),o??="png",o!=="png"&&o!=="svg")return t(`--format must be "png" or "svg", got ${JSON.stringify(o)}`);let f=e.out??`${p.replace(/[^a-zA-Z0-9._-]/g,"_")}.${o}`,u=e.size===void 0?void 0:l("size",e.size),m=e.scale===void 0?16:l("scale",e.scale),a={seed:p,size:u,scale:m,color:e.color,bgcolor:e.bgcolor,spotcolor:e.spotcolor},i;try{i=o==="png"?x(a):_(a)}catch(r){return t(r instanceof Error?r.message:String(r))}let c=v(process.cwd(),f);b(c,i),process.stdout.write(`${c} (${typeof i=="string"?i.length:i.byteLength} bytes)
+`)};d();

package/dist/index.cjs

@@ -0,0 +1,28 @@
+"use strict";var a=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var z=Object.prototype.hasOwnProperty;var P=(r,o)=>{for(var e in o)a(r,e,{get:o[e],enumerable:!0})},E=(r,o,e,n)=>{if(o&&typeof o=="object"||typeof o=="function")for(let t of S(o))!z.call(r,t)&&t!==e&&a(r,t,{get:()=>o[t],enumerable:!(n=$(o,t))||n.enumerable});return r};var N=r=>E(a({},"__esModule",{value:!0}),r);var U={};P(U,{runCli:()=>O,version:()=>y});module.exports=N(U);var f=require("crypto"),u=require("fs"),m=require("path"),h=require("util"),b=require("@pixid/png"),v=require("@pixid/svg"),y="0.1.0",I=`pixid - blocky identicon generator
+
+Usage:
+  pixid [seed] [options]
+
+Options:
+  -s, --seed <seed>       seed string (same as the positional argument)
+  -o, --out <file>        output path (default: <seed>.<format>)
+  -f, --format <format>   png or svg (default: inferred from --out, else png)
+      --size <n>          cells per side (default: 8)
+      --scale <n>         pixels per cell (default: 16)
+      --color <color>     foreground color, #rgb or #rrggbb
+      --bgcolor <color>   background color, #rgb or #rrggbb
+      --spotcolor <color> accent color, #rgb or #rrggbb
+  -h, --help              show this message
+  -v, --version           show the version
+
+Examples:
+  npx pixid
+  npx pixid 0x8ba1f109551bd432803012645ac136ddd64dba72
+  npx pixid --seed alice --out alice.svg --scale 32
+  npx pixid --format svg --bgcolor "#ffffff"
+`,g=r=>{process.stderr.write(`pixid: ${r}
+
+Run "pixid --help" for usage.
+`),process.exit(1)},d=(r,o)=>{let e=Number(o);return!Number.isInteger(e)||e<1?g(`--${r} must be a positive integer, got ${JSON.stringify(o)}`):e},O=(r=process.argv.slice(2))=>{let o;try{o=(0,h.parseArgs)({args:r,allowPositionals:!0,options:{seed:{type:"string",short:"s"},out:{type:"string",short:"o"},format:{type:"string",short:"f"},size:{type:"string"},scale:{type:"string"},color:{type:"string"},bgcolor:{type:"string"},spotcolor:{type:"string"},help:{type:"boolean",short:"h"},version:{type:"boolean",short:"v"}}})}catch(i){return g(i instanceof Error?i.message:String(i))}let{values:e,positionals:n}=o;if(e.help){process.stdout.write(I);return}if(e.version){process.stdout.write(`${y}
+`);return}if(n.length>1)return g(`expected at most one positional argument, got ${n.length}`);if(e.seed!==void 0&&n.length>0)return g("pass the seed either as a positional argument or with --seed, not both");let t=e.seed??n[0]??(0,f.randomUUID)(),s=e.format;if(s===void 0&&e.out!==void 0&&(s=e.out.toLowerCase().endsWith(".svg")?"svg":"png"),s??="png",s!=="png"&&s!=="svg")return g(`--format must be "png" or "svg", got ${JSON.stringify(s)}`);let x=e.out??`${t.replace(/[^a-zA-Z0-9._-]/g,"_")}.${s}`,_=e.size===void 0?void 0:d("size",e.size),w=e.scale===void 0?16:d("scale",e.scale),c={seed:t,size:_,scale:w,color:e.color,bgcolor:e.bgcolor,spotcolor:e.spotcolor},p;try{p=s==="png"?(0,b.toPng)(c):(0,v.toSvg)(c)}catch(i){return g(i instanceof Error?i.message:String(i))}let l=(0,m.resolve)(process.cwd(),x);(0,u.writeFileSync)(l,p),process.stdout.write(`${l} (${typeof p=="string"?p.length:p.byteLength} bytes)
+`)};0&&(module.exports={runCli,version});

package/dist/index.d.cts

@@ -0,0 +1,15 @@
+/** Version of `@pixid/cli`, baked in at build time. */
+declare const version: string;
+/**
+ * Runs the `pixid` command-line interface.
+ *
+ * Writes the generated file to disk and reports the path on stdout. Invalid
+ * input is reported on stderr and terminates the process with exit code 1,
+ * so this is only meant for use as a program entry point.
+ *
+ * @param argv Arguments after the executable and script name.
+ *             Defaults to `process.argv.slice(2)`.
+ */
+declare const runCli: (argv?: string[]) => void;
+
+export { runCli, version };

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/** Version of `@pixid/cli`, baked in at build time. */
+declare const version: string;
+/**
+ * Runs the `pixid` command-line interface.
+ *
+ * Writes the generated file to disk and reports the path on stdout. Invalid
+ * input is reported on stderr and terminates the process with exit code 1,
+ * so this is only meant for use as a program entry point.
+ *
+ * @param argv Arguments after the executable and script name.
+ *             Defaults to `process.argv.slice(2)`.
+ */
+declare const runCli: (argv?: string[]) => void;
+
+export { runCli, version };

package/dist/index.js

@@ -0,0 +1,28 @@
+import{randomUUID as m}from"crypto";import{writeFileSync as h}from"fs";import{resolve as b}from"path";import{parseArgs as v}from"util";import{toPng as y}from"@pixid/png";import{toSvg as x}from"@pixid/svg";var _="0.1.0",w=`pixid - blocky identicon generator
+
+Usage:
+  pixid [seed] [options]
+
+Options:
+  -s, --seed <seed>       seed string (same as the positional argument)
+  -o, --out <file>        output path (default: <seed>.<format>)
+  -f, --format <format>   png or svg (default: inferred from --out, else png)
+      --size <n>          cells per side (default: 8)
+      --scale <n>         pixels per cell (default: 16)
+      --color <color>     foreground color, #rgb or #rrggbb
+      --bgcolor <color>   background color, #rgb or #rrggbb
+      --spotcolor <color> accent color, #rgb or #rrggbb
+  -h, --help              show this message
+  -v, --version           show the version
+
+Examples:
+  npx pixid
+  npx pixid 0x8ba1f109551bd432803012645ac136ddd64dba72
+  npx pixid --seed alice --out alice.svg --scale 32
+  npx pixid --format svg --bgcolor "#ffffff"
+`,t=s=>{process.stderr.write(`pixid: ${s}
+
+Run "pixid --help" for usage.
+`),process.exit(1)},l=(s,n)=>{let e=Number(n);return!Number.isInteger(e)||e<1?t(`--${s} must be a positive integer, got ${JSON.stringify(n)}`):e},I=(s=process.argv.slice(2))=>{let n;try{n=v({args:s,allowPositionals:!0,options:{seed:{type:"string",short:"s"},out:{type:"string",short:"o"},format:{type:"string",short:"f"},size:{type:"string"},scale:{type:"string"},color:{type:"string"},bgcolor:{type:"string"},spotcolor:{type:"string"},help:{type:"boolean",short:"h"},version:{type:"boolean",short:"v"}}})}catch(r){return t(r instanceof Error?r.message:String(r))}let{values:e,positionals:g}=n;if(e.help){process.stdout.write(w);return}if(e.version){process.stdout.write(`${_}
+`);return}if(g.length>1)return t(`expected at most one positional argument, got ${g.length}`);if(e.seed!==void 0&&g.length>0)return t("pass the seed either as a positional argument or with --seed, not both");let p=e.seed??g[0]??m(),o=e.format;if(o===void 0&&e.out!==void 0&&(o=e.out.toLowerCase().endsWith(".svg")?"svg":"png"),o??="png",o!=="png"&&o!=="svg")return t(`--format must be "png" or "svg", got ${JSON.stringify(o)}`);let d=e.out??`${p.replace(/[^a-zA-Z0-9._-]/g,"_")}.${o}`,f=e.size===void 0?void 0:l("size",e.size),u=e.scale===void 0?16:l("scale",e.scale),a={seed:p,size:f,scale:u,color:e.color,bgcolor:e.bgcolor,spotcolor:e.spotcolor},i;try{i=o==="png"?y(a):x(a)}catch(r){return t(r instanceof Error?r.message:String(r))}let c=b(process.cwd(),d);h(c,i),process.stdout.write(`${c} (${typeof i=="string"?i.length:i.byteLength} bytes)
+`)};export{I as runCli,_ as version};

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@pixid/cli",
+  "version": "0.1.0",
+  "description": "Command-line blocky identicon generator. Writes deterministic PNG or SVG identicons from any seed string (npx @pixid/cli).",
+  "keywords": [
+    "identicon",
+    "blockies",
+    "avatar",
+    "ethereum",
+    "pixel",
+    "cli",
+    "png",
+    "svg"
+  ],
+  "license": "MIT",
+  "author": "thilllon",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thilllon/pixid.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/thilllon/pixid",
+  "bugs": {
+    "url": "https://github.com/thilllon/pixid/issues"
+  },
+  "type": "module",
+  "sideEffects": [
+    "./dist/cli.js"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./run": "./dist/cli.js",
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "pixid": "./dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@pixid/png": "^0.1.0",
+    "@pixid/svg": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup"
+  }
+}