@indiekitai/inspect 0.1.0

package/README.md

@@ -0,0 +1,78 @@
+# @indiekitai/inspect
+
+Rich-style `inspect()` for JavaScript/TypeScript. Pretty-print any object's attributes, methods, and docs with colored output. Zero dependencies.
+
+Inspired by Python's [Rich](https://github.com/Textualize/rich) `inspect()` function.
+
+## Install
+
+```bash
+npm install @indiekitai/inspect
+```
+
+## Usage
+
+```typescript
+import { inspect } from '@indiekitai/inspect';
+
+class User {
+  /** User's full name */
+  name: string = 'Alice';
+  /** User's age */
+  age: number = 30;
+
+  greet() { return `Hi, I'm ${this.name}`; }
+}
+
+inspect(new User());
+```
+
+Output:
+```
+╭──────────────────────────────────────────────────────────────╮
+│                             User                             │
+├──────────────────────────────────────────────────────────────┤
+│ • age    number   = 30                                       │
+│ • name   string   = "Alice"                                  │
+│ λ greet  function = ƒ greet()                                │
+╰──────────────────────────────────────────────────────────────╯
+```
+
+## Options
+
+```typescript
+inspect(obj, {
+  methods: true,        // Show methods (default: true)
+  private: false,       // Show _private members (default: false)
+  values: true,         // Show property values (default: true)
+  sort: true,           // Sort alphabetically (default: true)
+  maxStringLength: 80,  // Truncate long strings (default: 80)
+  maxDepth: 2,          // Nested object depth (default: 2)
+  json: false,          // Output as JSON (default: false)
+  color: true,          // ANSI colors (default: auto-detect)
+  title: '',            // Custom title
+  print: true,          // Print to console (default: true)
+});
+```
+
+## CLI
+
+```bash
+npx @indiekitai/inspect '{"hello":"world"}'
+npx @indiekitai/inspect --json '{"hello":"world"}'
+npx @indiekitai/inspect --no-color '{"hello":"world"}'
+```
+
+## Supports
+
+- Class instances with prototype chain display
+- Plain objects, Arrays, Maps, Sets
+- Functions (with argument signatures)
+- Dates, RegExps, Errors
+- Getters/setters
+- Nested objects with depth control
+- BigInt, Symbol
+
+## License
+
+MIT

package/dist/cli.mjs

@@ -0,0 +1,311 @@
+#!/usr/bin/env node
+
+// src/ansi.ts
+var ESC = "\x1B[";
+var RESET = `${ESC}0m`;
+var color = (code) => (s) => `${ESC}${code}m${s}${RESET}`;
+var bold = color(1);
+var dim = color(2);
+var italic = color(3);
+var underline = color(4);
+var red = color(31);
+var green = color(32);
+var yellow = color(33);
+var blue = color(34);
+var magenta = color(35);
+var cyan = color(36);
+var white = color(37);
+var brightBlack = color(90);
+var brightRed = color(91);
+var brightGreen = color(92);
+var brightYellow = color(93);
+var brightBlue = color(94);
+var brightMagenta = color(95);
+var brightCyan = color(96);
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function isColorSupported() {
+  if (typeof process === "undefined") return false;
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR) return true;
+  if (process.stdout && "isTTY" in process.stdout) return !!process.stdout.isTTY;
+  return false;
+}
+function withColor(enabled) {
+  if (enabled) return { bold, dim, italic, underline, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan };
+  const id = (s) => s;
+  return { bold: id, dim: id, italic: id, underline: id, red: id, green: id, yellow: id, blue: id, magenta: id, cyan: id, white: id, brightBlack: id, brightRed: id, brightGreen: id, brightYellow: id, brightBlue: id, brightMagenta: id, brightCyan: id };
+}
+
+// src/inspect.ts
+function getTypeName(obj) {
+  if (obj === null) return "null";
+  if (obj === void 0) return "undefined";
+  if (Array.isArray(obj)) return "Array";
+  if (obj instanceof Map) return "Map";
+  if (obj instanceof Set) return "Set";
+  if (obj instanceof Date) return "Date";
+  if (obj instanceof RegExp) return "RegExp";
+  if (obj instanceof Error) return obj.constructor.name;
+  if (typeof obj === "function") return obj.name ? `function ${obj.name}` : "function";
+  const proto = Object.getPrototypeOf(obj);
+  if (proto && proto.constructor && proto.constructor.name !== "Object") {
+    return proto.constructor.name;
+  }
+  return typeof obj;
+}
+function formatValue(val, maxLen, depth, maxDepth) {
+  if (depth > maxDepth) return "{\u2026}";
+  if (val === null) return "null";
+  if (val === void 0) return "undefined";
+  if (typeof val === "string") {
+    const s = val.length > maxLen ? val.slice(0, maxLen) + "\u2026" : val;
+    return JSON.stringify(s);
+  }
+  if (typeof val === "number" || typeof val === "boolean" || typeof val === "bigint") return String(val);
+  if (typeof val === "symbol") return val.toString();
+  if (typeof val === "function") {
+    const name = val.name || "anonymous";
+    const src = Function.prototype.toString.call(val);
+    const argsMatch = src.match(/\(([^)]*)\)/);
+    const args2 = argsMatch ? argsMatch[1] : "";
+    return `\u0192 ${name}(${args2})`;
+  }
+  if (val instanceof Date) return val.toISOString();
+  if (val instanceof RegExp) return val.toString();
+  if (val instanceof Error) return `${val.constructor.name}: ${val.message}`;
+  if (val instanceof Map) {
+    const entries2 = [...val.entries()].slice(0, 5).map(([k, v]) => `${formatValue(k, maxLen, depth + 1, maxDepth)} => ${formatValue(v, maxLen, depth + 1, maxDepth)}`);
+    const suffix2 = val.size > 5 ? `, \u2026 +${val.size - 5}` : "";
+    return `Map(${val.size}) { ${entries2.join(", ")}${suffix2} }`;
+  }
+  if (val instanceof Set) {
+    const items = [...val].slice(0, 5).map((v) => formatValue(v, maxLen, depth + 1, maxDepth));
+    const suffix2 = val.size > 5 ? `, \u2026 +${val.size - 5}` : "";
+    return `Set(${val.size}) { ${items.join(", ")}${suffix2} }`;
+  }
+  if (Array.isArray(val)) {
+    const items = val.slice(0, 5).map((v) => formatValue(v, maxLen, depth + 1, maxDepth));
+    const suffix2 = val.length > 5 ? `, \u2026 +${val.length - 5}` : "";
+    return `[${items.join(", ")}${suffix2}]`;
+  }
+  const keys = Object.keys(val).slice(0, 5);
+  const entries = keys.map((k) => `${k}: ${formatValue(val[k], maxLen, depth + 1, maxDepth)}`);
+  const allKeys = Object.keys(val);
+  const suffix = allKeys.length > 5 ? `, \u2026 +${allKeys.length - 5}` : "";
+  return `{ ${entries.join(", ")}${suffix} }`;
+}
+function getPrototypeChain(obj) {
+  const chain = [];
+  if (obj === null || obj === void 0 || typeof obj !== "object") return chain;
+  let proto = Object.getPrototypeOf(obj);
+  while (proto && proto !== Object.prototype) {
+    const name = proto.constructor?.name;
+    if (name && name !== "Object") chain.push(name);
+    proto = Object.getPrototypeOf(proto);
+  }
+  return chain;
+}
+function collectMembers(obj, opts2) {
+  const members = [];
+  if (obj === null || obj === void 0) return members;
+  const seen = /* @__PURE__ */ new Set();
+  const processProperty = (name, target) => {
+    if (seen.has(name)) return;
+    if (!opts2.private && name.startsWith("_") && !name.startsWith("__")) return;
+    if (!opts2.dunder && name.startsWith("__")) return;
+    seen.add(name);
+    const desc = Object.getOwnPropertyDescriptor(target, name);
+    if (!desc) return;
+    if (desc.get || desc.set) {
+      let val = "";
+      let type2 = "unknown";
+      if (desc.get) {
+        try {
+          const v = desc.get.call(obj);
+          val = formatValue(v, opts2.maxStringLength, 0, opts2.maxDepth);
+          type2 = v === null ? "null" : typeof v;
+        } catch {
+          val = "<error>";
+          type2 = "getter";
+        }
+      }
+      members.push({ name, kind: desc.get ? "getter" : "setter", type: type2, value: val });
+      return;
+    }
+    if (typeof desc.value === "function") {
+      if (!opts2.methods) return;
+      members.push({
+        name,
+        kind: "method",
+        type: "function",
+        value: formatValue(desc.value, opts2.maxStringLength, 0, opts2.maxDepth)
+      });
+      return;
+    }
+    const type = desc.value === null ? "null" : typeof desc.value;
+    members.push({
+      name,
+      kind: "property",
+      type: Array.isArray(desc.value) ? "Array" : desc.value instanceof Map ? "Map" : desc.value instanceof Set ? "Set" : type,
+      value: opts2.values ? formatValue(desc.value, opts2.maxStringLength, 0, opts2.maxDepth) : ""
+    });
+  };
+  if (typeof obj === "object" || typeof obj === "function") {
+    for (const name of Object.getOwnPropertyNames(obj)) {
+      if (name === "constructor") continue;
+      processProperty(name, obj);
+    }
+  }
+  if (typeof obj === "object" && obj !== null) {
+    let proto = Object.getPrototypeOf(obj);
+    while (proto && proto !== Object.prototype) {
+      for (const name of Object.getOwnPropertyNames(proto)) {
+        if (name === "constructor") continue;
+        processProperty(name, proto);
+      }
+      proto = Object.getPrototypeOf(proto);
+    }
+  }
+  if (opts2.sort) {
+    members.sort((a, b) => {
+      if (a.kind !== b.kind) {
+        const order = { property: 0, getter: 1, setter: 2, method: 3 };
+        return order[a.kind] - order[b.kind];
+      }
+      return a.name.localeCompare(b.name);
+    });
+  }
+  return members;
+}
+function renderTable(title, members, protoChain, c) {
+  const lines = [];
+  const nameWidth = Math.max(4, ...members.map((m) => m.name.length));
+  const typeWidth = Math.max(4, ...members.map((m) => m.type.length));
+  const totalInner = Math.max(60, nameWidth + typeWidth + 20);
+  lines.push(c.dim(`\u256D${"\u2500".repeat(totalInner + 2)}\u256E`));
+  const titlePad = totalInner - stripAnsi(title).length;
+  const leftPad = Math.floor(titlePad / 2);
+  const rightPad = titlePad - leftPad;
+  lines.push(c.dim("\u2502") + " ".repeat(leftPad + 1) + c.bold(c.cyan(title)) + " ".repeat(rightPad + 1) + c.dim("\u2502"));
+  if (protoChain.length > 0) {
+    const chain = `extends ${protoChain.join(" \u2192 ")}`;
+    const chainPad = totalInner - chain.length;
+    const clp = Math.floor(chainPad / 2);
+    const crp = chainPad - clp;
+    lines.push(c.dim("\u2502") + " ".repeat(clp + 1) + c.dim(chain) + " ".repeat(crp + 1) + c.dim("\u2502"));
+  }
+  lines.push(c.dim(`\u251C${"\u2500".repeat(totalInner + 2)}\u2524`));
+  if (members.length === 0) {
+    const msg = "(no members)";
+    const pad = totalInner - msg.length;
+    const lp = Math.floor(pad / 2);
+    const rp = pad - lp;
+    lines.push(c.dim("\u2502") + " ".repeat(lp + 1) + c.dim(msg) + " ".repeat(rp + 1) + c.dim("\u2502"));
+  } else {
+    for (const m of members) {
+      const icon = m.kind === "method" ? c.yellow("\u03BB") : m.kind === "getter" ? c.magenta("\u25CF") : m.kind === "setter" ? c.magenta("\u25CB") : c.green("\u2022");
+      const name = m.kind === "method" ? c.yellow(m.name) : c.white(m.name);
+      const type = c.dim(m.type);
+      const value2 = m.value ? ` ${c.brightBlack("=")} ${c.cyan(m.value)}` : "";
+      const content = ` ${icon} ${name} ${type}${value2}`;
+      const contentLen = stripAnsi(content).length;
+      const rightSpace = Math.max(0, totalInner - contentLen);
+      lines.push(c.dim("\u2502") + content + " ".repeat(rightSpace + 2) + c.dim("\u2502"));
+    }
+  }
+  lines.push(c.dim(`\u2570${"\u2500".repeat(totalInner + 2)}\u256F`));
+  return lines.join("\n");
+}
+function renderJson(title, members, protoChain) {
+  return JSON.stringify({
+    type: title,
+    prototypeChain: protoChain,
+    members: members.map((m) => ({
+      name: m.name,
+      kind: m.kind,
+      type: m.type,
+      ...m.value ? { value: m.value } : {},
+      ...m.doc ? { doc: m.doc } : {}
+    }))
+  }, null, 2);
+}
+var defaults = {
+  methods: true,
+  private: false,
+  dunder: false,
+  docs: true,
+  values: true,
+  sort: true,
+  maxStringLength: 80,
+  maxDepth: 2,
+  json: false,
+  color: true,
+  title: "",
+  print: true
+};
+function inspect(obj, options) {
+  const opts2 = { ...defaults, ...options };
+  if (opts2.color === true && options?.color === void 0) {
+    opts2.color = isColorSupported();
+  }
+  const title = opts2.title || getTypeName(obj);
+  const members = collectMembers(obj, opts2);
+  const protoChain = getPrototypeChain(obj);
+  let output;
+  if (opts2.json) {
+    output = renderJson(title, members, protoChain);
+  } else {
+    const c = withColor(opts2.color);
+    output = renderTable(title, members, protoChain, c);
+  }
+  if (opts2.print) {
+    console.log(output);
+  }
+  return output;
+}
+
+// src/cli.ts
+var args = process.argv.slice(2);
+if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
+  console.log(`Usage: inspect [options] <value>
+
+Pretty-print any JavaScript value.
+
+Arguments:
+  <value>              JSON string, or a literal value to inspect
+
+Options:
+  --no-methods         Hide methods
+  --no-values          Hide values
+  --private            Show private members (starting with _)
+  --no-sort            Don't sort members
+  --json               Output as JSON
+  --no-color           Disable color
+  --title <name>       Custom title
+  -h, --help           Show this help
+`);
+  process.exit(0);
+}
+var opts = {};
+var positional = [];
+for (let i = 0; i < args.length; i++) {
+  const arg = args[i];
+  if (arg === "--no-methods") opts.methods = false;
+  else if (arg === "--no-values") opts.values = false;
+  else if (arg === "--private") opts.private = true;
+  else if (arg === "--no-sort") opts.sort = false;
+  else if (arg === "--json") opts.json = true;
+  else if (arg === "--no-color") opts.color = false;
+  else if (arg === "--title" && i + 1 < args.length) opts.title = args[++i];
+  else positional.push(arg);
+}
+var input = positional.join(" ");
+var value;
+try {
+  value = JSON.parse(input);
+} catch {
+  value = input;
+}
+inspect(value, opts);

package/dist/index.d.mts

@@ -0,0 +1,29 @@
+interface InspectOptions {
+    /** Show methods (default: true) */
+    methods?: boolean;
+    /** Show private members starting with _ (default: false) */
+    private?: boolean;
+    /** Show dunder members starting with __ (default: false) */
+    dunder?: boolean;
+    /** Show docs/comments (default: true) */
+    docs?: boolean;
+    /** Show values of properties (default: true) */
+    values?: boolean;
+    /** Sort members alphabetically (default: true) */
+    sort?: boolean;
+    /** Maximum string value length before truncating (default: 80) */
+    maxStringLength?: number;
+    /** Maximum depth for nested objects (default: 2) */
+    maxDepth?: number;
+    /** Output as JSON instead of pretty table */
+    json?: boolean;
+    /** Enable color output (default: auto-detect) */
+    color?: boolean;
+    /** Title override */
+    title?: string;
+    /** Print to console (default: true). If false, returns string. */
+    print?: boolean;
+}
+declare function inspect(obj: unknown, options?: InspectOptions): string;
+
+export { type InspectOptions, inspect };

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+interface InspectOptions {
+    /** Show methods (default: true) */
+    methods?: boolean;
+    /** Show private members starting with _ (default: false) */
+    private?: boolean;
+    /** Show dunder members starting with __ (default: false) */
+    dunder?: boolean;
+    /** Show docs/comments (default: true) */
+    docs?: boolean;
+    /** Show values of properties (default: true) */
+    values?: boolean;
+    /** Sort members alphabetically (default: true) */
+    sort?: boolean;
+    /** Maximum string value length before truncating (default: 80) */
+    maxStringLength?: number;
+    /** Maximum depth for nested objects (default: 2) */
+    maxDepth?: number;
+    /** Output as JSON instead of pretty table */
+    json?: boolean;
+    /** Enable color output (default: auto-detect) */
+    color?: boolean;
+    /** Title override */
+    title?: string;
+    /** Print to console (default: true). If false, returns string. */
+    print?: boolean;
+}
+declare function inspect(obj: unknown, options?: InspectOptions): string;
+
+export { type InspectOptions, inspect };

package/dist/index.js

@@ -0,0 +1,295 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  inspect: () => inspect
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/ansi.ts
+var ESC = "\x1B[";
+var RESET = `${ESC}0m`;
+var color = (code) => (s) => `${ESC}${code}m${s}${RESET}`;
+var bold = color(1);
+var dim = color(2);
+var italic = color(3);
+var underline = color(4);
+var red = color(31);
+var green = color(32);
+var yellow = color(33);
+var blue = color(34);
+var magenta = color(35);
+var cyan = color(36);
+var white = color(37);
+var brightBlack = color(90);
+var brightRed = color(91);
+var brightGreen = color(92);
+var brightYellow = color(93);
+var brightBlue = color(94);
+var brightMagenta = color(95);
+var brightCyan = color(96);
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function isColorSupported() {
+  if (typeof process === "undefined") return false;
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR) return true;
+  if (process.stdout && "isTTY" in process.stdout) return !!process.stdout.isTTY;
+  return false;
+}
+function withColor(enabled) {
+  if (enabled) return { bold, dim, italic, underline, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan };
+  const id = (s) => s;
+  return { bold: id, dim: id, italic: id, underline: id, red: id, green: id, yellow: id, blue: id, magenta: id, cyan: id, white: id, brightBlack: id, brightRed: id, brightGreen: id, brightYellow: id, brightBlue: id, brightMagenta: id, brightCyan: id };
+}
+
+// src/inspect.ts
+function getTypeName(obj) {
+  if (obj === null) return "null";
+  if (obj === void 0) return "undefined";
+  if (Array.isArray(obj)) return "Array";
+  if (obj instanceof Map) return "Map";
+  if (obj instanceof Set) return "Set";
+  if (obj instanceof Date) return "Date";
+  if (obj instanceof RegExp) return "RegExp";
+  if (obj instanceof Error) return obj.constructor.name;
+  if (typeof obj === "function") return obj.name ? `function ${obj.name}` : "function";
+  const proto = Object.getPrototypeOf(obj);
+  if (proto && proto.constructor && proto.constructor.name !== "Object") {
+    return proto.constructor.name;
+  }
+  return typeof obj;
+}
+function formatValue(val, maxLen, depth, maxDepth) {
+  if (depth > maxDepth) return "{\u2026}";
+  if (val === null) return "null";
+  if (val === void 0) return "undefined";
+  if (typeof val === "string") {
+    const s = val.length > maxLen ? val.slice(0, maxLen) + "\u2026" : val;
+    return JSON.stringify(s);
+  }
+  if (typeof val === "number" || typeof val === "boolean" || typeof val === "bigint") return String(val);
+  if (typeof val === "symbol") return val.toString();
+  if (typeof val === "function") {
+    const name = val.name || "anonymous";
+    const src = Function.prototype.toString.call(val);
+    const argsMatch = src.match(/\(([^)]*)\)/);
+    const args = argsMatch ? argsMatch[1] : "";
+    return `\u0192 ${name}(${args})`;
+  }
+  if (val instanceof Date) return val.toISOString();
+  if (val instanceof RegExp) return val.toString();
+  if (val instanceof Error) return `${val.constructor.name}: ${val.message}`;
+  if (val instanceof Map) {
+    const entries2 = [...val.entries()].slice(0, 5).map(([k, v]) => `${formatValue(k, maxLen, depth + 1, maxDepth)} => ${formatValue(v, maxLen, depth + 1, maxDepth)}`);
+    const suffix2 = val.size > 5 ? `, \u2026 +${val.size - 5}` : "";
+    return `Map(${val.size}) { ${entries2.join(", ")}${suffix2} }`;
+  }
+  if (val instanceof Set) {
+    const items = [...val].slice(0, 5).map((v) => formatValue(v, maxLen, depth + 1, maxDepth));
+    const suffix2 = val.size > 5 ? `, \u2026 +${val.size - 5}` : "";
+    return `Set(${val.size}) { ${items.join(", ")}${suffix2} }`;
+  }
+  if (Array.isArray(val)) {
+    const items = val.slice(0, 5).map((v) => formatValue(v, maxLen, depth + 1, maxDepth));
+    const suffix2 = val.length > 5 ? `, \u2026 +${val.length - 5}` : "";
+    return `[${items.join(", ")}${suffix2}]`;
+  }
+  const keys = Object.keys(val).slice(0, 5);
+  const entries = keys.map((k) => `${k}: ${formatValue(val[k], maxLen, depth + 1, maxDepth)}`);
+  const allKeys = Object.keys(val);
+  const suffix = allKeys.length > 5 ? `, \u2026 +${allKeys.length - 5}` : "";
+  return `{ ${entries.join(", ")}${suffix} }`;
+}
+function getPrototypeChain(obj) {
+  const chain = [];
+  if (obj === null || obj === void 0 || typeof obj !== "object") return chain;
+  let proto = Object.getPrototypeOf(obj);
+  while (proto && proto !== Object.prototype) {
+    const name = proto.constructor?.name;
+    if (name && name !== "Object") chain.push(name);
+    proto = Object.getPrototypeOf(proto);
+  }
+  return chain;
+}
+function collectMembers(obj, opts) {
+  const members = [];
+  if (obj === null || obj === void 0) return members;
+  const seen = /* @__PURE__ */ new Set();
+  const processProperty = (name, target) => {
+    if (seen.has(name)) return;
+    if (!opts.private && name.startsWith("_") && !name.startsWith("__")) return;
+    if (!opts.dunder && name.startsWith("__")) return;
+    seen.add(name);
+    const desc = Object.getOwnPropertyDescriptor(target, name);
+    if (!desc) return;
+    if (desc.get || desc.set) {
+      let val = "";
+      let type2 = "unknown";
+      if (desc.get) {
+        try {
+          const v = desc.get.call(obj);
+          val = formatValue(v, opts.maxStringLength, 0, opts.maxDepth);
+          type2 = v === null ? "null" : typeof v;
+        } catch {
+          val = "<error>";
+          type2 = "getter";
+        }
+      }
+      members.push({ name, kind: desc.get ? "getter" : "setter", type: type2, value: val });
+      return;
+    }
+    if (typeof desc.value === "function") {
+      if (!opts.methods) return;
+      members.push({
+        name,
+        kind: "method",
+        type: "function",
+        value: formatValue(desc.value, opts.maxStringLength, 0, opts.maxDepth)
+      });
+      return;
+    }
+    const type = desc.value === null ? "null" : typeof desc.value;
+    members.push({
+      name,
+      kind: "property",
+      type: Array.isArray(desc.value) ? "Array" : desc.value instanceof Map ? "Map" : desc.value instanceof Set ? "Set" : type,
+      value: opts.values ? formatValue(desc.value, opts.maxStringLength, 0, opts.maxDepth) : ""
+    });
+  };
+  if (typeof obj === "object" || typeof obj === "function") {
+    for (const name of Object.getOwnPropertyNames(obj)) {
+      if (name === "constructor") continue;
+      processProperty(name, obj);
+    }
+  }
+  if (typeof obj === "object" && obj !== null) {
+    let proto = Object.getPrototypeOf(obj);
+    while (proto && proto !== Object.prototype) {
+      for (const name of Object.getOwnPropertyNames(proto)) {
+        if (name === "constructor") continue;
+        processProperty(name, proto);
+      }
+      proto = Object.getPrototypeOf(proto);
+    }
+  }
+  if (opts.sort) {
+    members.sort((a, b) => {
+      if (a.kind !== b.kind) {
+        const order = { property: 0, getter: 1, setter: 2, method: 3 };
+        return order[a.kind] - order[b.kind];
+      }
+      return a.name.localeCompare(b.name);
+    });
+  }
+  return members;
+}
+function renderTable(title, members, protoChain, c) {
+  const lines = [];
+  const nameWidth = Math.max(4, ...members.map((m) => m.name.length));
+  const typeWidth = Math.max(4, ...members.map((m) => m.type.length));
+  const totalInner = Math.max(60, nameWidth + typeWidth + 20);
+  lines.push(c.dim(`\u256D${"\u2500".repeat(totalInner + 2)}\u256E`));
+  const titlePad = totalInner - stripAnsi(title).length;
+  const leftPad = Math.floor(titlePad / 2);
+  const rightPad = titlePad - leftPad;
+  lines.push(c.dim("\u2502") + " ".repeat(leftPad + 1) + c.bold(c.cyan(title)) + " ".repeat(rightPad + 1) + c.dim("\u2502"));
+  if (protoChain.length > 0) {
+    const chain = `extends ${protoChain.join(" \u2192 ")}`;
+    const chainPad = totalInner - chain.length;
+    const clp = Math.floor(chainPad / 2);
+    const crp = chainPad - clp;
+    lines.push(c.dim("\u2502") + " ".repeat(clp + 1) + c.dim(chain) + " ".repeat(crp + 1) + c.dim("\u2502"));
+  }
+  lines.push(c.dim(`\u251C${"\u2500".repeat(totalInner + 2)}\u2524`));
+  if (members.length === 0) {
+    const msg = "(no members)";
+    const pad = totalInner - msg.length;
+    const lp = Math.floor(pad / 2);
+    const rp = pad - lp;
+    lines.push(c.dim("\u2502") + " ".repeat(lp + 1) + c.dim(msg) + " ".repeat(rp + 1) + c.dim("\u2502"));
+  } else {
+    for (const m of members) {
+      const icon = m.kind === "method" ? c.yellow("\u03BB") : m.kind === "getter" ? c.magenta("\u25CF") : m.kind === "setter" ? c.magenta("\u25CB") : c.green("\u2022");
+      const name = m.kind === "method" ? c.yellow(m.name) : c.white(m.name);
+      const type = c.dim(m.type);
+      const value = m.value ? ` ${c.brightBlack("=")} ${c.cyan(m.value)}` : "";
+      const content = ` ${icon} ${name} ${type}${value}`;
+      const contentLen = stripAnsi(content).length;
+      const rightSpace = Math.max(0, totalInner - contentLen);
+      lines.push(c.dim("\u2502") + content + " ".repeat(rightSpace + 2) + c.dim("\u2502"));
+    }
+  }
+  lines.push(c.dim(`\u2570${"\u2500".repeat(totalInner + 2)}\u256F`));
+  return lines.join("\n");
+}
+function renderJson(title, members, protoChain) {
+  return JSON.stringify({
+    type: title,
+    prototypeChain: protoChain,
+    members: members.map((m) => ({
+      name: m.name,
+      kind: m.kind,
+      type: m.type,
+      ...m.value ? { value: m.value } : {},
+      ...m.doc ? { doc: m.doc } : {}
+    }))
+  }, null, 2);
+}
+var defaults = {
+  methods: true,
+  private: false,
+  dunder: false,
+  docs: true,
+  values: true,
+  sort: true,
+  maxStringLength: 80,
+  maxDepth: 2,
+  json: false,
+  color: true,
+  title: "",
+  print: true
+};
+function inspect(obj, options) {
+  const opts = { ...defaults, ...options };
+  if (opts.color === true && options?.color === void 0) {
+    opts.color = isColorSupported();
+  }
+  const title = opts.title || getTypeName(obj);
+  const members = collectMembers(obj, opts);
+  const protoChain = getPrototypeChain(obj);
+  let output;
+  if (opts.json) {
+    output = renderJson(title, members, protoChain);
+  } else {
+    const c = withColor(opts.color);
+    output = renderTable(title, members, protoChain, c);
+  }
+  if (opts.print) {
+    console.log(output);
+  }
+  return output;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  inspect
+});

package/dist/index.mjs

@@ -0,0 +1,268 @@
+// src/ansi.ts
+var ESC = "\x1B[";
+var RESET = `${ESC}0m`;
+var color = (code) => (s) => `${ESC}${code}m${s}${RESET}`;
+var bold = color(1);
+var dim = color(2);
+var italic = color(3);
+var underline = color(4);
+var red = color(31);
+var green = color(32);
+var yellow = color(33);
+var blue = color(34);
+var magenta = color(35);
+var cyan = color(36);
+var white = color(37);
+var brightBlack = color(90);
+var brightRed = color(91);
+var brightGreen = color(92);
+var brightYellow = color(93);
+var brightBlue = color(94);
+var brightMagenta = color(95);
+var brightCyan = color(96);
+function stripAnsi(s) {
+  return s.replace(/\x1b\[[0-9;]*m/g, "");
+}
+function isColorSupported() {
+  if (typeof process === "undefined") return false;
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR) return true;
+  if (process.stdout && "isTTY" in process.stdout) return !!process.stdout.isTTY;
+  return false;
+}
+function withColor(enabled) {
+  if (enabled) return { bold, dim, italic, underline, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan };
+  const id = (s) => s;
+  return { bold: id, dim: id, italic: id, underline: id, red: id, green: id, yellow: id, blue: id, magenta: id, cyan: id, white: id, brightBlack: id, brightRed: id, brightGreen: id, brightYellow: id, brightBlue: id, brightMagenta: id, brightCyan: id };
+}
+
+// src/inspect.ts
+function getTypeName(obj) {
+  if (obj === null) return "null";
+  if (obj === void 0) return "undefined";
+  if (Array.isArray(obj)) return "Array";
+  if (obj instanceof Map) return "Map";
+  if (obj instanceof Set) return "Set";
+  if (obj instanceof Date) return "Date";
+  if (obj instanceof RegExp) return "RegExp";
+  if (obj instanceof Error) return obj.constructor.name;
+  if (typeof obj === "function") return obj.name ? `function ${obj.name}` : "function";
+  const proto = Object.getPrototypeOf(obj);
+  if (proto && proto.constructor && proto.constructor.name !== "Object") {
+    return proto.constructor.name;
+  }
+  return typeof obj;
+}
+function formatValue(val, maxLen, depth, maxDepth) {
+  if (depth > maxDepth) return "{\u2026}";
+  if (val === null) return "null";
+  if (val === void 0) return "undefined";
+  if (typeof val === "string") {
+    const s = val.length > maxLen ? val.slice(0, maxLen) + "\u2026" : val;
+    return JSON.stringify(s);
+  }
+  if (typeof val === "number" || typeof val === "boolean" || typeof val === "bigint") return String(val);
+  if (typeof val === "symbol") return val.toString();
+  if (typeof val === "function") {
+    const name = val.name || "anonymous";
+    const src = Function.prototype.toString.call(val);
+    const argsMatch = src.match(/\(([^)]*)\)/);
+    const args = argsMatch ? argsMatch[1] : "";
+    return `\u0192 ${name}(${args})`;
+  }
+  if (val instanceof Date) return val.toISOString();
+  if (val instanceof RegExp) return val.toString();
+  if (val instanceof Error) return `${val.constructor.name}: ${val.message}`;
+  if (val instanceof Map) {
+    const entries2 = [...val.entries()].slice(0, 5).map(([k, v]) => `${formatValue(k, maxLen, depth + 1, maxDepth)} => ${formatValue(v, maxLen, depth + 1, maxDepth)}`);
+    const suffix2 = val.size > 5 ? `, \u2026 +${val.size - 5}` : "";
+    return `Map(${val.size}) { ${entries2.join(", ")}${suffix2} }`;
+  }
+  if (val instanceof Set) {
+    const items = [...val].slice(0, 5).map((v) => formatValue(v, maxLen, depth + 1, maxDepth));
+    const suffix2 = val.size > 5 ? `, \u2026 +${val.size - 5}` : "";
+    return `Set(${val.size}) { ${items.join(", ")}${suffix2} }`;
+  }
+  if (Array.isArray(val)) {
+    const items = val.slice(0, 5).map((v) => formatValue(v, maxLen, depth + 1, maxDepth));
+    const suffix2 = val.length > 5 ? `, \u2026 +${val.length - 5}` : "";
+    return `[${items.join(", ")}${suffix2}]`;
+  }
+  const keys = Object.keys(val).slice(0, 5);
+  const entries = keys.map((k) => `${k}: ${formatValue(val[k], maxLen, depth + 1, maxDepth)}`);
+  const allKeys = Object.keys(val);
+  const suffix = allKeys.length > 5 ? `, \u2026 +${allKeys.length - 5}` : "";
+  return `{ ${entries.join(", ")}${suffix} }`;
+}
+function getPrototypeChain(obj) {
+  const chain = [];
+  if (obj === null || obj === void 0 || typeof obj !== "object") return chain;
+  let proto = Object.getPrototypeOf(obj);
+  while (proto && proto !== Object.prototype) {
+    const name = proto.constructor?.name;
+    if (name && name !== "Object") chain.push(name);
+    proto = Object.getPrototypeOf(proto);
+  }
+  return chain;
+}
+function collectMembers(obj, opts) {
+  const members = [];
+  if (obj === null || obj === void 0) return members;
+  const seen = /* @__PURE__ */ new Set();
+  const processProperty = (name, target) => {
+    if (seen.has(name)) return;
+    if (!opts.private && name.startsWith("_") && !name.startsWith("__")) return;
+    if (!opts.dunder && name.startsWith("__")) return;
+    seen.add(name);
+    const desc = Object.getOwnPropertyDescriptor(target, name);
+    if (!desc) return;
+    if (desc.get || desc.set) {
+      let val = "";
+      let type2 = "unknown";
+      if (desc.get) {
+        try {
+          const v = desc.get.call(obj);
+          val = formatValue(v, opts.maxStringLength, 0, opts.maxDepth);
+          type2 = v === null ? "null" : typeof v;
+        } catch {
+          val = "<error>";
+          type2 = "getter";
+        }
+      }
+      members.push({ name, kind: desc.get ? "getter" : "setter", type: type2, value: val });
+      return;
+    }
+    if (typeof desc.value === "function") {
+      if (!opts.methods) return;
+      members.push({
+        name,
+        kind: "method",
+        type: "function",
+        value: formatValue(desc.value, opts.maxStringLength, 0, opts.maxDepth)
+      });
+      return;
+    }
+    const type = desc.value === null ? "null" : typeof desc.value;
+    members.push({
+      name,
+      kind: "property",
+      type: Array.isArray(desc.value) ? "Array" : desc.value instanceof Map ? "Map" : desc.value instanceof Set ? "Set" : type,
+      value: opts.values ? formatValue(desc.value, opts.maxStringLength, 0, opts.maxDepth) : ""
+    });
+  };
+  if (typeof obj === "object" || typeof obj === "function") {
+    for (const name of Object.getOwnPropertyNames(obj)) {
+      if (name === "constructor") continue;
+      processProperty(name, obj);
+    }
+  }
+  if (typeof obj === "object" && obj !== null) {
+    let proto = Object.getPrototypeOf(obj);
+    while (proto && proto !== Object.prototype) {
+      for (const name of Object.getOwnPropertyNames(proto)) {
+        if (name === "constructor") continue;
+        processProperty(name, proto);
+      }
+      proto = Object.getPrototypeOf(proto);
+    }
+  }
+  if (opts.sort) {
+    members.sort((a, b) => {
+      if (a.kind !== b.kind) {
+        const order = { property: 0, getter: 1, setter: 2, method: 3 };
+        return order[a.kind] - order[b.kind];
+      }
+      return a.name.localeCompare(b.name);
+    });
+  }
+  return members;
+}
+function renderTable(title, members, protoChain, c) {
+  const lines = [];
+  const nameWidth = Math.max(4, ...members.map((m) => m.name.length));
+  const typeWidth = Math.max(4, ...members.map((m) => m.type.length));
+  const totalInner = Math.max(60, nameWidth + typeWidth + 20);
+  lines.push(c.dim(`\u256D${"\u2500".repeat(totalInner + 2)}\u256E`));
+  const titlePad = totalInner - stripAnsi(title).length;
+  const leftPad = Math.floor(titlePad / 2);
+  const rightPad = titlePad - leftPad;
+  lines.push(c.dim("\u2502") + " ".repeat(leftPad + 1) + c.bold(c.cyan(title)) + " ".repeat(rightPad + 1) + c.dim("\u2502"));
+  if (protoChain.length > 0) {
+    const chain = `extends ${protoChain.join(" \u2192 ")}`;
+    const chainPad = totalInner - chain.length;
+    const clp = Math.floor(chainPad / 2);
+    const crp = chainPad - clp;
+    lines.push(c.dim("\u2502") + " ".repeat(clp + 1) + c.dim(chain) + " ".repeat(crp + 1) + c.dim("\u2502"));
+  }
+  lines.push(c.dim(`\u251C${"\u2500".repeat(totalInner + 2)}\u2524`));
+  if (members.length === 0) {
+    const msg = "(no members)";
+    const pad = totalInner - msg.length;
+    const lp = Math.floor(pad / 2);
+    const rp = pad - lp;
+    lines.push(c.dim("\u2502") + " ".repeat(lp + 1) + c.dim(msg) + " ".repeat(rp + 1) + c.dim("\u2502"));
+  } else {
+    for (const m of members) {
+      const icon = m.kind === "method" ? c.yellow("\u03BB") : m.kind === "getter" ? c.magenta("\u25CF") : m.kind === "setter" ? c.magenta("\u25CB") : c.green("\u2022");
+      const name = m.kind === "method" ? c.yellow(m.name) : c.white(m.name);
+      const type = c.dim(m.type);
+      const value = m.value ? ` ${c.brightBlack("=")} ${c.cyan(m.value)}` : "";
+      const content = ` ${icon} ${name} ${type}${value}`;
+      const contentLen = stripAnsi(content).length;
+      const rightSpace = Math.max(0, totalInner - contentLen);
+      lines.push(c.dim("\u2502") + content + " ".repeat(rightSpace + 2) + c.dim("\u2502"));
+    }
+  }
+  lines.push(c.dim(`\u2570${"\u2500".repeat(totalInner + 2)}\u256F`));
+  return lines.join("\n");
+}
+function renderJson(title, members, protoChain) {
+  return JSON.stringify({
+    type: title,
+    prototypeChain: protoChain,
+    members: members.map((m) => ({
+      name: m.name,
+      kind: m.kind,
+      type: m.type,
+      ...m.value ? { value: m.value } : {},
+      ...m.doc ? { doc: m.doc } : {}
+    }))
+  }, null, 2);
+}
+var defaults = {
+  methods: true,
+  private: false,
+  dunder: false,
+  docs: true,
+  values: true,
+  sort: true,
+  maxStringLength: 80,
+  maxDepth: 2,
+  json: false,
+  color: true,
+  title: "",
+  print: true
+};
+function inspect(obj, options) {
+  const opts = { ...defaults, ...options };
+  if (opts.color === true && options?.color === void 0) {
+    opts.color = isColorSupported();
+  }
+  const title = opts.title || getTypeName(obj);
+  const members = collectMembers(obj, opts);
+  const protoChain = getPrototypeChain(obj);
+  let output;
+  if (opts.json) {
+    output = renderJson(title, members, protoChain);
+  } else {
+    const c = withColor(opts.color);
+    output = renderTable(title, members, protoChain, c);
+  }
+  if (opts.print) {
+    console.log(output);
+  }
+  return output;
+}
+export {
+  inspect
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@indiekitai/inspect",
+  "version": "0.1.0",
+  "description": "Rich-style inspect() for JavaScript/TypeScript - pretty-print any object's attributes, methods, and docs",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "bin": {
+    "inspect": "./dist/cli.mjs"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["inspect", "debug", "pretty-print", "rich", "developer-tools"],
+  "author": "IndieKit AI",
+  "license": "MIT",
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  }
+}