shivenverma 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shiven Verma
+
+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/README.md

@@ -0,0 +1,119 @@
+# shivenverma
+
+An interactive terminal portfolio for **Shiven Verma** — a small, keyboard-driven
+TUI that runs in your terminal. Built with Node.js, React, and [Ink](https://github.com/vadimdemedes/ink).
+
+```
+   _____ __  _______    _________   __   _    ____________  __  ______
+  / ___// / / /  _/ |  / / ____/ | / /  | |  / / ____/ __ \/  |/  /   |
+  \__ \/ /_/ // / | | / / __/ /  |/ /   | | / / __/ / /_/ / /|_/ / /| |
+ ___/ / __  // /  | |/ / /___/ /|  /    | |/ / /___/ _, _/ /  / / ___ |
+/____/_/ /_/___/  |___/_____/_/ |_/     |___/_____/_/ |_/_/  /_/_/  |_|
+```
+
+## Run it
+
+Once published to npm, it runs with no install step:
+
+```bash
+npx shivenverma
+```
+
+Until then (or to run from a clone), see [Development](#development) below.
+
+> Requires **Node.js 18+**.
+
+## Using it
+
+The interface is keyboard-first.
+
+| Key | Action |
+| --- | --- |
+| `↑` `↓` / `k` `j` | Move the selection |
+| `⏎` Enter | Open the selected item |
+| `Esc` | Go back |
+| `:` | Open the command bar |
+| `q` | Quit |
+
+### Command bar
+
+Press `:` from anywhere and type a command:
+
+```
+about  skills  projects  github  contact  resume  home  clear  help  exit
+```
+
+`help` lists everything. Unknown commands report back instead of failing.
+
+### Sections
+
+- **About** — a short intro and current areas of focus
+- **Skills** — languages, frameworks, and tools (no made-up proficiency bars)
+- **Projects** — a selectable list; open one for details and links
+- **GitHub** — profile link, opens in your browser
+- **Contact** — configured contact channels
+- **Resume** — opens your resume link when configured
+
+Links open in your default browser via the OS handler (`open` / `start` /
+`xdg-open`). If no browser can be launched, the URL is shown so you can copy it —
+the app never crashes on a failed open.
+
+## Make it yours
+
+All content lives in one file: [`src/data/portfolio.js`](src/data/portfolio.js).
+Edit values there and rebuild — no component code needs to change.
+
+Values written as `REPLACE_WITH_*` (or left empty) are treated as **not
+configured**: the UI shows a tasteful fallback instead of a broken link. Search
+the file for `REPLACE_WITH` to find everything still to fill in. At the time of
+writing that includes:
+
+- `links.linkedin`, `links.email`, `links.resume`
+- `location` (optional)
+- Each project's `links` (repo / docs / live URLs) and, for the placeholder
+  projects, their `description` and `tech`
+
+The GitHub username is already set to `shivenverma`.
+
+## Development
+
+From a clone of the repository:
+
+```bash
+npm install      # install dependencies
+npm run dev      # build, then launch the portfolio
+```
+
+Other scripts:
+
+```bash
+npm run build    # bundle src/ -> dist/cli.js with esbuild
+npm start        # run the built CLI (bin/cli.js)
+npm test         # build, then run the smoke test
+npm run banner   # regenerate the ASCII wordmark (src/data/banner.js)
+npm run package  # build and create a local .tgz tarball
+```
+
+### How it's built
+
+- **[Ink](https://github.com/vadimdemedes/ink) + React** render the UI to the terminal.
+- **esbuild** bundles `src/` into a single `dist/cli.js`. React and Ink stay as
+  runtime dependencies (installed by npm); only the app's own code is bundled.
+- The ASCII wordmark is generated once at build time with
+  [figlet](https://github.com/patorjk/figlet.js) and committed as plain data
+  ([`src/data/banner.js`](src/data/banner.js)), so there's no font loading at runtime.
+- The layout is responsive: the wordmark steps down through smaller fonts (and a
+  plain-text fallback) as the terminal narrows, and dense sections compact on
+  short terminals.
+
+### Flags
+
+```
+shivenverma --help        show help
+shivenverma --version     print the version
+shivenverma --no-startup  skip the boot animation
+```
+
+## License
+
+[MIT](LICENSE) © Shiven Verma

package/bin/cli.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Executable entry point. Loads the prebuilt bundle so end users never need a
+ * JSX toolchain — `npm run build` produces dist/cli.js.
+ */
+import './../dist/cli.js';

package/dist/cli.js

@@ -0,0 +1,1103 @@
+// src/index.jsx
+import React21 from "react";
+import { render } from "ink";
+
+// src/App.jsx
+import React20, { useState as useState5 } from "react";
+import { Box as Box18, Text as Text18, useApp } from "ink";
+
+// src/theme/theme.js
+var theme = {
+  colors: {
+    // Text
+    primary: "#e6edf3",
+    // main foreground
+    secondary: "#8b949e",
+    // muted / supporting text
+    faint: "#6e7681",
+    // hints, separators, disabled
+    // Accents
+    accent: "#3fb950",
+    // green — selection, success, brand
+    accentDim: "#2ea043",
+    // green, slightly deeper
+    link: "#58a6ff",
+    // blue — links only
+    warning: "#d29922",
+    // muted amber — warnings / not-configured
+    // Surfaces
+    border: "#30363d"
+    // subtle rules and panel edges
+  },
+  // Glyphs kept to a small, widely-supported set.
+  glyphs: {
+    pointer: "\u203A",
+    bullet: "\u2022",
+    arrow: "\u2192",
+    check: "\u2713",
+    dot: "\xB7",
+    corner: "\u2514",
+    vbar: "\u2502"
+  },
+  // Layout constants (in columns).
+  layout: {
+    indent: 3,
+    // left gutter for content
+    maxWidth: 76,
+    // content never grows wider than this
+    minWidth: 44
+    // below this we drop into a compact layout
+  }
+};
+var theme_default = theme;
+
+// src/data/portfolio.js
+var GITHUB_USERNAME = "shivenverma";
+var portfolio = {
+  name: "Shiven Verma",
+  role: "Developer \u2022 Builder \u2022 Problem Solver",
+  tagline: "I build software, experiment with technology, and solve interesting problems.",
+  location: "Noida, India",
+  // e.g. "Delhi, India" — optional
+  // About screen. Each string is rendered as its own paragraph.
+  about: [
+    "I'm Shiven \u2014 a developer who likes building things, taking them apart, and understanding how they work.",
+    "I care about software that feels considered: tools that are pleasant to use and code that is a pleasure to read.",
+    "This portfolio is itself a small project. Everything you see lives in one data file, so it grows as I do."
+  ],
+  // Short list of what you're currently into. Keep these honest and editable.
+  focus: [
+    "Developer tooling and productivity",
+    "Full-stack web development",
+    "Automation and small, sharp utilities",
+    "AI-assisted software"
+  ],
+  // Skills grouped by category. Add or remove categories freely — the Skills
+  // screen renders whatever is here. No fake proficiency percentages.
+  skills: {
+    Languages: ["Java", "JavaScript", "Python", "C++", "SQL"],
+    Frontend: ["React", "HTML", "CSS"],
+    Backend: ["Node.js"],
+    Tools: ["Git", "GitHub", "VS Code"]
+  },
+  // Projects. Each entry becomes a selectable card in the Projects screen.
+  // links: any value that is empty or REPLACE_WITH_* is shown as "not linked".
+  projects: [
+    {
+      id: "gfghub",
+      name: "GFGHub",
+      summary: "Organize coding problems solved across GeeksforGeeks.",
+      description: "A developer productivity extension designed to organize coding problems solved across GeeksforGeeks, keeping your practice history in one place.",
+      tech: ["JavaScript", "Chrome Extensions", "GitHub API"],
+      status: "In Development",
+      links: {
+        github: "https://github.com/harshitcodes1308/gfg_hub_extension.git",
+        docs: "REPLACE_WITH_GFGHUB_DOCS_URL",
+        live: ""
+      }
+    },
+    {
+      id: "batcave-experience",
+      name: "Batcave Experience",
+      summary: "An immersive personal music room where a curated YouTube playlist plays inside a painted 2D version of my flat.",
+      description: "Batcave Music is an immersive music experience inspired by themed web radio sites. It recreates my flat as a painted 2D environment, plays a curated YouTube playlist, and lets visitors manually change the room lighting between purple, crimson, and amber moods. I built it to explore immersive web experiences, custom music-player interactions, responsive UI, and realtime presence.",
+      tech: [
+        "React",
+        "TypeScript",
+        "Vite",
+        "YouTube IFrame Player API",
+        "Supabase Realtime"
+      ],
+      status: "Deployed",
+      links: {
+        github: "https://github.com/shivenverma/Batcave-Experience.git",
+        live: "https://www.batcaveexperience.studio/"
+      }
+    }
+  ],
+  // GitHub section. The username is known; stats can be wired to the live API
+  // later (see src/utils/github.js) without changing this file.
+  github: {
+    username: GITHUB_USERNAME,
+    url: `https://github.com/shivenverma`,
+    blurb: "Open-source experiments, side projects, and the occasional useful tool."
+  },
+  // Contact + external links. mailto: is added automatically for email.
+  links: {
+    github: `https://github.com/shivenverma`,
+    linkedin: "https://www.linkedin.com/in/shiven-verma-24b5862a2/",
+    email: "shivenverma022@gmail.com",
+    resume: ""
+  }
+};
+var portfolio_default = portfolio;
+
+// src/utils/commands.js
+var COMMANDS = [
+  { name: "about", screen: "about", description: "About me" },
+  { name: "skills", screen: "skills", description: "Technical skills" },
+  { name: "projects", screen: "projects", description: "View projects" },
+  { name: "github", screen: "github", description: "GitHub profile" },
+  { name: "contact", screen: "contact", description: "Contact information" },
+  { name: "resume", screen: "resume", description: "Resume" },
+  { name: "home", screen: "home", description: "Main menu" },
+  { name: "clear", action: "clear", description: "Clear the screen" },
+  { name: "help", screen: "help", description: "Show commands" },
+  { name: "exit", action: "exit", description: "Exit portfolio" }
+];
+var ALIASES = {
+  quit: "exit",
+  q: "exit",
+  back: "home",
+  ls: "projects",
+  "?": "help",
+  man: "help"
+};
+var EASTER_EGGS = /* @__PURE__ */ new Set(["sudo shiven", "sudo make me a sandwich", "sudo", "whoami"]);
+function matchCommand(rawInput) {
+  const input = rawInput.trim().toLowerCase().replace(/\s+/g, " ");
+  if (input.length === 0) return { type: "noop" };
+  if (EASTER_EGGS.has(input)) return { type: "action", action: "easter-egg" };
+  const name = ALIASES[input] ?? input;
+  const command = COMMANDS.find((c) => c.name === name);
+  if (!command) return { type: "unknown", input: rawInput.trim() };
+  if (command.screen) return { type: "screen", screen: command.screen };
+  return { type: "action", action: command.action };
+}
+
+// src/utils/browser.js
+import { spawn } from "node:child_process";
+function openUrl(url) {
+  return new Promise((resolve) => {
+    let settled = false;
+    const finish = (result) => {
+      if (!settled) {
+        settled = true;
+        resolve(result);
+      }
+    };
+    if (typeof url !== "string" || url.trim().length === 0) {
+      finish({ ok: false, error: "No URL to open." });
+      return;
+    }
+    try {
+      const child = spawnHandler(url.trim());
+      child.once("error", (err) => finish({ ok: false, error: err.message }));
+      child.unref();
+      setTimeout(() => finish({ ok: true }), 150);
+    } catch (err) {
+      finish({ ok: false, error: err.message });
+    }
+  });
+}
+function spawnHandler(url) {
+  const options = { stdio: "ignore", detached: true };
+  if (process.platform === "darwin") {
+    return spawn("open", [url], options);
+  }
+  if (process.platform === "win32") {
+    const escaped = url.replace(/[&|<>^]/g, "^$&");
+    return spawn("cmd", ["/c", "start", '""', escaped], {
+      ...options,
+      windowsVerbatimArguments: true,
+      windowsHide: true
+    });
+  }
+  return spawn("xdg-open", [url], options);
+}
+
+// src/hooks/useSafeInput.js
+import { useInput, useStdin } from "ink";
+function useSafeInput(handler, options = {}) {
+  const { isRawModeSupported } = useStdin();
+  const isActive = Boolean((options.isActive ?? true) && isRawModeSupported);
+  useInput(handler, { ...options, isActive });
+}
+var useSafeInput_default = useSafeInput;
+
+// src/utils/terminal.js
+var PLACEHOLDER_PREFIX = "REPLACE_WITH";
+function isConfigured(value) {
+  if (typeof value !== "string") return Boolean(value);
+  const trimmed = value.trim();
+  if (trimmed.length === 0) return false;
+  return !trimmed.toUpperCase().startsWith(PLACEHOLDER_PREFIX);
+}
+function configuredList(list) {
+  if (!Array.isArray(list)) return [];
+  return list.filter(isConfigured);
+}
+function toMailto(email) {
+  if (!email) return "";
+  return email.startsWith("mailto:") ? email : `mailto:${email}`;
+}
+function clamp(value, min, max) {
+  return Math.max(min, Math.min(max, value));
+}
+function wrapWords(text, width) {
+  const safeWidth = Math.max(1, Math.floor(width) || 1);
+  const lines = [];
+  let line = "";
+  const flush = () => {
+    lines.push(line);
+    line = "";
+  };
+  for (const raw of String(text).split(/\s+/).filter(Boolean)) {
+    let word = raw;
+    while (word.length > safeWidth) {
+      if (line) flush();
+      lines.push(word.slice(0, safeWidth));
+      word = word.slice(safeWidth);
+    }
+    if (!line) line = word;
+    else if (line.length + 1 + word.length <= safeWidth) line += ` ${word}`;
+    else {
+      flush();
+      line = word;
+    }
+  }
+  if (line) flush();
+  return lines.length > 0 ? lines : [""];
+}
+
+// src/hooks/useTerminalSize.js
+import { useState, useEffect } from "react";
+function useTerminalSize() {
+  const [size, setSize] = useState(() => read());
+  useEffect(() => {
+    const onResize = () => setSize(read());
+    process.stdout.on("resize", onResize);
+    return () => process.stdout.off("resize", onResize);
+  }, []);
+  return size;
+}
+function read() {
+  return {
+    columns: process.stdout.columns || 80,
+    rows: process.stdout.rows || 24
+  };
+}
+
+// src/hooks/useLayout.js
+function useLayout() {
+  const { columns, rows } = useTerminalSize();
+  const indent = columns < 40 ? 1 : theme_default.layout.indent;
+  const width = clamp(columns - indent * 2, 16, theme_default.layout.maxWidth);
+  const compact = columns < theme_default.layout.minWidth || rows < 20;
+  return { columns, rows, indent, width, compact };
+}
+var useLayout_default = useLayout;
+
+// src/components/Startup.jsx
+import React, { useEffect as useEffect2, useRef, useState as useState2 } from "react";
+import { Box, Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+var STEPS = ["Loading profile", "Loading projects", "Loading skills", "Connecting to portfolio"];
+var SPINNER = "\u280B\u2819\u2839\u2838\u283C\u2834\u2826\u2827\u2807\u280F".split("");
+var STEP_MS = 120;
+var READY_MS = 320;
+function Startup({ onComplete }) {
+  const { indent } = useLayout_default();
+  const [step, setStep] = useState2(0);
+  const [frame, setFrame] = useState2(0);
+  const done = useRef(false);
+  const finish = () => {
+    if (!done.current) {
+      done.current = true;
+      onComplete();
+    }
+  };
+  useEffect2(() => {
+    if (step >= STEPS.length) {
+      const t2 = setTimeout(finish, READY_MS);
+      return () => clearTimeout(t2);
+    }
+    const t = setTimeout(() => setStep((s) => s + 1), step === 0 ? 240 : STEP_MS);
+    return () => clearTimeout(t);
+  }, [step]);
+  useEffect2(() => {
+    const t = setInterval(() => setFrame((f) => (f + 1) % SPINNER.length), 80);
+    return () => clearInterval(t);
+  }, []);
+  useSafeInput_default(() => finish());
+  const complete = step >= STEPS.length;
+  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", paddingX: indent, paddingY: 1, children: [
+    /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx(Text, { color: theme_default.colors.primary, bold: true, children: "Initializing ShivenOS" }),
+      /* @__PURE__ */ jsx(Text, { color: theme_default.colors.faint, children: "\u2026" })
+    ] }),
+    STEPS.map((label, i) => {
+      const isDone = i < step;
+      const isCurrent = i === step && !complete;
+      return /* @__PURE__ */ jsxs(Box, { children: [
+        /* @__PURE__ */ jsx(Text, { color: isDone ? theme_default.colors.accent : theme_default.colors.faint, children: isDone ? `${theme_default.glyphs.check} ` : isCurrent ? `${SPINNER[frame]} ` : "  " }),
+        /* @__PURE__ */ jsx(
+          Text,
+          {
+            color: isDone ? theme_default.colors.secondary : isCurrent ? theme_default.colors.primary : theme_default.colors.faint,
+            children: label
+          }
+        )
+      ] }, label);
+    }),
+    /* @__PURE__ */ jsx(Box, { marginTop: 1, children: complete ? /* @__PURE__ */ jsx(Text, { color: theme_default.colors.accent, children: "System ready." }) : /* @__PURE__ */ jsx(Text, { color: theme_default.colors.faint, children: "press any key to skip" }) })
+  ] });
+}
+var Startup_default = Startup;
+
+// src/components/Home.jsx
+import React7 from "react";
+import { Box as Box6 } from "ink";
+
+// src/components/Header.jsx
+import React2 from "react";
+import { Box as Box2, Text as Text2 } from "ink";
+
+// src/data/banner.js
+var BANNER_TIERS = [
+  { minColumns: 74, text: "   _____ __  _______    _________   __   _    ____________  __  ______\n  / ___// / / /  _/ |  / / ____/ | / /  | |  / / ____/ __ \\/  |/  /   |\n  \\__ \\/ /_/ // / | | / / __/ /  |/ /   | | / / __/ / /_/ / /|_/ / /| |\n ___/ / __  // /  | |/ / /___/ /|  /    | |/ / /___/ _, _/ /  / / ___ |\n/____/_/ /_/___/  |___/_____/_/ |_/     |___/_____/_/ |_/_/  /_/_/  |_|" },
+  { minColumns: 62, text: "   ______ _______   _______  __  _   _________  __  ______\n  / __/ // /  _/ | / / __/ |/ / | | / / __/ _ \\/  |/  / _ |\n _\\ \\/ _  // / | |/ / _//    /  | |/ / _// , _/ /|_/ / __ |\n/___/_//_/___/ |___/___/_/|_/   |___/___/_/|_/_/  /_/_/ |_|" },
+  { minColumns: 34, text: "  ___ _  _ _____   _____ _  _\n / __| || |_ _\\ \\ / / __| \\| |\n \\__ \\ __ || | \\ V /| _|| .` |\n |___/_||_|___| \\_/ |___|_|\\_|\n \\ \\ / / __| _ \\  \\/  | /_\\\n  \\ V /| _||   / |\\/| |/ _ \\\n   \\_/ |___|_|_\\_|  |_/_/ \\_\\" }
+];
+function selectBanner(columns) {
+  const tier = BANNER_TIERS.find((t) => columns >= t.minColumns);
+  return tier ? tier.text : null;
+}
+
+// src/components/Header.jsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function Header({ columns, width, compact }) {
+  const banner = selectBanner(columns);
+  const roleParts = portfolio_default.role.split(" \u2022 ");
+  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
+    banner ? /* @__PURE__ */ jsx2(Text2, { color: theme_default.colors.primary, children: banner }) : /* @__PURE__ */ jsx2(Text2, { color: theme_default.colors.primary, bold: true, children: portfolio_default.name.toUpperCase() }),
+    /* @__PURE__ */ jsx2(Box2, { marginTop: 1, children: /* @__PURE__ */ jsx2(Text2, { children: roleParts.map((part, i) => /* @__PURE__ */ jsxs2(Text2, { children: [
+      i > 0 ? /* @__PURE__ */ jsxs2(Text2, { color: theme_default.colors.accent, children: [
+        " ",
+        theme_default.glyphs.bullet,
+        " "
+      ] }) : null,
+      /* @__PURE__ */ jsx2(Text2, { color: theme_default.colors.secondary, children: part })
+    ] }, part)) }) }),
+    !compact ? /* @__PURE__ */ jsx2(Box2, { marginTop: 1, width, children: /* @__PURE__ */ jsx2(Text2, { color: theme_default.colors.faint, wrap: "wrap", children: portfolio_default.tagline }) }) : null
+  ] });
+}
+var Header_default = Header;
+
+// src/components/Navigation.jsx
+import React4 from "react";
+import { Box as Box4 } from "ink";
+
+// src/hooks/useSelection.js
+import { useState as useState3, useEffect as useEffect3, useCallback } from "react";
+function useSelection(length, { initial = 0, wrap = true } = {}) {
+  const [index, setIndex] = useState3(initial);
+  useEffect3(() => {
+    setIndex((current) => current >= length ? Math.max(0, length - 1) : current);
+  }, [length]);
+  const move = useCallback(
+    (delta) => {
+      setIndex((current) => {
+        if (length <= 0) return 0;
+        const next = current + delta;
+        if (wrap) return (next + length) % length;
+        return Math.max(0, Math.min(length - 1, next));
+      });
+    },
+    [length, wrap]
+  );
+  return { index, setIndex, move };
+}
+var useSelection_default = useSelection;
+
+// src/components/SelectableList.jsx
+import React3 from "react";
+import { Box as Box3, Text as Text3 } from "ink";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+function SelectableList({ items, index, inline = false }) {
+  const labelWidth = inline ? 0 : items.reduce((max, item) => Math.max(max, item.label.length), 0);
+  return /* @__PURE__ */ jsx3(Box3, { flexDirection: "column", children: items.map((item, i) => {
+    const selected = i === index;
+    const pointer = selected ? `${theme_default.glyphs.pointer} ` : "  ";
+    const labelColor = item.muted ? theme_default.colors.faint : selected ? theme_default.colors.primary : theme_default.colors.secondary;
+    const label = inline || !item.hint ? item.label : item.label.padEnd(labelWidth);
+    const hintText = item.hint ? inline ? `  ${theme_default.glyphs.dot} ${item.hint}` : `    ${item.hint}` : "";
+    return /* @__PURE__ */ jsxs3(Text3, { wrap: "truncate-end", children: [
+      /* @__PURE__ */ jsx3(Text3, { color: selected ? theme_default.colors.accent : theme_default.colors.faint, children: pointer }),
+      /* @__PURE__ */ jsx3(Text3, { bold: selected, color: labelColor, children: label }),
+      hintText ? /* @__PURE__ */ jsx3(Text3, { color: theme_default.colors.faint, children: hintText }) : null
+    ] }, item.key ?? item.label);
+  }) });
+}
+var SelectableList_default = SelectableList;
+
+// src/components/Navigation.jsx
+import { jsx as jsx4 } from "react/jsx-runtime";
+var MENU = [
+  { label: "About", hint: "Who I am", screen: "about" },
+  { label: "Skills", hint: "Languages, frameworks & tools", screen: "skills" },
+  { label: "Projects", hint: "Things I've built", screen: "projects" },
+  { label: "GitHub", hint: `github.com/${portfolio_default.github.username}`, screen: "github" },
+  { label: "Contact", hint: "Get in touch", screen: "contact" },
+  { label: "Resume", hint: "View my resume", screen: "resume" },
+  { label: "Exit", hint: "Close the portfolio", action: "exit" }
+];
+function Navigation({ isActive, onNavigate, onQuit }) {
+  const { index, move } = useSelection_default(MENU.length);
+  useSafeInput_default(
+    (input, key) => {
+      if (key.upArrow || input === "k") move(-1);
+      else if (key.downArrow || input === "j") move(1);
+      else if (key.return) {
+        const item = MENU[index];
+        if (item.action === "exit") onQuit();
+        else onNavigate(item.screen);
+      }
+    },
+    { isActive }
+  );
+  return /* @__PURE__ */ jsx4(Box4, { flexDirection: "column", children: /* @__PURE__ */ jsx4(SelectableList_default, { items: MENU, index }) });
+}
+var Navigation_default = Navigation;
+
+// src/components/Rule.jsx
+import React5 from "react";
+import { Text as Text4 } from "ink";
+import { jsx as jsx5 } from "react/jsx-runtime";
+function Rule({ width, color = theme_default.colors.border, char = "\u2500" }) {
+  return /* @__PURE__ */ jsx5(Text4, { color, children: char.repeat(Math.max(0, width)) });
+}
+var Rule_default = Rule;
+
+// src/components/Footer.jsx
+import React6 from "react";
+import { Box as Box5, Text as Text5 } from "ink";
+import { jsx as jsx6, jsxs as jsxs4 } from "react/jsx-runtime";
+function Footer({ hints }) {
+  return /* @__PURE__ */ jsx6(Box5, { flexWrap: "wrap", children: hints.map((hint, i) => /* @__PURE__ */ jsxs4(Box5, { children: [
+    i > 0 ? /* @__PURE__ */ jsxs4(Text5, { color: theme_default.colors.border, children: [
+      " ",
+      theme_default.glyphs.dot,
+      " "
+    ] }) : null,
+    /* @__PURE__ */ jsxs4(Text5, { color: theme_default.colors.secondary, children: [
+      hint.key,
+      " "
+    ] }),
+    /* @__PURE__ */ jsx6(Text5, { color: theme_default.colors.faint, children: hint.label })
+  ] }, hint.key)) });
+}
+var Footer_default = Footer;
+
+// src/components/Home.jsx
+import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
+var HOME_HINTS = [
+  { key: "\u2191\u2193", label: "navigate" },
+  { key: "\u23CE", label: "select" },
+  { key: ":", label: "command" },
+  { key: "q", label: "quit" }
+];
+function Home({ isActive, onNavigate, onQuit }) {
+  const { indent, width, columns, compact } = useLayout_default();
+  return /* @__PURE__ */ jsxs5(Box6, { flexDirection: "column", paddingX: indent, paddingY: 1, width: width + indent * 2, children: [
+    /* @__PURE__ */ jsx7(Header_default, { columns, width, compact }),
+    /* @__PURE__ */ jsx7(Box6, { marginY: 1, width, children: /* @__PURE__ */ jsx7(Rule_default, { width }) }),
+    /* @__PURE__ */ jsx7(Navigation_default, { isActive, onNavigate, onQuit }),
+    /* @__PURE__ */ jsx7(Box6, { marginTop: 1, width, children: /* @__PURE__ */ jsx7(Rule_default, { width }) }),
+    /* @__PURE__ */ jsx7(Box6, { marginTop: 1, children: /* @__PURE__ */ jsx7(Footer_default, { hints: HOME_HINTS }) })
+  ] });
+}
+var Home_default = Home;
+
+// src/components/About.jsx
+import React10 from "react";
+import { Box as Box8, Text as Text8 } from "ink";
+
+// src/components/Screen.jsx
+import React8 from "react";
+import { Box as Box7, Text as Text6 } from "ink";
+import { jsx as jsx8, jsxs as jsxs6 } from "react/jsx-runtime";
+function Screen({ title, breadcrumb, hints, children }) {
+  const { indent, width } = useLayout_default();
+  return /* @__PURE__ */ jsxs6(Box7, { flexDirection: "column", paddingX: indent, paddingY: 1, width: width + indent * 2, children: [
+    /* @__PURE__ */ jsxs6(Box7, { marginBottom: 1, children: [
+      /* @__PURE__ */ jsx8(Text6, { color: theme_default.colors.accent, children: portfolio_default.name }),
+      breadcrumb ? /* @__PURE__ */ jsxs6(Text6, { color: theme_default.colors.faint, children: [
+        "  ",
+        theme_default.glyphs.pointer,
+        " ",
+        breadcrumb
+      ] }) : null
+    ] }),
+    title ? /* @__PURE__ */ jsx8(Box7, { marginBottom: 1, children: /* @__PURE__ */ jsx8(Text6, { color: theme_default.colors.accent, bold: true, children: title }) }) : null,
+    /* @__PURE__ */ jsx8(Box7, { flexDirection: "column", width, children }),
+    /* @__PURE__ */ jsx8(Box7, { marginTop: 1, flexDirection: "column", width, children: /* @__PURE__ */ jsx8(Rule_default, { width }) }),
+    /* @__PURE__ */ jsx8(Box7, { marginTop: 1, children: /* @__PURE__ */ jsx8(Footer_default, { hints }) })
+  ] });
+}
+var Screen_default = Screen;
+
+// src/components/Paragraph.jsx
+import React9 from "react";
+import { Text as Text7 } from "ink";
+import { jsx as jsx9 } from "react/jsx-runtime";
+function Paragraph({ children, color = theme_default.colors.secondary, width }) {
+  const layout = useLayout_default();
+  const text = Array.isArray(children) ? children.join("") : String(children ?? "");
+  const lines = wrapWords(text, width ?? layout.width);
+  return /* @__PURE__ */ jsx9(Text7, { color, children: lines.join("\n") });
+}
+var Paragraph_default = Paragraph;
+
+// src/components/hints.js
+var BACK_HINTS = [
+  { key: "esc", label: "back" },
+  { key: ":", label: "command" },
+  { key: "q", label: "quit" }
+];
+var LIST_HINTS = [
+  { key: "\u2191\u2193", label: "navigate" },
+  { key: "\u23CE", label: "open" },
+  { key: "esc", label: "back" },
+  { key: "q", label: "quit" }
+];
+var OPEN_HINTS = [
+  { key: "\u23CE", label: "open" },
+  { key: "esc", label: "back" },
+  { key: "q", label: "quit" }
+];
+
+// src/components/About.jsx
+import { jsx as jsx10, jsxs as jsxs7 } from "react/jsx-runtime";
+function About() {
+  return /* @__PURE__ */ jsxs7(Screen_default, { title: "ABOUT", breadcrumb: "about", hints: BACK_HINTS, children: [
+    portfolio_default.about.map((paragraph, i) => /* @__PURE__ */ jsx10(Box8, { marginBottom: 1, children: /* @__PURE__ */ jsx10(Paragraph_default, { children: paragraph }) }, i)),
+    /* @__PURE__ */ jsx10(Box8, { marginTop: 1, marginBottom: 1, children: /* @__PURE__ */ jsx10(Text8, { color: theme_default.colors.accent, children: "CURRENTLY EXPLORING" }) }),
+    /* @__PURE__ */ jsx10(Box8, { flexDirection: "column", children: portfolio_default.focus.map((item) => /* @__PURE__ */ jsxs7(Box8, { children: [
+      /* @__PURE__ */ jsxs7(Text8, { color: theme_default.colors.faint, children: [
+        theme_default.glyphs.bullet,
+        " "
+      ] }),
+      /* @__PURE__ */ jsx10(Text8, { color: theme_default.colors.secondary, children: item })
+    ] }, item)) })
+  ] });
+}
+var About_default = About;
+
+// src/components/Skills.jsx
+import React11 from "react";
+import { Box as Box9, Text as Text9 } from "ink";
+import { jsx as jsx11, jsxs as jsxs8 } from "react/jsx-runtime";
+function Skills() {
+  const { compact } = useLayout_default();
+  const categories = Object.entries(portfolio_default.skills);
+  const labelWidth = categories.reduce((max, [name]) => Math.max(max, name.length), 0);
+  return /* @__PURE__ */ jsx11(Screen_default, { title: "SKILLS", breadcrumb: "skills", hints: BACK_HINTS, children: /* @__PURE__ */ jsx11(Box9, { flexDirection: "column", children: categories.map(([name, items]) => /* @__PURE__ */ jsxs8(Box9, { flexDirection: compact ? "column" : "row", marginBottom: 1, children: [
+    /* @__PURE__ */ jsx11(Box9, { width: compact ? void 0 : labelWidth + 4, children: /* @__PURE__ */ jsx11(Text9, { color: theme_default.colors.accent, children: name.toUpperCase() }) }),
+    /* @__PURE__ */ jsx11(Text9, { color: theme_default.colors.secondary, children: items.map((item, i) => /* @__PURE__ */ jsxs8(Text9, { children: [
+      i > 0 ? /* @__PURE__ */ jsxs8(Text9, { color: theme_default.colors.border, children: [
+        " ",
+        theme_default.glyphs.dot,
+        " "
+      ] }) : null,
+      item
+    ] }, item)) })
+  ] }, name)) }) });
+}
+var Skills_default = Skills;
+
+// src/components/Projects.jsx
+import React12 from "react";
+import { Box as Box10, Text as Text10 } from "ink";
+import { jsx as jsx12 } from "react/jsx-runtime";
+function Projects({ isActive, onOpen }) {
+  const projects = portfolio_default.projects;
+  const { index, move } = useSelection_default(projects.length);
+  useSafeInput_default(
+    (input, key) => {
+      if (key.upArrow || input === "k") move(-1);
+      else if (key.downArrow || input === "j") move(1);
+      else if (key.return && projects[index]) onOpen(projects[index].id);
+    },
+    { isActive }
+  );
+  const items = projects.map((project) => ({
+    key: project.id,
+    label: project.name,
+    hint: project.summary
+  }));
+  return /* @__PURE__ */ jsx12(Screen_default, { title: "PROJECTS", breadcrumb: "projects", hints: LIST_HINTS, children: projects.length === 0 ? /* @__PURE__ */ jsx12(Text10, { color: theme_default.colors.faint, children: "No projects yet." }) : /* @__PURE__ */ jsx12(SelectableList_default, { items, index, inline: true }) });
+}
+var Projects_default = Projects;
+
+// src/components/ProjectDetail.jsx
+import React13 from "react";
+import { Box as Box11, Text as Text11 } from "ink";
+import { jsx as jsx13, jsxs as jsxs9 } from "react/jsx-runtime";
+var LINK_LABELS = { github: "GitHub", docs: "Documentation", live: "Live demo" };
+function ProjectDetail({ isActive, projectId, onOpenLink }) {
+  const project = portfolio_default.projects.find((p) => p.id === projectId);
+  const links = project ? Object.entries(project.links).filter(([, url]) => isConfigured(url)).map(([kind, url]) => ({ key: kind, label: LINK_LABELS[kind] ?? kind, url })) : [];
+  const { index, move } = useSelection_default(links.length);
+  useSafeInput_default(
+    (input, key) => {
+      if (key.upArrow || input === "k") move(-1);
+      else if (key.downArrow || input === "j") move(1);
+      else if (key.return && links[index]) onOpenLink(links[index].url, links[index].label);
+    },
+    { isActive }
+  );
+  if (!project) {
+    return /* @__PURE__ */ jsx13(Screen_default, { title: "PROJECT", breadcrumb: "projects", hints: BACK_HINTS, children: /* @__PURE__ */ jsx13(Text11, { color: theme_default.colors.warning, children: "That project could not be found." }) });
+  }
+  const tech = configuredList(project.tech);
+  return /* @__PURE__ */ jsxs9(
+    Screen_default,
+    {
+      title: project.name,
+      breadcrumb: `projects ${theme_default.glyphs.pointer} ${project.name.toLowerCase()}`,
+      hints: links.length > 0 ? LIST_HINTS : BACK_HINTS,
+      children: [
+        /* @__PURE__ */ jsx13(Box11, { marginBottom: 1, children: /* @__PURE__ */ jsx13(Paragraph_default, { children: project.description }) }),
+        /* @__PURE__ */ jsx13(Section, { label: "TECHNOLOGY", children: tech.length > 0 ? /* @__PURE__ */ jsx13(Text11, { color: theme_default.colors.secondary, children: tech.map((item, i) => /* @__PURE__ */ jsxs9(Text11, { children: [
+          i > 0 ? /* @__PURE__ */ jsxs9(Text11, { color: theme_default.colors.border, children: [
+            " ",
+            theme_default.glyphs.dot,
+            " "
+          ] }) : null,
+          item
+        ] }, item)) }) : /* @__PURE__ */ jsx13(Text11, { color: theme_default.colors.faint, children: "Not listed yet." }) }),
+        /* @__PURE__ */ jsx13(Section, { label: "STATUS", children: /* @__PURE__ */ jsx13(Text11, { color: theme_default.colors.accent, children: project.status }) }),
+        /* @__PURE__ */ jsx13(Section, { label: "LINKS", children: links.length > 0 ? /* @__PURE__ */ jsx13(SelectableList_default, { items: links.map((l) => ({ key: l.key, label: l.label, hint: l.url })), index }) : /* @__PURE__ */ jsx13(Text11, { color: theme_default.colors.faint, children: "No links yet \u2014 add them in portfolio.js." }) })
+      ]
+    }
+  );
+}
+function Section({ label, children }) {
+  return /* @__PURE__ */ jsxs9(Box11, { flexDirection: "column", marginBottom: 1, children: [
+    /* @__PURE__ */ jsx13(Text11, { color: theme_default.colors.faint, children: label }),
+    /* @__PURE__ */ jsx13(Box11, { children })
+  ] });
+}
+var ProjectDetail_default = ProjectDetail;
+
+// src/components/Github.jsx
+import React14, { useEffect as useEffect4, useState as useState4 } from "react";
+import { Box as Box12, Text as Text12 } from "ink";
+
+// src/utils/github.js
+async function getGithubProfile(github) {
+  return {
+    data: {
+      username: github.username,
+      url: github.url,
+      blurb: github.blurb
+      // The following are intentionally omitted until wired to the live API,
+      // so the UI never shows fabricated numbers:
+      // repos, followers, stars, contributions.
+    },
+    error: null
+  };
+}
+
+// src/components/Github.jsx
+import { jsx as jsx14, jsxs as jsxs10 } from "react/jsx-runtime";
+function Github({ isActive, onOpenLink }) {
+  const [state, setState] = useState4({ loading: true, data: null, error: null });
+  useEffect4(() => {
+    let alive = true;
+    getGithubProfile(portfolio_default.github).then((result) => {
+      if (alive) setState({ loading: false, data: result.data, error: result.error });
+    });
+    return () => {
+      alive = false;
+    };
+  }, []);
+  useSafeInput_default(
+    (input, key) => {
+      if (key.return) onOpenLink(portfolio_default.github.url, "GitHub profile");
+    },
+    { isActive }
+  );
+  const profile = state.data ?? portfolio_default.github;
+  return /* @__PURE__ */ jsxs10(Screen_default, { title: "GITHUB", breadcrumb: "github", hints: OPEN_HINTS, children: [
+    /* @__PURE__ */ jsxs10(Box12, { children: [
+      /* @__PURE__ */ jsx14(Text12, { color: theme_default.colors.secondary, children: "@" }),
+      /* @__PURE__ */ jsx14(Text12, { color: theme_default.colors.primary, bold: true, children: profile.username })
+    ] }),
+    /* @__PURE__ */ jsx14(Box12, { marginTop: 0, children: /* @__PURE__ */ jsx14(Text12, { color: theme_default.colors.link, underline: true, children: profile.url }) }),
+    /* @__PURE__ */ jsx14(Box12, { marginTop: 1, children: /* @__PURE__ */ jsx14(Text12, { color: theme_default.colors.secondary, wrap: "wrap", children: profile.blurb }) }),
+    state.error ? /* @__PURE__ */ jsx14(Box12, { marginTop: 1, children: /* @__PURE__ */ jsxs10(Text12, { color: theme_default.colors.warning, children: [
+      state.error,
+      " \u2014 showing offline info."
+    ] }) }) : null,
+    /* @__PURE__ */ jsx14(Box12, { marginTop: 1, children: /* @__PURE__ */ jsxs10(Text12, { color: theme_default.colors.faint, children: [
+      "Press ",
+      /* @__PURE__ */ jsx14(Text12, { color: theme_default.colors.accent, children: "\u23CE" }),
+      " to open the profile in your browser."
+    ] }) })
+  ] });
+}
+var Github_default = Github;
+
+// src/components/Contact.jsx
+import React15 from "react";
+import { Box as Box13, Text as Text13 } from "ink";
+import { jsx as jsx15, jsxs as jsxs11 } from "react/jsx-runtime";
+function Contact({ isActive, onOpenLink }) {
+  const { links } = portfolio_default;
+  const channels = [
+    { key: "github", label: "GitHub", value: links.github, url: links.github },
+    { key: "linkedin", label: "LinkedIn", value: links.linkedin, url: links.linkedin },
+    { key: "email", label: "Email", value: links.email, url: toMailto(links.email) }
+  ];
+  const configured = channels.filter((c) => isConfigured(c.value));
+  const missing = channels.filter((c) => !isConfigured(c.value)).map((c) => c.label);
+  const { index, move } = useSelection_default(configured.length);
+  useSafeInput_default(
+    (input, key) => {
+      if (key.upArrow || input === "k") move(-1);
+      else if (key.downArrow || input === "j") move(1);
+      else if (key.return && configured[index]) {
+        onOpenLink(configured[index].url, configured[index].label);
+      }
+    },
+    { isActive }
+  );
+  return /* @__PURE__ */ jsxs11(
+    Screen_default,
+    {
+      title: "CONTACT",
+      breadcrumb: "contact",
+      hints: configured.length > 0 ? LIST_HINTS : BACK_HINTS,
+      children: [
+        configured.length > 0 ? /* @__PURE__ */ jsx15(
+          SelectableList_default,
+          {
+            items: configured.map((c) => ({ key: c.key, label: c.label, hint: c.value })),
+            index
+          }
+        ) : /* @__PURE__ */ jsx15(Text13, { color: theme_default.colors.faint, children: "No contact channels configured yet." }),
+        missing.length > 0 ? /* @__PURE__ */ jsx15(Box13, { marginTop: 1, children: /* @__PURE__ */ jsxs11(Text13, { color: theme_default.colors.faint, children: [
+          "Not set up yet: ",
+          missing.join(", "),
+          " \u2014 add them in portfolio.js."
+        ] }) }) : null
+      ]
+    }
+  );
+}
+var Contact_default = Contact;
+
+// src/components/Resume.jsx
+import React16 from "react";
+import { Box as Box14, Text as Text14 } from "ink";
+import { jsx as jsx16, jsxs as jsxs12 } from "react/jsx-runtime";
+function Resume({ isActive, onOpenLink }) {
+  const url = portfolio_default.links.resume;
+  const configured = isConfigured(url);
+  useSafeInput_default(
+    (input, key) => {
+      if (key.return && configured) onOpenLink(url, "Resume");
+    },
+    { isActive }
+  );
+  return /* @__PURE__ */ jsx16(Screen_default, { title: "RESUME", breadcrumb: "resume", hints: configured ? OPEN_HINTS : BACK_HINTS, children: configured ? /* @__PURE__ */ jsxs12(Box14, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx16(Text14, { color: theme_default.colors.link, underline: true, children: url }),
+    /* @__PURE__ */ jsx16(Box14, { marginTop: 1, children: /* @__PURE__ */ jsxs12(Text14, { color: theme_default.colors.faint, children: [
+      "Press ",
+      /* @__PURE__ */ jsx16(Text14, { color: theme_default.colors.accent, children: "\u23CE" }),
+      " to open the resume."
+    ] }) })
+  ] }) : /* @__PURE__ */ jsxs12(Box14, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsx16(Text14, { color: theme_default.colors.warning, children: "Resume link has not been configured yet." }),
+    /* @__PURE__ */ jsx16(Box14, { marginTop: 1, children: /* @__PURE__ */ jsx16(Text14, { color: theme_default.colors.faint, children: "Set links.resume in portfolio.js to enable it." }) })
+  ] }) });
+}
+var Resume_default = Resume;
+
+// src/components/Help.jsx
+import React17 from "react";
+import { Box as Box15, Text as Text15 } from "ink";
+import { jsx as jsx17, jsxs as jsxs13 } from "react/jsx-runtime";
+function Help() {
+  const nameWidth = COMMANDS.reduce((max, c) => Math.max(max, c.name.length), 0);
+  return /* @__PURE__ */ jsxs13(Screen_default, { title: "HELP", breadcrumb: "help", hints: BACK_HINTS, children: [
+    /* @__PURE__ */ jsx17(Box15, { marginBottom: 1, children: /* @__PURE__ */ jsxs13(Text15, { color: theme_default.colors.secondary, children: [
+      "Press ",
+      /* @__PURE__ */ jsx17(Text15, { color: theme_default.colors.accent, children: ":" }),
+      " anywhere to open the command bar, then type a command."
+    ] }) }),
+    /* @__PURE__ */ jsx17(Box15, { flexDirection: "column", children: COMMANDS.map((command) => /* @__PURE__ */ jsxs13(Box15, { children: [
+      /* @__PURE__ */ jsx17(Text15, { color: theme_default.colors.accent, children: command.name.padEnd(nameWidth + 4) }),
+      /* @__PURE__ */ jsx17(Text15, { color: theme_default.colors.secondary, children: command.description })
+    ] }, command.name)) })
+  ] });
+}
+var Help_default = Help;
+
+// src/components/EasterEgg.jsx
+import React18 from "react";
+import { Box as Box16, Text as Text16 } from "ink";
+import { jsx as jsx18, jsxs as jsxs14 } from "react/jsx-runtime";
+var ART = ["\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510", "\u2502  > _    \u2502", "\u2502         \u2502", "\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518"];
+var SWATCHES = [
+  theme_default.colors.accent,
+  theme_default.colors.link,
+  theme_default.colors.warning,
+  theme_default.colors.primary,
+  theme_default.colors.secondary,
+  theme_default.colors.faint
+];
+function EasterEgg() {
+  const { compact } = useLayout_default();
+  const title = `${portfolio_default.github.username}@portfolio`;
+  const languages = (portfolio_default.skills.Languages ?? []).join(" \xB7 ");
+  const info = [
+    ["OS", "ShivenOS \xB7 terminal edition"],
+    ["Host", "npx shivenverma"],
+    ["Shell", "your terminal, thankfully"],
+    ["Uptime", "since you ran the command"],
+    ["Languages", languages || "\u2014"],
+    ["Motto", "build \xB7 break \xB7 learn"]
+  ];
+  return /* @__PURE__ */ jsxs14(Screen_default, { title: "WHOAMI", breadcrumb: "easter egg", hints: [{ key: "esc", label: "back" }], children: [
+    /* @__PURE__ */ jsxs14(Box16, { flexDirection: compact ? "column" : "row", children: [
+      /* @__PURE__ */ jsx18(Box16, { flexDirection: "column", marginRight: compact ? 0 : 3, children: ART.map((line, i) => /* @__PURE__ */ jsx18(Text16, { color: theme_default.colors.accent, children: line }, i)) }),
+      /* @__PURE__ */ jsxs14(Box16, { flexDirection: "column", children: [
+        /* @__PURE__ */ jsx18(Text16, { color: theme_default.colors.accent, bold: true, children: title }),
+        /* @__PURE__ */ jsx18(Text16, { color: theme_default.colors.border, children: "\u2500".repeat(title.length) }),
+        info.map(([label, value]) => /* @__PURE__ */ jsxs14(Box16, { children: [
+          /* @__PURE__ */ jsx18(Text16, { color: theme_default.colors.accent, children: label }),
+          /* @__PURE__ */ jsxs14(Text16, { color: theme_default.colors.secondary, children: [
+            ": ",
+            value
+          ] })
+        ] }, label)),
+        /* @__PURE__ */ jsx18(Box16, { marginTop: 1, children: SWATCHES.map((color, i) => /* @__PURE__ */ jsx18(Text16, { color, children: "\u2588\u2588" }, i)) })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx18(Box16, { marginTop: 1, children: /* @__PURE__ */ jsx18(Text16, { color: theme_default.colors.faint, children: "we trust you have received the usual lecture from the local system administrator." }) })
+  ] });
+}
+var EasterEgg_default = EasterEgg;
+
+// src/components/CommandBar.jsx
+import React19 from "react";
+import { Box as Box17, Text as Text17 } from "ink";
+import { jsx as jsx19, jsxs as jsxs15 } from "react/jsx-runtime";
+var STATUS_COLORS = {
+  success: theme_default.colors.accent,
+  warn: theme_default.colors.warning,
+  error: theme_default.colors.warning,
+  info: theme_default.colors.secondary
+};
+function CommandBar({ active, buffer }) {
+  const { indent } = useLayout_default();
+  if (!active) return null;
+  return /* @__PURE__ */ jsxs15(Box17, { paddingX: indent, children: [
+    /* @__PURE__ */ jsx19(Text17, { color: theme_default.colors.accent, children: ": " }),
+    /* @__PURE__ */ jsx19(Text17, { color: theme_default.colors.primary, children: buffer }),
+    /* @__PURE__ */ jsx19(Text17, { color: theme_default.colors.accent, children: "\u258B" })
+  ] });
+}
+function StatusLine({ status }) {
+  const { indent } = useLayout_default();
+  if (!status) return null;
+  return /* @__PURE__ */ jsxs15(Box17, { paddingX: indent, children: [
+    /* @__PURE__ */ jsxs15(Text17, { color: theme_default.colors.faint, children: [
+      theme_default.glyphs.corner,
+      " "
+    ] }),
+    /* @__PURE__ */ jsx19(Text17, { color: STATUS_COLORS[status.type] ?? theme_default.colors.secondary, wrap: "truncate-end", children: status.text })
+  ] });
+}
+
+// src/App.jsx
+import { jsx as jsx20, jsxs as jsxs16 } from "react/jsx-runtime";
+function App({ interactive: interactive2 = true, skipStartup: skipStartup2 = false }) {
+  const { exit } = useApp();
+  const [booting, setBooting] = useState5(interactive2 && !skipStartup2);
+  const [stack, setStack] = useState5(["home"]);
+  const [projectId, setProjectId] = useState5(null);
+  const [command, setCommand] = useState5({ active: false, buffer: "" });
+  const [status, setStatus] = useState5(null);
+  const screen = stack[stack.length - 1];
+  const push = (next) => {
+    setStatus(null);
+    setStack((st) => [...st, next]);
+  };
+  const back = () => {
+    setStatus(null);
+    setStack((st) => st.length > 1 ? st.slice(0, -1) : st);
+  };
+  const goHome = () => {
+    setStatus(null);
+    setStack(["home"]);
+  };
+  const jumpTo = (next) => {
+    setStatus(null);
+    setStack(next === "home" ? ["home"] : ["home", next]);
+  };
+  const openProject = (id) => {
+    setProjectId(id);
+    push("project");
+  };
+  const quit = () => {
+    setStatus(null);
+    setStack(["bye"]);
+    setTimeout(() => exit(), 60);
+  };
+  const openLink = async (url, label) => {
+    setStatus({ type: "info", text: `Opening ${label}\u2026` });
+    const result = await openUrl(url);
+    if (result.ok) {
+      setStatus({ type: "success", text: `Opened ${label} in your browser.` });
+    } else {
+      setStatus({ type: "warn", text: `Couldn't open a browser. Copy this: ${url}` });
+    }
+  };
+  const runCommand = (raw) => {
+    const result = matchCommand(raw);
+    setCommand({ active: false, buffer: "" });
+    if (result.type === "screen") return jumpTo(result.screen);
+    if (result.type === "action") {
+      if (result.action === "exit") return quit();
+      if (result.action === "clear") return goHome();
+      if (result.action === "easter-egg") return jumpTo("egg");
+    }
+    if (result.type === "unknown") {
+      setStatus({
+        type: "warn",
+        text: `command not found: ${result.input} \u2014 type "help" to list commands.`
+      });
+    }
+  };
+  useSafeInput_default(
+    (input, key) => {
+      if (key.escape) return back();
+      if (input === "q") return quit();
+      if (input === ":" || input === "/") setCommand({ active: true, buffer: "" });
+      else if (input === "?") jumpTo("help");
+    },
+    { isActive: !command.active && !booting && screen !== "bye" }
+  );
+  useSafeInput_default(
+    (input, key) => {
+      if (key.escape) return setCommand({ active: false, buffer: "" });
+      if (key.return) return runCommand(command.buffer);
+      if (key.backspace || key.delete) {
+        return setCommand((c) => ({ ...c, buffer: c.buffer.slice(0, -1) }));
+      }
+      if (key.ctrl && input === "u") return setCommand((c) => ({ ...c, buffer: "" }));
+      if (input && !key.ctrl && !key.meta && !key.tab) {
+        setCommand((c) => ({ ...c, buffer: c.buffer + input }));
+      }
+    },
+    { isActive: command.active && !booting }
+  );
+  if (booting) {
+    return /* @__PURE__ */ jsx20(Startup_default, { onComplete: () => setBooting(false) });
+  }
+  const inputActive = !command.active;
+  return /* @__PURE__ */ jsxs16(Box18, { flexDirection: "column", children: [
+    renderScreen({ screen, inputActive, projectId, push, openProject, openLink, quit }),
+    /* @__PURE__ */ jsx20(StatusLine, { status }),
+    /* @__PURE__ */ jsx20(CommandBar, { active: command.active, buffer: command.buffer })
+  ] });
+}
+function renderScreen({ screen, inputActive, projectId, push, openProject, openLink, quit }) {
+  switch (screen) {
+    case "about":
+      return /* @__PURE__ */ jsx20(About_default, {});
+    case "skills":
+      return /* @__PURE__ */ jsx20(Skills_default, {});
+    case "projects":
+      return /* @__PURE__ */ jsx20(Projects_default, { isActive: inputActive, onOpen: openProject });
+    case "project":
+      return /* @__PURE__ */ jsx20(ProjectDetail_default, { isActive: inputActive, projectId, onOpenLink: openLink });
+    case "github":
+      return /* @__PURE__ */ jsx20(Github_default, { isActive: inputActive, onOpenLink: openLink });
+    case "contact":
+      return /* @__PURE__ */ jsx20(Contact_default, { isActive: inputActive, onOpenLink: openLink });
+    case "resume":
+      return /* @__PURE__ */ jsx20(Resume_default, { isActive: inputActive, onOpenLink: openLink });
+    case "help":
+      return /* @__PURE__ */ jsx20(Help_default, {});
+    case "egg":
+      return /* @__PURE__ */ jsx20(EasterEgg_default, {});
+    case "bye":
+      return /* @__PURE__ */ jsx20(Farewell, {});
+    case "home":
+    default:
+      return /* @__PURE__ */ jsx20(Home_default, { isActive: inputActive, onNavigate: push, onQuit: quit });
+  }
+}
+function Farewell() {
+  const { indent } = useLayout_default();
+  return /* @__PURE__ */ jsxs16(Box18, { flexDirection: "column", paddingX: indent, paddingY: 1, children: [
+    /* @__PURE__ */ jsx20(Text18, { color: theme_default.colors.accent, children: "Thanks for stopping by." }),
+    /* @__PURE__ */ jsxs16(Text18, { color: theme_default.colors.faint, children: [
+      "github.com/",
+      portfolio_default.github.username,
+      " ",
+      theme_default.glyphs.dot,
+      " npx shivenverma"
+    ] })
+  ] });
+}
+var App_default = App;
+
+// src/index.jsx
+import { jsx as jsx21 } from "react/jsx-runtime";
+var VERSION = true ? "1.0.0" : "0.0.0";
+var args = process.argv.slice(2);
+var has = (...names) => names.some((name) => args.includes(name));
+if (has("-v", "--version")) {
+  console.log(VERSION);
+  process.exit(0);
+}
+if (has("-h", "--help")) {
+  printHelp();
+  process.exit(0);
+}
+var interactive = Boolean(process.stdout.isTTY && process.stdin.isTTY) && !has("--ci");
+var skipStartup = has("--no-startup", "--no-anim", "--skip") || !interactive;
+try {
+  const instance = render(/* @__PURE__ */ jsx21(App_default, { interactive, skipStartup }), {
+    exitOnCtrlC: true,
+    // In one-shot / piped mode we don't want Ink buffering console output; this
+    // also surfaces render errors on real stderr instead of swallowing them.
+    patchConsole: interactive
+  });
+  if (!interactive) {
+    setTimeout(() => instance.unmount(), 200);
+    setTimeout(() => process.exit(0), 900).unref();
+  }
+  instance.waitUntilExit().catch(() => {
+  });
+} catch (error) {
+  console.error("shivenverma failed to start:", error?.message ?? error);
+  process.exit(1);
+}
+function printHelp() {
+  const lines = [
+    "",
+    "  shivenverma \u2014 an interactive terminal portfolio",
+    "",
+    "  Usage",
+    "    npx shivenverma              launch the portfolio",
+    "    shivenverma [options]",
+    "",
+    "  Options",
+    "    -h, --help                   show this help",
+    "    -v, --version                print the version",
+    "        --no-startup             skip the boot animation",
+    "",
+    "  Once inside",
+    "    \u2191 \u2193 / j k   navigate         \u23CE  select        esc  back",
+    "    :           command mode     q  quit",
+    ""
+  ];
+  console.log(lines.join("\n"));
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "shivenverma",
+  "version": "1.0.0",
+  "description": "An interactive terminal portfolio for Shiven Verma. Run it with: npx shivenverma",
+  "type": "module",
+  "bin": {
+    "shivenverma": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "banner": "node scripts/gen-banner.mjs",
+    "dev": "node scripts/build.mjs && node bin/cli.js",
+    "start": "node bin/cli.js",
+    "test": "node scripts/build.mjs && node scripts/smoke-test.mjs",
+    "package": "node scripts/build.mjs && npm pack",
+    "prepublishOnly": "node scripts/build.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "portfolio",
+    "cli",
+    "terminal",
+    "resume",
+    "developer",
+    "ink",
+    "react",
+    "npx",
+    "interactive",
+    "tui",
+    "shiven-verma"
+  ],
+  "author": "Shiven Verma",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shivenverma/shivenverma.git"
+  },
+  "homepage": "https://github.com/shivenverma/shivenverma#readme",
+  "bugs": {
+    "url": "https://github.com/shivenverma/shivenverma/issues"
+  },
+  "dependencies": {
+    "ink": "^5.0.1",
+    "react": "^18.3.1"
+  },
+  "devDependencies": {
+    "esbuild": "^0.23.1",
+    "figlet": "^1.7.0"
+  }
+}