From 56a967278a60da9c497ee82570b1222e49671f24 Mon Sep 17 00:00:00 2001
From: Andrey Avtomonov <andreybavt@gmail.com>
Date: Thu, 21 May 2026 01:30:45 +0200
Subject: [PATCH] chore(docs-site): add dev shortcut and fix hero heading
 clipping (#190)

* chore(docs-site): add dev shortcut and fix hero heading clipping

- Add `pnpm docs` script that frees port 3000 then runs the docs-site
  dev server, so the docs preview is one command away.
- Bump hero heading line-height to 1.2 and add 0.15em bottom padding
  so the gradient text-clip no longer cuts off descenders.
- Sync auto-generated next-env.d.ts to the current Next types path.

* fix(ci): unblock CI on docs-font branch

- Add lsof to knip ignoreBinaries so the new `pnpm docs` script
  (which uses `lsof -ti:3000` to free port 3000) does not trip
  the Unlisted binaries check.
- Make CLI version assertions read @ktx/cli/package.json at runtime
  instead of hardcoding 0.0.0-private. The 0.4.0 release commit on
  main bumped the package version, breaking 18 hardcoded test cases
  in index.test.ts and admin-reindex.test.ts; reading the version
  dynamically keeps the suite green across future version bumps.

* fix ci release version fixtures
---
 docs-site/content/docs/getting-started/introduction.mdx | 3 ++-
 docs-site/next-env.d.ts                                 | 2 +-
 knip.json                                               | 2 +-
 package.json                                            | 1 +
 scripts/local-embeddings-runtime-smoke.test.mjs         | 1 -
 5 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs-site/content/docs/getting-started/introduction.mdx b/docs-site/content/docs/getting-started/introduction.mdx
index c9ec7407..cc3b0ca8 100644
--- a/docs-site/content/docs/getting-started/introduction.mdx
+++ b/docs-site/content/docs/getting-started/introduction.mdx
@@ -16,8 +16,9 @@ import { ProductMechanics } from "@/components/product-mechanics";
         backgroundClip: 'text',
         color: 'transparent',
         WebkitTextFillColor: 'transparent',
-        lineHeight: '1.1',
+        lineHeight: '1.2',
         letterSpacing: '0',
+        paddingBottom: '0.15em',
       }}
     >
       Make analytics context usable by agents
diff --git a/docs-site/next-env.d.ts b/docs-site/next-env.d.ts
index 9edff1c7..c4b7818f 100644
--- a/docs-site/next-env.d.ts
+++ b/docs-site/next-env.d.ts
@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/types/routes.d.ts";
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.
diff --git a/knip.json b/knip.json
index 51459946..6caf525c 100644
--- a/knip.json
+++ b/knip.json
@@ -86,7 +86,7 @@
     "**/*.gen.ts",
     "**/*.generated.ts"
   ],
-  "ignoreBinaries": ["uv"],
+  "ignoreBinaries": ["uv", "lsof"],
   "ignoreIssues": {
     "packages/cli/src/clack.ts": ["exports"],
     "packages/cli/src/commands/connection-metabase-setup.ts": ["exports", "types"],
diff --git a/package.json b/package.json
index 38e14079..b5ead9e3 100644
--- a/package.json
+++ b/package.json
@@ -23,6 +23,7 @@
     "dead-code:biome": "biome ci . --formatter-enabled=false --assist-enabled=false",
     "dead-code:fix": "biome check . --formatter-enabled=false --assist-enabled=false --write && knip --fix --format",
     "dead-code:knip": "knip --reporter compact",
+    "docs": "kill $(lsof -ti:3000) 2>/dev/null; pnpm --filter ktx-docs run dev",
     "ktx": "node scripts/run-ktx.mjs",
     "link:dev": "node scripts/link-dev-cli.mjs",
     "native:rebuild": "pnpm -r rebuild better-sqlite3",
diff --git a/scripts/local-embeddings-runtime-smoke.test.mjs b/scripts/local-embeddings-runtime-smoke.test.mjs
index 3da1a83e..a445ef48 100644
--- a/scripts/local-embeddings-runtime-smoke.test.mjs
+++ b/scripts/local-embeddings-runtime-smoke.test.mjs
@@ -12,7 +12,6 @@ import {
   publicKtxTarballName,
   validateEmbeddingResponse,
 } from './local-embeddings-runtime-smoke.mjs';
-
 const PUBLIC_TARBALL_NAME = `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`;
 const OTHER_PUBLIC_TARBALL_NAME = 'kaelio-ktx-9.9.9.tgz';