tools.ts

// Single source of truth for the tool set. The home grid, per-tool metadata,
// JSON-LD, hero, FAQ, CTA, sitemap, web manifest, and command palette all derive
// from this array — adding a tool means adding one entry here (plus its route).

export interface ToolFaq {
  q: string;
  a: string;
}

export interface ToolCta {
  headline: string;
  sub: string;
  primaryLabel: string;
  primaryHref: string;
  secondaryLabel: string;
  secondaryHref: string;
}

export interface Tool {
  slug: string;
  path: string;
  // Home card
  title: string;
  tagline: string;
  cardDescription: string;
  features: string[];
  /** Theme-aware CSS variable name, e.g. "--sky" (accessible in both themes). */
  accentVar: string;
  /** Raw hex for the decorative hover glow only (cosmetic, low opacity). */
  accentHex: string;
  // Metadata
  metaTitle: string;
  metaDescription: string;
  ogTitle: string;
  ogDescription: string;
  // Hero
  heroBreadcrumb: string;
  heroHeading: string;
  /** Substring of heroHeading rendered in a dimmed span (e.g. "&"). */
  heroDim: string;
  heroDescription: string;
  // JSON-LD
  jsonLdName: string;
  jsonLdDescription: string;
  applicationCategory: "DeveloperApplication" | "BusinessApplication";
  // FAQ + CTA
  faqs: ToolFaq[];
  cta: ToolCta;
  sitemapPriority: number;
  /** ISO date string (YYYY-MM-DD) overriding build-time git history for the sitemap. */
  lastModified?: string;
}

const CTA_PROJECTS = "https://www.codercops.com/projects";
const CTA_CONTACT = "https://www.codercops.com/contact";

export const TOOLS: Tool[] = [
  {
    slug: "json-formatter",
    path: "/json-formatter",
    title: "JSON Formatter & Validator",
    tagline: "Formatter",
    cardDescription:
      "Format, validate, minify. Syntax-highlighted output with collapsible tree view, plus JSON → CSV / TypeScript / YAML conversion.",
    features: ["Beautify", "Validate", "Tree view", "TypeScript", "CSV", "YAML"],
    accentVar: "--sky",
    accentHex: "#5AB5FF",
    metaTitle: "JSON Formatter & Validator - Free Online Tool",
    metaDescription:
      "Free online JSON formatter, validator, and beautifier. Format, minify, and validate JSON instantly with syntax highlighting and JSON-to-TypeScript. No signup.",
    ogTitle: "JSON Formatter & Validator - CODERCOPS Tools",
    ogDescription:
      "Format, validate, and minify JSON with syntax highlighting and JSON-to-TypeScript conversion. Runs entirely in your browser.",
    heroBreadcrumb: "100% client-side",
    heroHeading: "JSON Formatter & Validator",
    heroDim: "&",
    heroDescription:
      "Paste your JSON below to format, validate, and convert it — all in your browser, nothing is uploaded.",
    jsonLdName: "JSON Formatter & Validator",
    jsonLdDescription:
      "Free online JSON formatter, validator, and minifier with syntax highlighting and JSON-to-TypeScript/CSV/YAML conversion.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Is my JSON uploaded anywhere?",
        a: "No. All formatting, validation, and conversion run locally in your browser. The JSON you paste never leaves your tab, is never sent to a server, and is never logged.",
      },
      {
        q: "Why does my JSON fail to validate?",
        a: "The usual causes are trailing commas, single quotes instead of double quotes, unquoted keys, and unbalanced brackets. The validator points to the line and character where parsing breaks so you can fix it quickly.",
      },
      {
        q: "Does it keep large numbers accurate?",
        a: "Yes. It parses with lossless-json, so very large integers and high-precision decimals keep every digit instead of being rounded by the browser's native JSON parser.",
      },
    ],
    cta: {
      headline: "Building an app that handles JSON APIs?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "jwt-decoder",
    path: "/jwt-decoder",
    title: "JWT Decoder & Inspector",
    tagline: "Auth",
    cardDescription:
      "Decode any JWT into header, payload, and signature. Human-readable claims, expiry status, and a built-in HS256 encoder.",
    features: ["Decode", "Encode", "Health panel", "HS256/384/512", "URL share"],
    accentVar: "--violet",
    accentHex: "#9E7BFF",
    metaTitle: "JWT Decoder & Verifier - Free Online Tool",
    metaDescription:
      "Free online JWT decoder and verifier. Decode any token to read its header, payload, claims, and expiry, and verify HS/RS/ES signatures in your browser. No login.",
    ogTitle: "JWT Decoder & Verifier - CODERCOPS Tools",
    ogDescription:
      "Decode JWT tokens in-browser. Humanized claims, expiry status, built-in HS256 encoder.",
    heroBreadcrumb: "Decoder · Inspector · Encoder",
    heroHeading: "JWT Decoder & Inspector",
    heroDim: "&",
    heroDescription:
      "Paste any JWT token to instantly decode its header, payload, and claims — everything runs in your browser.",
    jsonLdName: "JWT Decoder & Inspector",
    jsonLdDescription:
      "Decode and inspect JWT tokens, view humanized claims, check expiry, and generate signed HS256/384/512 tokens — all in your browser.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What is a JWT?",
        a: "A JSON Web Token is a compact, URL-safe format for asserting claims between parties. It has three parts — header, payload, signature — separated by dots and encoded with base64url.",
      },
      {
        q: "Is it safe to paste my JWT here?",
        a: "Yes — all decoding happens locally in your browser. Nothing is sent to our servers, logged, or stored. That said, avoid pasting production access tokens into any online tool if you can help it.",
      },
      {
        q: "Can this tool verify JWT signatures?",
        a: "Yes. The Verify tab checks HMAC (HS256/384/512) signatures with your secret, and RSA, ECDSA, or PSS signatures with a PEM or JWK public key, all in your browser via WebCrypto. It can also fetch a JWKS URL to pick the right key. Your production apps should still verify server-side.",
      },
      {
        q: "What is the difference between decoding and verifying a JWT?",
        a: "Decoding just base64url-decodes the header and payload so you can read the claims; it does not prove the token is authentic. Verifying checks the signature against a secret or public key to confirm the token was issued by who it claims and has not been tampered with. This tool does both.",
      },
    ],
    cta: {
      headline: "Building an app with JWT authentication?",
      sub: "CODERCOPS implements secure auth systems — OAuth2, JWT, SSO, and custom identity solutions — for startups and enterprise apps.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Let's build together",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "base64",
    path: "/base64",
    title: "Base64 Encoder & Decoder",
    tagline: "Encoding",
    cardDescription:
      "Text, images, files — encode to Base64 or decode back. URL-safe variant, data URIs, and magic-byte file detection.",
    features: ["Text", "Image → URI", "Files", "URL-safe", "Auto-detect"],
    accentVar: "--amber",
    accentHex: "#FFB547",
    metaTitle: "Base64 Encoder & Decoder - Free Online Tool",
    metaDescription:
      "Free online Base64 encoder and decoder for text, images, and files. URL-safe Base64, data URIs, and magic-byte detection. Runs in your browser, no upload.",
    ogTitle: "Base64 Encoder & Decoder - CODERCOPS Tools",
    ogDescription:
      "Encode and decode Base64 for text, images, and files — all in your browser.",
    heroBreadcrumb: "Text · Image · File · Decode",
    heroHeading: "Base64 Encoder & Decoder",
    heroDim: "&",
    heroDescription:
      "Encode text, images, and files to Base64 — or decode any Base64 string — all in your browser with zero uploads.",
    jsonLdName: "Base64 Encoder & Decoder",
    jsonLdDescription:
      "Free online Base64 encoder and decoder for text, images, and files, with URL-safe variant and magic-byte detection.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What is Base64 encoding?",
        a: "Base64 is a way of representing binary data as ASCII text using 64 printable characters. It's widely used to embed images in HTML/CSS, transmit binary data in JSON, and carry credentials in HTTP headers.",
      },
      {
        q: "What's the difference between Base64 and Base64URL?",
        a: "Standard Base64 uses + and / characters. Base64URL is a URL-safe variant that replaces + with - and / with _ (and often omits padding =), so the output is safe to put in URLs and JWTs.",
      },
      {
        q: "Does my data get uploaded anywhere?",
        a: "No. All encoding and decoding runs entirely in your browser. Text, images, and files you paste or drop here never leave your tab.",
      },
      {
        q: "Why is Base64 output larger than the input?",
        a: "Base64 represents every 3 input bytes as 4 output characters, so the output is roughly 4/3 of the input — about 33% larger. That overhead is the trade-off for ASCII-safe transport.",
      },
      {
        q: "Can I encode an image or PDF to Base64?",
        a: "Yes. Drop or select any file and it is encoded to a Base64 string or a ready-to-use data URI. It works for images, PDFs, and other binary files, and every byte is processed in your browser.",
      },
    ],
    cta: {
      headline: "Building an API or system that handles binary data?",
      sub: "CODERCOPS builds production APIs, file storage systems, and data pipelines for startups and enterprises.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "invoice-generator",
    path: "/invoice-generator",
    title: "Invoice Generator",
    tagline: "Billing",
    cardDescription:
      "Fill in your details, preview live, and download a crisp invoice PDF. Saves invoices in your browser — reusable sender profile, deductions, and auto-numbering.",
    features: ["Live preview", "PDF export", "Saved locally", "Deductions", "Auto-number"],
    accentVar: "--lime",
    accentHex: "#A6F36B",
    metaTitle: "Free Invoice Generator - Make & Download PDF",
    metaDescription:
      "Free invoice generator: create professional invoices and download a PDF. Live preview, reusable sender profile, and auto-numbering, saved in your browser.",
    ogTitle: "Invoice Generator - CODERCOPS Tools",
    ogDescription:
      "Build invoices in your browser and download a crisp PDF. Saved locally, no account, no data leaves your tab.",
    heroBreadcrumb: "Builder · Saved locally · PDF",
    heroHeading: "Invoice Generator",
    heroDim: "Generator",
    heroDescription:
      "Fill in your details, watch the live preview, and download a clean invoice PDF. Everything is saved in your browser — no account, no server, no data leaves your tab.",
    jsonLdName: "Invoice Generator",
    jsonLdDescription:
      "Create, save, and download professional invoices as PDF. Reusable sender profile, line items with deductions, tax, and auto-incrementing invoice numbers — all stored locally in your browser.",
    applicationCategory: "BusinessApplication",
    faqs: [
      {
        q: "Where are my invoices stored?",
        a: "In your browser's local storage on this device. There is no backend and no account. Clearing your browser data or using a different device or browser will not carry the invoices over.",
      },
      {
        q: "Is the PDF a real, printable invoice?",
        a: "Yes. The PDF is drawn as vector text and lines, so it stays sharp at any zoom and the text is selectable. It matches the live preview and downloads with your invoice number as the filename.",
      },
      {
        q: "Can I reuse my details and edit past invoices?",
        a: "Your sender details are saved as a reusable profile that pre-fills every new invoice. Saved invoices can be edited, duplicated, or deleted, and numbers auto-increment from the highest one.",
      },
      {
        q: "Can I add tax and discounts to an invoice?",
        a: "Yes. Each line item takes a rate and quantity, and you can apply a tax rate and per-item deductions. The subtotal, tax, and total are calculated and rounded to the cent as you type.",
      },
    ],
    cta: {
      headline: "Need billing baked into your product?",
      sub: "CODERCOPS builds invoicing, payments, and subscription systems — Stripe, tax handling, PDF generation, and dashboards — for startups and enterprises.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Let's build together",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "url-encoder",
    path: "/url-encoder",
    title: "URL Encoder & Decoder",
    tagline: "Encoding",
    cardDescription:
      "Percent-encode or decode a URL, a query value, or form data. See every query param broken out, with duplicates kept in order.",
    features: ["Encode", "Decode", "Component or full URL", "Query params", "Plus as space"],
    accentVar: "--cyan",
    accentHex: "#00E5C7",
    metaTitle: "URL Encoder & Decoder - Free Online Tool",
    metaDescription:
      "Free online URL encoder and decoder. Percent-encode query values, decode a messy redirect URL, and see every query param broken out. Runs in your browser.",
    ogTitle: "URL Encoder & Decoder - CODERCOPS Tools",
    ogDescription: "Encode and decode URLs and query values, with a full query param breakdown.",
    heroBreadcrumb: "Encode · Decode · Query params",
    heroHeading: "URL Encoder & Decoder",
    heroDim: "&",
    heroDescription:
      "Percent-encode a query value or decode a messy redirect URL, with a breakdown of every query param, all in your browser with zero uploads.",
    jsonLdName: "URL Encoder & Decoder",
    jsonLdDescription:
      "Free online URL encoder and decoder with component and full-URL modes, plus-as-space support, and a query param breakdown.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What's the difference between Component and Full URL encoding?",
        a: "Component mode (encodeURIComponent) escapes every reserved character, including /, ?, =, and &, so it's safe for a single value inside a query string. Full URL mode (encodeURI) leaves those structural characters alone, since it expects a complete URL, not just one piece of it.",
      },
      {
        q: "Why does decoding sometimes fail?",
        a: "A percent-encoded string can contain an incomplete or invalid sequence, like %E0 cut off before its second byte. Decoding reports this as an error instead of crashing, so you can see exactly what's wrong with the input.",
      },
      {
        q: "What does \"Treat + as space\" do?",
        a: "Form data encoded as application/x-www-form-urlencoded uses + for spaces instead of %20. Turn this on when decoding a query string or form submission, off when decoding a path that happens to contain a literal plus sign.",
      },
      {
        q: "Does my data get uploaded anywhere?",
        a: "No. All encoding, decoding, and URL parsing runs entirely in your browser. Nothing you paste here is sent anywhere.",
      },
    ],
    cta: {
      headline: "Building an app that juggles URLs and query params?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "timestamp-converter",
    path: "/timestamp-converter",
    title: "Unix Timestamp Converter",
    tagline: "Time",
    cardDescription:
      "Convert Unix timestamps and dates with automatic unit detection, UTC, local time, ISO 8601, and relative time.",
    features: ["Epoch to date", "Date to epoch", "Seconds or ms", "ISO 8601", "Relative time"],
    accentVar: "--green",
    accentHex: "#3FDD6B",
    metaTitle: "Unix Timestamp Converter - Free Online Tool",
    metaDescription:
      "Convert Unix timestamps to readable dates and dates to epoch time. Detect seconds or milliseconds, view UTC and local time, and copy ISO 8601 output.",
    ogTitle: "Unix Timestamp Converter - CODERCOPS Tools",
    ogDescription:
      "Convert Unix timestamps and dates. Detect seconds or milliseconds, inspect UTC and local time, and copy ISO 8601 output.",
    heroBreadcrumb: "Time",
    heroHeading: "Unix Timestamp Converter",
    heroDim: "",
    heroDescription:
      "Convert epoch timestamps to readable dates or dates to Unix time. All conversions run locally in your browser.",
    jsonLdName: "Unix Timestamp Converter",
    jsonLdDescription:
      "Free online Unix timestamp converter for epoch-to-date and date-to-epoch conversions, with automatic unit detection and ISO 8601 output.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What is a Unix timestamp?",
        a: "A Unix timestamp measures elapsed time from 1970-01-01 00:00:00 UTC. It is commonly represented in seconds or milliseconds.",
      },
      {
        q: "How can I tell seconds from milliseconds?",
        a: "This tool estimates the unit from the number's magnitude. You can also select seconds, milliseconds, microseconds, or nanoseconds manually.",
      },
      {
        q: "Are my timestamps sent to a server?",
        a: "No. Conversion happens locally in your browser. The values you enter are not uploaded by this tool.",
      },
      {
        q: "Which date formats are supported?",
        a: "ISO 8601 timestamps and date strings understood by your browser are supported. For unambiguous results, include a timezone such as Z or an explicit UTC offset.",
      },
    ],
    cta: {
      headline: "Building tools that handle dates and APIs?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "color-converter",
    path: "/color-converter",
    title: "Color Converter & Contrast Checker",
    tagline: "Design",
    cardDescription:
      "Convert between HEX, RGB, and HSL formats with alpha support, live swatch preview, and WCAG AA and AAA accessibility contrast checking.",
    features: ["HEX", "RGB", "HSL", "Alpha", "WCAG contrast"],
    accentVar: "--fuchsia",
    accentHex: "#F26DF0",
    metaTitle: "Color Converter & Contrast Checker - Free Tool",
    metaDescription:
      "Convert colors between HEX, RGB, and HSL formats with alpha support, live swatch preview, and WCAG AA/AAA contrast ratio checking. Fast, free, and private.",
    ogTitle: "Color Converter & Contrast Checker - CODERCOPS Tools",
    ogDescription:
      "Convert between HEX, RGB, and HSL with alpha channel support, live swatch, and WCAG contrast ratios.",
    heroBreadcrumb: "Convert · Preview · Contrast",
    heroHeading: "Color Converter & Contrast Checker",
    heroDim: "&",
    heroDescription:
      "Convert colors between HEX, RGB, and HSL formats and check WCAG accessibility contrast ratios in real time — 100% in your browser.",
    jsonLdName: "Color Converter & Contrast Checker",
    jsonLdDescription:
      "Free online color converter and contrast checker supporting HEX, RGB, HSL, alpha channel, and WCAG AA/AAA contrast ratios.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "How does the color converter handle alpha transparency?",
        a: "Alpha transparency is supported in 8-digit HEX (#rrggbbaa), rgba(), and hsla() notations. Alpha is normalized between 0 and 1 and factored into contrast calculations when blended over backgrounds.",
      },
      {
        q: "What are WCAG AA and AAA contrast requirements?",
        a: "Under WCAG 2.1 guidelines, normal text requires a contrast ratio of at least 4.5:1 for level AA and 7:1 for level AAA. Large text (at least 18pt or 14pt bold) requires at least 3:1 for AA and 4.5:1 for AAA.",
      },
      {
        q: "Can I enter modern CSS space-separated color syntax?",
        a: "Yes. Both legacy comma-separated syntax like rgb(255, 0, 0) and modern CSS Color 4 space-separated syntax like rgb(255 0 0 / 0.5) and hsl(200 100% 50% / 0.8) are supported.",
      },
      {
        q: "Is any color data sent to a server?",
        a: "No. All conversions, swatch rendering, and contrast calculations run entirely in your browser using client-side JavaScript. No data ever leaves your device.",
      },
    ],
    cta: {
      headline: "Building accessible web apps and design systems?",
      sub: "CODERCOPS designs and builds accessible, high-performance web applications and UI component systems for startups and enterprises.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get in touch",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "case-converter",
    path: "/case-converter",
    title: "Text Case Converter",
    tagline: "Text",
    cardDescription:
      "Convert text between camelCase, snake_case, kebab-case, and 7 more naming conventions. Handles acronyms, digits, and multi-line input.",
    features: ["camelCase", "snake_case", "kebab-case", "CONSTANT_CASE", "Title Case"],
    accentVar: "--lime",
    accentHex: "#A6F36B",
    metaTitle: "Text Case Converter - Free Online Tool",
    metaDescription:
      "Free online text case converter. Convert between camelCase, snake_case, kebab-case, CONSTANT_CASE and 6 more styles instantly in your browser. No signup.",
    ogTitle: "Text Case Converter - CODERCOPS Tools",
    ogDescription:
      "Convert text between camelCase, snake_case, kebab-case, CONSTANT_CASE and more. Free, instant, and private.",
    heroBreadcrumb: "Text",
    heroHeading: "Text Case Converter",
    heroDim: "Converter",
    heroDescription:
      "Paste text once and get it in every common naming convention — camelCase, snake_case, kebab-case, and more. Everything runs in your browser.",
    jsonLdName: "Text Case Converter",
    jsonLdDescription:
      "Free online text case converter supporting camelCase, PascalCase, snake_case, CONSTANT_CASE, kebab-case, dot.case, Title Case, and more.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Is my text uploaded anywhere?",
        a: "No. All conversion runs locally in your browser. The text you paste never leaves your tab, is never sent to a server, and is never logged.",
      },
      {
        q: "How does it split words?",
        a: "It breaks on spaces, underscores, dashes, dots, and slashes, detects camelCase and PascalCase boundaries, keeps acronyms like XMLHttpRequest as single words, and understands non-ASCII letters.",
      },
      {
        q: "Which cases are supported?",
        a: "Ten styles: camelCase, PascalCase, snake_case, CONSTANT_CASE, kebab-case, dot.case, Title Case, Sentence case, lowercase, and UPPERCASE. Multi-line input is converted line by line.",
      },
    ],
    cta: {
      headline: "Renaming things across a whole codebase?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "number-base-converter",
    path: "/number-base-converter",
    title: "Number Base Converter",
    tagline: "Numbers",
    cardDescription:
      "Convert integers between binary, octal, decimal, hex and any base from 2 to 36, with two's complement for 8, 16, 32 and 64 bits.",
    features: ["Binary", "Octal", "Decimal", "Hex", "Two's complement"],
    accentVar: "--violet",
    accentHex: "#9E7BFF",
    metaTitle: "Number Base Converter - Binary, Hex, Octal, Decimal",
    metaDescription:
      "Number base converter for binary, octal, decimal, hex and any base from 2 to 36, with two's complement up to 64 bits. Exact for big numbers, in your browser.",
    ogTitle: "Number Base Converter - CODERCOPS Tools",
    ogDescription:
      "Convert integers between binary, octal, decimal, hex and any base up to 36, with two's complement, in your browser.",
    heroBreadcrumb: "Binary · Octal · Decimal · Hex",
    heroHeading: "Number Base Converter",
    heroDim: "",
    heroDescription:
      "Paste an integer in any base from 2 to 36 and read it in binary, octal, decimal and hex at once, plus its two's complement. Big numbers stay exact.",
    jsonLdName: "Number Base Converter",
    jsonLdDescription:
      "Free online converter for integers between bases 2 to 36, including binary, octal, decimal and hex, with two's complement for 8, 16, 32 and 64 bits.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Which prefixes and separators does it understand?",
        a: "With the input base on auto-detect, 0b means binary, 0o octal and 0x hex, and anything else is read as decimal. A leading - or + comes before the prefix, as in -0b1010. Underscores and spaces between digits are ignored, so 1111_1111 and 1 000 000 both work.",
      },
      {
        q: "Does it handle numbers bigger than 2^53?",
        a: "Yes. Every conversion uses JavaScript BigInt, so there is no rounding at any size. 18446744073709551616 (2^64) comes out as exactly 10000000000000000 in hex.",
      },
      {
        q: "How does two's complement work here?",
        a: "Pick a width of 8, 16, 32 or 64 bits. A negative number is written as 2^width plus the value, so -1 in 8 bits is 11111111. If the number doesn't fit in a signed integer of that width, for example 128 in 8 bits, the tool says so instead of wrapping it around.",
      },
      {
        q: "Is my input sent anywhere?",
        a: "No. The conversion runs entirely in your browser. Nothing you type leaves the page.",
      },
    ],
    cta: {
      headline: "Working close to the bits?",
      sub: "CODERCOPS builds production APIs, data pipelines, and developer tooling for startups and enterprises.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "uuid-generator",
    path: "/uuid-generator",
    title: "UUID Generator & Inspector",
    tagline: "Identifiers",
    cardDescription:
      "Generate UUID v4 and v7 identifiers locally, create batches, customize formatting, and inspect versions, variants, and v7 timestamps.",
    features: ["UUID v4", "UUID v7", "Bulk", "Inspect", "No hyphens"],
    accentVar: "--amber",
    accentHex: "#FFB547",
    metaTitle: "UUID Generator & Inspector - Free Online Tool",
    metaDescription:
      "Generate UUID v4 and v7 values in your browser. Create batches, choose uppercase or compact output, and inspect UUID versions, variants, and timestamps.",
    ogTitle: "UUID Generator & Inspector - CODERCOPS Tools",
    ogDescription:
      "Generate UUID v4 and v7 identifiers, create batches, and inspect versions, variants, and timestamps locally.",
    heroBreadcrumb: "Identifiers",
    heroHeading: "UUID Generator & Inspector",
    heroDim: "&",
    heroDescription:
      "Generate random UUID v4 and time-ordered UUID v7 values, or inspect a UUID's version, variant, and v7 timestamp. Everything stays in your browser.",
    jsonLdName: "UUID Generator & Inspector",
    jsonLdDescription:
      "A browser-based UUID v4 and v7 generator and inspector with bulk generation, formatting options, and UUID version, variant, and timestamp details.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What UUID versions can I generate?",
        a: "Generate random UUID v4 values or time-ordered UUID v7 values, which include a Unix timestamp in milliseconds. Other versions are outside this tool's scope.",
      },
      {
        q: "Can I generate multiple UUIDs at once?",
        a: "Yes. Generate between 1 and 100 UUIDs at a time, then copy an individual value or the complete batch.",
      },
      {
        q: "What does the inspector show?",
        a: "It identifies the UUID version and variant. For UUID v7, it also displays the encoded Unix timestamp in milliseconds and as a date.",
      },
      {
        q: "Are my UUIDs sent to a server?",
        a: "No. UUID generation, formatting, and inspection happen in your browser. Nothing you enter or generate is uploaded.",
      },
    ],
    cta: {
      headline: "Building software that needs reliable identifiers?",
      sub: "CODERCOPS builds production APIs, data systems, and full-stack applications for startups and enterprises.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get in touch",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "cron-explainer",
    path: "/cron-explainer",
    title: "Cron Expression Explainer",
    tagline: "Scheduling",
    cardDescription:
      "Paste a crontab line and get a plain-English description, a field-by-field breakdown and the next run times in UTC or your local time.",
    features: ["Plain English", "Next runs", "Ranges and steps", "Macros", "UTC or local"],
    accentVar: "--sky",
    accentHex: "#5AB5FF",
    metaTitle: "Cron Expression Explainer - Free Online Tool",
    metaDescription:
      "Paste a cron expression and read it in plain English with the next run times. Handles ranges, steps, names and macros like @daily. Runs in your browser.",
    ogTitle: "Cron Expression Explainer - CODERCOPS Tools",
    ogDescription:
      "Explain any cron expression in plain English and see the next run times in UTC or local time. Free and private.",
    heroBreadcrumb: "Scheduling",
    heroHeading: "Cron Expression Explainer",
    heroDim: "",
    heroDescription:
      "Paste a crontab line from a CI schedule, a Kubernetes CronJob or a GitHub Actions workflow and see what it means, field by field, with the next times it runs. Everything stays in your browser.",
    jsonLdName: "Cron Expression Explainer",
    jsonLdDescription:
      "A browser-based cron expression explainer that describes a schedule in plain English, breaks it down field by field and lists the next run times in UTC or local time.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Which cron syntax does it understand?",
        a: "Standard five-field cron: minute, hour, day of month, month and day of week. It reads lists, ranges, steps such as */15 and 1-10/2, month and weekday names such as JAN and MON, and the macros @hourly, @daily, @weekly, @monthly and @yearly. Seconds and year fields (Quartz style) and Jenkins H syntax are not supported.",
      },
      {
        q: "What happens when both the day of month and the day of week are set?",
        a: "Classic cron runs the job on days that match either one. So 0 0 1 * 1 runs at midnight on the first of every month and also every Monday. If either field starts with *, both have to match.",
      },
      {
        q: "How are the next run times worked out?",
        a: "The tool steps through the calendar from the current time and lists the next five times the schedule fires, in UTC or in your local time. A schedule that can never run, such as 0 0 31 2 *, says so instead of searching forever.",
      },
      {
        q: "Is my cron expression sent to a server?",
        a: "No. Parsing, describing and working out the run times all happen in your browser. Nothing you type is uploaded.",
      },
    ],
    cta: {
      headline: "Running scheduled jobs in production?",
      sub: "CODERCOPS builds reliable backends, data pipelines, and full-stack applications for startups and enterprises.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get in touch",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "csv-formatter",
    path: "/csv-formatter",
    title: "CSV/TSV Formatter & Validator",
    tagline: "Data",
    cardDescription:
      "Parse, validate, and pretty-print CSV/TSV. Auto-detect delimiters, convert to JSON, TypeScript, YAML, SQL, and fix common formatting issues.",
    features: ["Parse", "Validate", "Format", "JSON", "TypeScript", "YAML", "SQL"],
    accentVar: "--fuchsia",
    accentHex: "#F26DF0",
    metaTitle: "CSV/TSV Formatter & Validator - Free Online Tool",
    metaDescription:
      "Free online CSV/TSV formatter and validator. Parse, validate, format, and convert CSV/TSV to JSON, TypeScript, YAML, and SQL. Auto-detects delimiters.",
    ogTitle: "CSV/TSV Formatter & Validator - CODERCOPS Tools",
    ogDescription:
      "Parse and format CSV/TSV with auto delimiter detection. Convert to JSON, TypeScript, YAML, and SQL. Runs entirely in your browser.",
    heroBreadcrumb: "Parse · Validate · Convert",
    heroHeading: "CSV/TSV Formatter & Validator",
    heroDim: "&",
    heroDescription:
      "Paste your CSV or TSV below to parse, validate, format, and convert — all in your browser, nothing is uploaded.",
    jsonLdName: "CSV/TSV Formatter & Validator",
    jsonLdDescription:
      "Free online CSV/TSV formatter, validator, and converter with auto delimiter detection and JSON/TypeScript/YAML/SQL output.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Is my CSV data uploaded anywhere?",
        a: "No. All parsing, validation, formatting, and conversion run locally in your browser. The data you paste never leaves your tab, is never sent to a server, and is never logged.",
      },
      {
        q: "What delimiters are supported?",
        a: "The tool auto-detects commas, semicolons, tabs, and pipes. You can also manually select the delimiter if auto-detection picks the wrong one.",
      },
      {
        q: "How are quoted fields and escaped quotes handled?",
        a: "Fields containing delimiters, quotes, or newlines are quoted per RFC 4180. Double quotes inside a field are escaped by doubling them (\"\"), and newlines inside quotes stay part of the field instead of starting a new row.",
      },
      {
        q: "What encoding and file size are supported?",
        a: "Paste or upload UTF-8 text up to 10 MB. A UTF-8 BOM is detected and removed, CRLF/LF/CR line endings are handled, and blank rows are skipped. If the input contains U+FFFD or control characters, the validator warns that it may have been decoded with the wrong encoding.",
      },
    ],
    cta: {
      headline: "Building a data pipeline or migration tool?",
      sub: "CODERCOPS builds production-grade data pipelines, ETL jobs, and migration tools for startups and enterprises.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "regex-tester",
    path: "/regex-tester",
    title: "Regex Tester",
    tagline: "Patterns",
    cardDescription:
      "Test a JavaScript regular expression against sample text with highlighted matches, capture groups, named groups and a replace preview.",
    features: ["Live matches", "Flags", "Capture groups", "Named groups", "Replace"],
    accentVar: "--cyan",
    accentHex: "#00E5C7",
    metaTitle: "Regex Tester - Free Online JavaScript Regex Tool",
    metaDescription:
      "Test JavaScript regular expressions online. See highlighted matches, capture groups and named groups, toggle flags and preview replacements in your browser.",
    ogTitle: "Regex Tester - CODERCOPS Tools",
    ogDescription:
      "Test JavaScript regular expressions with highlighted matches, capture groups and a replace preview. Free and private.",
    heroBreadcrumb: "Patterns",
    heroHeading: "Regex Tester",
    heroDim: "",
    heroDescription:
      "Write a pattern, paste some text and see every match highlighted, with its capture groups and a preview of the replacement. Everything runs in your browser.",
    jsonLdName: "Regex Tester",
    jsonLdDescription:
      "A browser-based JavaScript regular expression tester with highlighted matches, capture and named groups, flag toggles and a replace preview.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Which regex flavor does it use?",
        a: "JavaScript, through your browser's own RegExp engine, so a pattern behaves here exactly as it does in your code. The flags g, i, m, s, u and y can be switched on and off. PCRE, Python and other flavors are not supported, and some of their syntax, such as possessive quantifiers, is not valid here.",
      },
      {
        q: "How do I use capture groups in the replacement?",
        a: "Use $1, $2 and so on for numbered groups, $<name> for a named group such as (?<year>\\d{4}), and $& for the whole match. Without the g flag only the first match is replaced, just like String.replace.",
      },
      {
        q: "Why can a pattern freeze the page?",
        a: "Some patterns, such as (a+)+$ on a long line of a's, make the engine try an exponential number of paths. This is called catastrophic backtracking. The tester runs the pattern in the page itself, so a pattern like that can hang the tab until it finishes. Test text is capped at 100,000 characters and at most 1,000 matches are listed.",
      },
      {
        q: "Is my text sent to a server?",
        a: "No. Matching and replacing happen in your browser, and nothing you type is uploaded.",
      },
    ],
    cta: {
      headline: "Need help with parsing or validation logic?",
      sub: "CODERCOPS builds reliable backends, data pipelines, and full-stack applications for startups and enterprises.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get in touch",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "markdown-preview",
    path: "/markdown-preview",
    title: "Markdown Live Preview",
    tagline: "Markdown",
    cardDescription: "Write Markdown and see sanitized, GitHub-flavored HTML rendered live. Copy HTML or download the source without leaving your browser.",
    features: ["GFM", "Live preview", "Sanitized HTML", "Stats", "Export"],
    accentVar: "--green",
    accentHex: "#3FDD6B",
    metaTitle: "Markdown Live Preview - GFM Editor & HTML Export",
    metaDescription: "Write GitHub-flavored Markdown and preview sanitized HTML live. Copy HTML, download Markdown, and track writing stats in your browser.",
    ogTitle: "Markdown Live Preview - CODERCOPS Tools",
    ogDescription: "A private, client-side Markdown editor with GFM preview, sanitized HTML export, and writing stats.",
    heroBreadcrumb: "Write · Preview · Export",
    heroHeading: "Markdown Live Preview",
    heroDim: "Live",
    heroDescription: "Write GitHub-flavored Markdown on the left and preview sanitized HTML on the right — privately, in your browser.",
    jsonLdName: "Markdown Live Preview",
    jsonLdDescription: "A browser-based GitHub-flavored Markdown editor with sanitized live HTML preview, writing statistics, and Markdown or HTML export.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      { q: "Is my Markdown uploaded?", a: "No. Parsing, sanitizing, previewing, and exporting all happen locally in your browser. Your document never leaves this tab." },
      { q: "Is the preview safe for untrusted Markdown?", a: "Yes. The generated HTML is sanitized with DOMPurify before it is rendered or copied, so unsafe markup and scripts are removed." },
      { q: "Which Markdown features are supported?", a: "The preview supports GitHub-flavored Markdown including tables, task lists, strikethrough, autolinks, headings, links, images, and fenced code blocks." },
    ],
    cta: { headline: "Need a content editor in your product?", sub: "CODERCOPS builds polished developer tools, content workflows, and full-stack applications for startups and businesses.", primaryLabel: "View our work", primaryHref: CTA_PROJECTS, secondaryLabel: "Get a free quote", secondaryHref: CTA_CONTACT },
    sitemapPriority: 0.9,
  },
];

export function getTool(slug: string): Tool | undefined {
  return TOOLS.find((t) => t.slug === slug);
}

// Sibling tools for a tool page: same application category first, then the
// rest of the registry in declaration order. Deterministic (no randomness),
// never includes the current tool, and never reorders the registry — the same
// slug always yields the same list. `tools` is injectable for tests.
export function getRelatedTools(
  currentSlug: string,
  limit = 3,
  tools: Tool[] = TOOLS
): Tool[] {
  const current = tools.find((t) => t.slug === currentSlug);
  if (!current) return [];

  const sameCategory: Tool[] = [];
  const others: Tool[] = [];
  for (const t of tools) {
    if (t.slug === currentSlug) continue;
    if (t.applicationCategory === current.applicationCategory) {
      sameCategory.push(t);
    } else {
      others.push(t);
    }
  }

  return [...sameCategory, ...others].slice(0, limit);
}

export const SITE_URL = "https://tools.codercops.com";

// The open-source repo. GITHUB_REPO is the "owner/name" slug used for the API.
export const GITHUB_REPO = "codercops/toolbelt";
export const GITHUB_REPO_URL = `https://github.com/${GITHUB_REPO}`;