@knitli/docs-components 1.1.11 → 1.2.1

package/dist/data/products.d.ts

@@ -0,0 +1,44 @@
+export type ProductStatus = "available" | "coming-soon" | "alpha" | "beta";
+export interface Product {
+    /** URL slug used in docs paths, e.g. "recoco" */
+    slug: string;
+    /** Display name */
+    name: string;
+    /** Short tagline for cards/nav */
+    tagline: string;
+    /** Primary description */
+    description: string;
+    /** Bold/emphasized callout text */
+    highlight?: string;
+    /** Italicized footnote (e.g. "Now in Alpha.") */
+    footnote?: string;
+    /** Product status — drives card rendering and footer links */
+    status: ProductStatus;
+    /** Docs URL — relative for hosted docs, absolute for external */
+    docsUrl?: string;
+    /** Whether docs are hosted externally (e.g. docs.rs) */
+    external?: boolean;
+    /** Logo asset key from DocsAssets */
+    logo: string;
+    /** Dark-mode logo asset key from DocsAssets */
+    darkLogo?: string;
+    /** Sort order for display */
+    order: number;
+    /** Set false to hide from docs-home without deleting */
+    featured?: boolean;
+}
+/** All products from the catalog */
+export declare const products: Product[];
+/** Products marked as featured (or not explicitly unfeatured), sorted by order */
+export declare function featuredProducts(): Product[];
+/** Products with available documentation (not coming-soon) */
+export declare function availableProducts(): Product[];
+/** Look up a single product by slug */
+export declare function getProduct(slug: string): Product | undefined;
+/** Look up a product by display name */
+export declare function getProductByName(name: string): Product | undefined;
+/** All valid product display names, derived from catalog */
+export declare function productNames(): string[];
+/** Generate sitemap URLs for products with hosted (non-external) docs */
+export declare function getProductSitemaps(baseUrl?: string): string[];
+//# sourceMappingURL=products.d.ts.map

package/dist/data/products.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.d.ts","sourceRoot":"","sources":["../../src/data/products.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE3E,MAAM,WAAW,OAAO;IACtB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,aAAa,CAAC;IACtB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oCAAoC;AACpC,eAAO,MAAM,QAAQ,EAAE,OAAO,EAA6B,CAAC;AAE5D,kFAAkF;AAClF,wBAAgB,gBAAgB,IAAI,OAAO,EAAE,CAI5C;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,IAAI,OAAO,EAAE,CAE7C;AAED,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE5D;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAElE;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAChC,OAAO,SAA4B,GAClC,MAAM,EAAE,CAIV"}

package/dist/data/products.js

@@ -0,0 +1,38 @@
+// SPDX-FileCopyrightText: 2025 Knitli Inc.
+// SPDX-FileContributor: Adam Poulemanos <adam@knit.li>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+//
+// Product catalog — single source of truth for all Knitli product metadata.
+// Edit products.json to add, remove, reorder, or update products.
+import catalogData from "./products.json" with { type: "json" };
+/** All products from the catalog */
+export const products = catalogData;
+/** Products marked as featured (or not explicitly unfeatured), sorted by order */
+export function featuredProducts() {
+    return products
+        .filter((p) => p.featured !== false)
+        .sort((a, b) => a.order - b.order);
+}
+/** Products with available documentation (not coming-soon) */
+export function availableProducts() {
+    return products.filter((p) => p.status !== "coming-soon");
+}
+/** Look up a single product by slug */
+export function getProduct(slug) {
+    return products.find((p) => p.slug === slug);
+}
+/** Look up a product by display name */
+export function getProductByName(name) {
+    return products.find((p) => p.name === name);
+}
+/** All valid product display names, derived from catalog */
+export function productNames() {
+    return products.map((p) => p.name);
+}
+/** Generate sitemap URLs for products with hosted (non-external) docs */
+export function getProductSitemaps(baseUrl = "https://docs.knitli.com") {
+    return products
+        .filter((p) => p.docsUrl && !p.external && p.status !== "coming-soon")
+        .map((p) => `${baseUrl}/${p.slug}/sitemap-index.xml`);
+}

package/dist/data/products.json

@@ -0,0 +1,45 @@
+[
+    {
+        "slug": "recoco",
+        "name": "Recoco",
+        "tagline": "Intelligent data pipelines",
+        "description": "Build intelligent data pipelines and ETL workflows. Only process changed data.",
+        "highlight": "Pure Rust, minimal dependencies, maximum efficiency.",
+        "status": "available",
+        "docsUrl": "/recoco/",
+        "external": false,
+        "logo": "recocoLogoSm",
+        "darkLogo": "recocoLogoSm",
+        "order": 1,
+        "featured": true
+    },
+    {
+        "slug": "codeweaver",
+        "name": "CodeWeaver",
+        "tagline": "AI code context engine",
+        "description": "Your AI code assistants can do better.",
+        "highlight": "CodeWeaver gives AI agents tailored code context and project understanding, stopping hallucinations, cutting token waste, and supercharging your AI coding workflows.",
+        "footnote": "Now in Alpha.",
+        "status": "coming-soon",
+        "external": false,
+        "logo": "codeweaverPrimary",
+        "darkLogo": "codeweaverReverse",
+        "order": 2,
+        "featured": true
+    },
+    {
+        "slug": "thread",
+        "name": "Thread",
+        "tagline": "Ultra-fast codebase analysis",
+        "description": "An ultra-fast, Rust-native, codebase analysis platform.",
+        "highlight": "Real-time code understanding and navigation for the largest codebases. Delivers 50x+ speed improvements over comparable tools with minimal resource usage. Works locally, on the edge, or in the cloud.",
+        "footnote": "Limited features available now, full release coming soon.",
+        "status": "available",
+        "docsUrl": "https://docs.rs/thread",
+        "external": true,
+        "logo": "threadLogoLight",
+        "darkLogo": "threadLogoDark",
+        "order": 3,
+        "featured": true
+    }
+]

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./data/products.js";
 export * from "./types/index.js";
 export declare const DocsAssets: {
     knitliLogo: string;
@@ -43,6 +44,12 @@ declare const _default: {
     DocsBreadcrumb: () => Promise<typeof import("*.astro")>;
     DocsFooter: () => Promise<typeof import("*.astro")>;
     PageFrame: () => Promise<typeof import("*.astro")>;
+    Contributors: () => Promise<typeof import("*.astro")>;
+    AllContributors: () => Promise<typeof import("*.astro")>;
+    SeoMeta: () => Promise<typeof import("*.astro")>;
+    ProductCard: () => Promise<typeof import("*.astro")>;
+    ProductGrid: () => Promise<typeof import("*.astro")>;
+    ProductShowcase: () => Promise<typeof import("*.astro")>;
 };
 export default _default;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,cAAc,kBAAkB,CAAC;AAuBjC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CAmBtB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AAQF,wBAGE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,cAAc,oBAAoB,CAAC;AAEnC,cAAc,kBAAkB,CAAC;AAuBjC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CAmBtB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBF,wBAGE"}

package/dist/index.js

@@ -4,7 +4,8 @@
 // SPDX-License-Identifier: MIT OR Apache-2.0
 //
 // Main exports for @knitli/docs-components package
-// Export type definitions
+export * from "./data/products.js";
+// Export type definitions and product catalog
 export * from "./types/index.js";
 import { faviconIco, faviconSvg } from "./assets/favicon/index.js";
 import { codeweaverPrimary, codeweaverReverse, headlineLogoDark, headlineLogoLight, knitliLogo, knitliWordmark, recocoLogoLg, recocoLogoMed, recocoLogoSm, recocoLogoXl, recocoLogoXs, threadLogoDark, threadLogoLight, } from "./assets/logos/index.js";
@@ -34,6 +35,12 @@ const components = {
     DocsBreadcrumb: async () => await import("./components/DocsBreadcrumb.astro"),
     DocsFooter: async () => await import("./components/Footer.astro"),
     PageFrame: async () => await import("./components/PageFrame.astro"),
+    Contributors: async () => await import("./components/Contributors.astro"),
+    AllContributors: async () => await import("./components/AllContributors.astro"),
+    SeoMeta: async () => await import("./components/SeoMeta.astro"),
+    ProductCard: async () => await import("./components/ProductCard.astro"),
+    ProductGrid: async () => await import("./components/ProductGrid.astro"),
+    ProductShowcase: async () => await import("./components/ProductShowcase.astro"),
 };
 export default {
     ...components,

package/dist/types/index.d.ts

@@ -1,7 +1,3 @@
-/**
- * Supported Knitli products for documentation
- */
-export type ProductName = "Recoco" | "CodeWeaver" | "Thread";
 /**
  * Site URLs configuration
  */
@@ -17,7 +13,7 @@ export interface DocsBreadcrumbProps {
     /**
      * Current product name
      */
-    product?: ProductName;
+    product?: string;
     /**
      * URL to the product's documentation home
      */
@@ -30,6 +26,6 @@ export interface DocsBreadcrumbProps {
      * Visual variant of the breadcrumb
      * @default 'default'
      */
-    variant?: "default" | "compact";
+    variant?: "default" | "compact" | "inline";
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,WAAW,CAAC;IAEtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;CACjC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAC5C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knitli/docs-components",
-  "version": "1.1.11",
+  "version": "1.2.1",
   "description": "Shared branded components for Knitli documentation sites",
   "keywords": [
     "knitli",
@@ -26,6 +26,13 @@
     "./DocsBreadcrumb.astro": "./src/components/DocsBreadcrumb.astro",
     "./Footer.astro": "./src/components/Footer.astro",
     "./PageFrame.astro": "./src/components/PageFrame.astro",
+    "./Contributors.astro": "./src/components/Contributors.astro",
+    "./AllContributors.astro": "./src/components/AllContributors.astro",
+    "./SeoMeta.astro": "./src/components/SeoMeta.astro",
+    "./ProductCard.astro": "./src/components/ProductCard.astro",
+    "./ProductGrid.astro": "./src/components/ProductGrid.astro",
+    "./ProductShowcase.astro": "./src/components/ProductShowcase.astro",
+    "./products": "./src/data/products.ts",
     "./custom.css": "./src/styles/custom.css",
     "./assets/logos/*": "./src/assets/logos/*",
     "./assets/styles/*": "./src/assets/styles/*"
@@ -42,9 +49,11 @@
   "scripts": {
     "build": "bunx tsc && bun run copy-assets",
     "copy-assets": "bun run scripts/copy-assets.mjs",
-    "prepublishOnly": "bun run copy-assets && bun run build",
-    "publish": "npm publish --access public || node --input-type=commonjs -e \"const v=require('./package.json').version;const r=require('child_process').spawnSync('npm',['view','@knitli/docs-components@'+v,'version'],{stdio:'ignore'});if(r.status===0){console.log('Version '+v+' already published, skipping')}else{process.exit(1)}\"",
-    "version": "auto-changelog -p && git add CHANGELOG.md"
+    "prepublishOnly": "bun run copy-assets && bun run build"
+  },
+  "dependencies": {
+    "astro-contributors": "catalog:astro-plugins",
+    "astro-seo-meta": "catalog:astro-plugins"
   },
   "devDependencies": {
     "@biomejs/biome": "catalog:dev-common",
@@ -54,7 +63,6 @@
     "@types/node": "catalog:types",
     "@types/react": "catalog:types",
     "astro": "catalog:astro-core",
-    "auto-changelog": "^2.4.0",
     "bun": "catalog:dev-common",
     "lightningcss": "catalog:optimization",
     "svgo": "catalog:optimization",

package/src/components/AllContributors.astro

@@ -0,0 +1,38 @@
+---
+// SPDX-FileCopyrightText: 2026 Knitli Inc.
+// SPDX-FileContributor: Adam Poulemanos <adam@knit.li>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+//
+// Knitli-branded wrapper around astro-contributors AllContributors grid.
+// Reads from .all-contributorsrc and pre-applies brand colors.
+//
+// Usage:
+//   <AllContributors />
+
+import { AllContributors as BaseAllContributors } from "astro-contributors";
+
+export interface Props {
+  /** Focus/accent color for hover outlines */
+  focusColor?: string;
+  /** Card background color */
+  bgColor?: string;
+  /** Card border color */
+  borderColor?: string;
+  /** Primary text color */
+  textColor?: string;
+  /** Contribution badge background color */
+  badgeBgColor?: string;
+  /** Contribution badge text color */
+  badgeTextColor?: string;
+}
+
+const {
+  focusColor = "var(--sl-color-accent, #ea5932)",
+  bgColor = "var(--sl-color-bg-nav, #f8f9fa)",
+  borderColor = "var(--sl-color-hairline, #e5e7eb)",
+  ...rest
+} = Astro.props;
+---
+
+<BaseAllContributors focusColor={focusColor} bgColor={bgColor} borderColor={borderColor} {...rest} />

package/src/components/Contributors.astro

@@ -0,0 +1,30 @@
+---
+// SPDX-FileCopyrightText: 2026 Knitli Inc.
+// SPDX-FileContributor: Adam Poulemanos <adam@knit.li>
+//
+// SPDX-License-Identifier: MIT OR Apache-2.0
+//
+// Knitli-branded wrapper around astro-contributors ContributorList.
+// Pre-applies brand colors while allowing per-instance overrides.
+//
+// Usage:
+//   <Contributors githubRepo="knitli/recoco" />
+
+import { ContributorList } from "astro-contributors";
+
+export interface Props {
+  /** GitHub repo in "owner/repo" format */
+  githubRepo?: `${string}/${string}`;
+  /** Usernames to exclude from the list */
+  ignore?: string[];
+  /** Focus/accent color for hover states. Defaults to Knitli rust. */
+  focusColor?: string;
+}
+
+const {
+  focusColor = "var(--sl-color-accent, #ea5932)",
+  ...rest
+} = Astro.props;
+---
+
+<ContributorList focusColor={focusColor} {...rest} />

package/src/components/DocsBreadcrumb.astro

@@ -5,7 +5,8 @@
 // SPDX-License-Identifier: MIT OR Apache-2.0
 
 interface Props {
-  product?: "Recoco" | "CodeWeaver" | "Thread";
+  /** Product name — validated against the product catalog */
+  product?: string;
   productUrl?: string;
   path?: string;
   /** 'inline' — no padding, designed for embedding in a subnav bar */

package/src/components/Footer.astro

@@ -20,14 +20,11 @@ import Pagination from "virtual:starlight/components/Pagination";
 // @ts-expect-error
 import config from "virtual:starlight/user-config";
 import { Icon } from "@astrojs/starlight/components";
+import { products } from "../data/products.js";
 
 const currentYear = new Date().getFullYear();
 
-const product = (import.meta.env.PUBLIC_DOCS_PRODUCT ?? "") as
-  | "Recoco"
-  | "CodeWeaver"
-  | "Thread"
-  | "";
+const product = (import.meta.env.PUBLIC_DOCS_PRODUCT ?? "") as string;
 
 const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
 ---
@@ -109,33 +106,26 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
         <p class="nav-heading">Docs</p>
         <ul>
           {shouldShowDocsHomeLink && <li><a href="https://docs.knitli.com">Developer Docs</a></li>}
-          <li>
-            {product === "Recoco" ? (
-              <span class="link-current">Recoco</span>
-            ) : (
-              <a href="https://docs.knitli.com/recoco/">Recoco</a>
-            )}
-          </li>
-          <li>
-            {product === "CodeWeaver" ? (
-              <span class="link-current">CodeWeaver</span>
-            ) : (
-              <a href="https://docs.knitli.com/codeweaver/">CodeWeaver</a>
-            )}
-          </li>
-          <li>
-            {product === "Thread" ? (
-              <span class="link-current">Thread</span>
-            ) : (
-              <a
-                href="https://docs.rs/thread"
-                target="_blank"
-                rel="noopener noreferrer"
-              >
-                Thread ↗
-              </a>
-            )}
-          </li>
+          {products
+            .filter((p) => p.docsUrl)
+            .sort((a, b) => a.order - b.order)
+            .map((p) => (
+              <li key={p.name}>
+                {product === p.name ? (
+                  <span class="link-current">{p.name}</span>
+                ) : p.external ? (
+                  <a
+                    href={p.docsUrl}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                  >
+                    {p.name} ↗
+                  </a>
+                ) : (
+                  <a href={`https://docs.knitli.com/${p.slug}/`}>{p.name}</a>
+                )}
+              </li>
+            ))}
         </ul>
       </nav>
     </div>

package/src/components/PageFrame.astro

@@ -20,11 +20,7 @@ import DocsBreadcrumb from "./DocsBreadcrumb.astro";
 
 const { hasSidebar } = Astro.locals.starlightRoute;
 
-const product = import.meta.env.PUBLIC_DOCS_PRODUCT as
-  | "Recoco"
-  | "CodeWeaver"
-  | "Thread"
-  | undefined;
+const product = import.meta.env.PUBLIC_DOCS_PRODUCT as string | undefined;
 
 // Strip the configured base URL to get the within-product path for the breadcrumb.
 // e.g. for base='/Recoco/' and pathname='/Recoco/guide/start', path = 'guide/start'