@knitli/docs-components 1.1.10 → 1.1.12

package/dist/assets/logos/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/assets/logos/index.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,UAAU,QAAqC,CAAC;AAC7D,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AACvE,eAAO,MAAM,gBAAgB,QAA6C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,cAAc,QAAyC,CAAC;AACrE,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,aAAa,QAAqC,CAAC;AAChE,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,cAAc,QAAsD,CAAC;AAClF,eAAO,MAAM,eAAe,QAAsD,CAAC;AAEnF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/assets/logos/index.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,UAAU,QAAqC,CAAC;AAC7D,eAAO,MAAM,iBAAiB,QAAwC,CAAC;AACvE,eAAO,MAAM,gBAAgB,QAA6C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,iBAAiB,QAA4C,CAAC;AAC3E,eAAO,MAAM,cAAc,QAAyC,CAAC;AACrE,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,aAAa,QAAqC,CAAC;AAChE,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,YAAY,QAAoC,CAAC;AAC9D,eAAO,MAAM,cAAc,QAG1B,CAAC;AACF,eAAO,MAAM,eAAe,QAG3B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC"}

package/dist/assets/styles/variables.css

@@ -89,8 +89,8 @@
   /* === FONT FAMILIES === */
   /* Knitli Brand Fonts - Warm, Editorial */
   --font-knitli-display:
-    "Playfair Display", Didot, "Palatino Linotype", "Noto Serif", "DejaVu Serif",
-    serif;
+    "Playfair Display", Didot, "Palatino Linotype", "Noto Serif",
+    "DejaVu Serif", serif;
   --font-knitli-body:
     "Crimson Pro", Baskerville, Cambria, "Palatino Linotype", "Noto Serif",
     "DejaVu Serif", serif;

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;AAwBjC,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;CAmBtB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;AAQF,wBAGE"}
+{"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"}

package/dist/index.js

@@ -6,8 +6,8 @@
 // Main exports for @knitli/docs-components package
 // Export type definitions
 export * from "./types/index.js";
-import { codeweaverPrimary, codeweaverReverse, headlineLogoDark, headlineLogoLight, knitliLogo, knitliWordmark, recocoLogoLg, recocoLogoXs, recocoLogoMed, recocoLogoSm, recocoLogoXl, threadLogoDark, threadLogoLight, } from "./assets/logos/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";
 import { codeweaverTheme, variables } from "./assets/styles/index.js";
 import { docsStyle } from "./styles/index.js";
 export const DocsAssets = {

package/dist/templates/AstroConfigTemplate.d.mts

@@ -0,0 +1,3 @@
+declare const _default: import("astro").AstroUserConfig<never, never, import("astro").FontProvider<never>[]>;
+export default _default;
+//# sourceMappingURL=AstroConfigTemplate.d.mts.map

package/dist/templates/AstroConfigTemplate.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AstroConfigTemplate.d.mts","sourceRoot":"","sources":["../../src/templates/AstroConfigTemplate.mjs"],"names":[],"mappings":""}

package/dist/templates/AstroConfigTemplate.mjs

@@ -0,0 +1,305 @@
+// SPDX-FileCopyrightText: 2026 Knitli Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+// @ts-check
+// import cloudflare from "@astrojs/cloudflare";
+// import mdx from "@astrojs/mdx";
+// import sitemap from "@astrojs/sitemap";
+import starlight from "@astrojs/starlight";
+// import favicons from "astro-favicons";
+import { DocsAssets } from "@knitli/docs-components";
+import { defineConfig, fontProviders } from "astro/config";
+import { searchForWorkspaceRoot } from "vite";
+// import starlightHeadingBadges from "starlight-heading-badges";
+// import starlightContextualMenu from "starlight-contextual-menu";
+// import starlightTags from "starlight-tags";
+// import starlightLlmsText from "starlight-llms-txt";
+const { headlineLogoDark, headlineLogoLight, variables, docsStyle, faviconIco, faviconSvg, } = DocsAssets;
+const appName = "APP_NAME";
+const description = "DESCRIPTION";
+const shikiCfg = {
+    themes: ["catppuccin-latte", "catppuccin-mocha"],
+    bundledLangs: [
+        "ansi",
+        "rust",
+        "astro",
+        "yaml",
+        "bash",
+        "python",
+        "json",
+        "toml",
+        "typescript",
+        "markdown",
+    ],
+    langAlias: {
+        sh: "bash",
+        js: "typescript",
+        py: "python",
+        rs: "rust",
+        md: "markdown",
+        yml: "yaml",
+    },
+};
+// https://astro.build/config
+export default defineConfig({
+    site: "https://docs.knitli.com",
+    base: `/${appName.toLowerCase()}/`,
+    /*
+    adapter: cloudflare({
+      experimental: {
+        headersAndRedirectsDevModeSupport: true,
+      },
+      configPath: "./wrangler.jsonc",
+      imageService: "compile",
+    }),
+  */
+    favicon: faviconIco,
+    // Image optimization
+    image: {
+        service: {
+            entrypoint: "astro/assets/services/sharp",
+        },
+        responsiveStyles: true,
+        layout: "constrained",
+        domains: [
+            "github.com",
+            "raw.githubusercontent.com",
+            "docs.knitli.com",
+            "knitli.com",
+            "avatars.githubusercontent.com",
+            "ui-avatars.com",
+            `${appName.toLowerCase()}.knitli.com`,
+        ],
+    },
+    fonts: [
+        {
+            provider: fontProviders.google,
+            name: "DM Mono",
+            cssVariable: "--font-sans",
+            weights: [400, 500, 700],
+            styles: ["normal", "italic"],
+            subsets: ["latin"],
+            formats: ["woff2"],
+            fallbacks: [
+                "Roboto Mono",
+                "Menlo",
+                "Consolas",
+                "DejaVu Sans Mono",
+                "monospace",
+            ],
+        },
+        {
+            provider: fontProviders.google,
+            name: "JetBrains Mono",
+            cssVariable: "--font-mono",
+            weights: [400, 500, 700],
+            styles: ["normal", "italic"],
+            subsets: ["latin"],
+            formats: ["woff2"],
+            fallbacks: [
+                "DM Mono",
+                "Roboto Mono",
+                "Menlo",
+                "Consolas",
+                "DejaVu Sans Mono",
+                "monospace",
+            ],
+        },
+    ],
+    headingIdCompat: true,
+    preserveScriptOrder: true,
+    // Build optimizations
+    build: {
+        inlineStylesheets: "auto",
+        assets: "_astro",
+    },
+    markdown: {
+        shikiConfig: {
+            ...Object.fromEntries(Object.entries(shikiCfg).map(([key, value]) => key === "themes"
+                ? [
+                    key,
+                    {
+                        light: "catppuccin-latte",
+                        dark: "catppuccin-mocha",
+                    },
+                ]
+                : [key, value])),
+        },
+    },
+    trailingSlash: "always",
+    // Vite configuration for better bundling
+    vite: {
+        server: {
+            fs: {
+                allow: [searchForWorkspaceRoot(process.cwd())],
+            },
+        },
+        assetsInclude: [
+            "src/*.webp",
+            "src/*.png",
+            "src/*.jpg",
+            "src/*.jpeg",
+            "src/*.svg",
+            "src/*.avif",
+        ],
+        build: {
+            cssCodeSplit: true,
+            cssMinify: "lightningcss",
+            rolldownOptions: {
+                output: {
+                    experimental: {
+                        nativeMagicString: true,
+                    },
+                },
+                treeshake: "smallest",
+                optimization: {
+                    inlineConst: "smart",
+                },
+                ssr: false,
+            },
+        },
+        css: {
+            lightningcss: {},
+        },
+    },
+    prefetch: {
+        defaultStrategy: "viewport",
+    },
+    experimental: {
+        chromeDevtoolsWorkspace: true,
+        clientPrerender: true,
+        contentIntellisense: true,
+        svgo: {
+            plugins: [
+                {
+                    name: "preset-default",
+                    params: {
+                        overrides: {
+                            removeMetadata: false,
+                        },
+                    },
+                },
+            ],
+        },
+        rustCompiler: true,
+    },
+    // Static site generation for Cloudflare
+    output: "static",
+    integrations: [
+        starlight({
+            title: `${appName} Docs`,
+            description: description,
+            logo: {
+                dark: headlineLogoDark,
+                light: headlineLogoLight,
+                alt: "knitli logo",
+                replacesTitle: true,
+            },
+            editLink: {
+                baseUrl: `https://github.com/knitli/${appName.toLowerCase()}/edit/main/docs-site/src`,
+            },
+            expressiveCode: {
+                useStarlightDarkModeSwitch: true,
+                themes: ["catppuccin-latte", "catppuccin-mocha"],
+                removeUnusedThemes: true,
+                shiki: {
+                    ...Object.fromEntries(Object.entries(shikiCfg).filter(([key]) => key !== "themes")),
+                },
+            },
+            plugins: [
+            /*
+            astroD2({ skipGeneration: true }),
+            starlightLinksValidator(),
+    
+            starlightScrollToTop(),
+            starlightChangelogs(),
+            starlightIconsPlugin(),
+            starlightPageActions({ baseUrl: `https://docs.knitli.com/${appName.toLowerCase()}` }),
+            starlightIconsIntegration(),
+            starlightIconsPlugin(),
+            starlightHeadingBadges(), starlightContextualMenu({
+            actions: ["copy", "view", "claude", "chatgpt"], share: true,
+          }),
+          // We need to configure starlight-tags with a tags.yml.
+          //starlightTags(),
+          starlightLlmsText({
+            projectName: appName,
+            description: `${appName} is a pure-Rust fork of the popular data processing and ETL framework, [CocoIndex](https://cocoindex.io). ${appName} features a highly modular architecture, with all sources, targets, and functions (i.e. transforms) implemented as feature-gated plugins. This allows users to easily customize and extend the framework to fit their specific data processing needs, while keeping the core lightweight and efficient.
+            Like CocoIndex, ${appName} is fast, efficient, and works on data incrementally. Both libraries are built using a *dataflow architecture*, allowing you to easily define complex data processing pipelines with multiple sources, targets, and transforms in only a few lines of code. CocoIndex is built in Rust, but its entire API is only in Python, and does not allow for choosing integrations. ${appName} exposes a robust Rust API that allows you to choose exactly which sources, targets, and transforms you want to use.
+            `,
+            promote: ["getting-started*", "architecture*", "file-processing*", "transient-flow*"],
+            demote: ["contributing*", "changelog*"],
+            minify: {
+              whitespace: true,
+              note: true,
+              details: true,
+            }
+          })
+            */
+            ],
+            social: [
+                {
+                    icon: "github",
+                    label: "GitHub",
+                    href: `https://github.com/knitli/${appName.toLowerCase()}`,
+                },
+            ],
+            components: {
+                Footer: "@knitli/docs-components/Footer.astro",
+                PageFrame: "@knitli/docs-components/PageFrame.astro",
+            },
+            customCss: [variables, docsStyle, "./src/styles/custom.css"],
+            head: [
+                {
+                    tag: "meta",
+                    attrs: {
+                        property: "og:image",
+                        content: `https://docs.knitli.com/${appName.toLowerCase()}/og-image.png`,
+                    },
+                },
+                {
+                    tag: "meta",
+                    attrs: {
+                        property: "twitter:card",
+                        content: "summary_large_image",
+                    },
+                },
+            ],
+            sidebar: [
+                {
+                    label: "Guides",
+                    autogenerate: { directory: "guides" },
+                },
+                {
+                    label: "Examples",
+                    autogenerate: { directory: "examples" },
+                },
+                {
+                    label: "Reference",
+                    autogenerate: { directory: "reference" },
+                },
+            ],
+        }),
+        /*
+        mdx(),
+        favicons({
+          name: `${appName} Docs by Knitli`,
+          short_name: `${appName} Docs`,
+          input: {
+            favicons: [faviconSvg],
+          },
+        }),
+        sitemap({
+          filter: (page) => !/\^\/(?!cdn-cgi\/)/.test(page),
+          changefreq: "weekly",
+          priority: 0.4,
+          lastmod: new Date(),
+          namespaces: {
+            image: false,
+            video: false,
+          },
+        }),
+    
+        */
+    ],
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knitli/docs-components",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "Shared branded components for Knitli documentation sites",
   "keywords": [
     "knitli",
@@ -40,7 +40,7 @@
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "bunx tsc && bun run scripts/copy-dist-assets.mjs",
+    "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)}\"",
@@ -52,15 +52,15 @@
     "@knitli/shared-layouts": "workspace:*",
     "@knitli/tsconfig": "*",
     "@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",
     "typescript": "catalog:dev-common",
-    "vitest": "catalog:dev-common",
-    "@types/react": "catalog:types",
-    "vite": "catalog:dev-common"
+    "vite": "catalog:dev-common",
+    "vitest": "catalog:dev-common"
   },
   "peerDependencies": {
     "@astrojs/starlight": "catalog:astro-core",

package/scripts/copy-dist-assets.mjs

@@ -9,7 +9,10 @@ const pkgRoot = resolve(__dirname, "..");
 
 const copies = [
   { src: `${pkgRoot}/src/assets/logos`, dest: `${pkgRoot}/dist/assets/logos` },
-  { src: `${pkgRoot}/src/assets/favicon`, dest: `${pkgRoot}/dist/assets/favicon` },
+  {
+    src: `${pkgRoot}/src/assets/favicon`,
+    dest: `${pkgRoot}/dist/assets/favicon`,
+  },
   {
     src: `${pkgRoot}/src/assets/styles`,
     dest: `${pkgRoot}/dist/assets/styles`,

package/src/assets/favicon/index.ts

@@ -15,4 +15,4 @@ export const faviconSvg = join(__dirname, "favicon.svg");
 export type FaviconAssets = {
   faviconIco: string;
   faviconSvg: string;
-};
+};

package/src/assets/logos/index.ts

@@ -20,8 +20,14 @@ export const recocoLogoLg = join(__dirname, "recoco-lg.webp");
 export const recocoLogoMed = join(__dirname, "recoco-med.webp");
 export const recocoLogoSm = join(__dirname, "recoco-sm.webp");
 export const recocoLogoXs = join(__dirname, "recoco-xs.webp");
-export const threadLogoDark = join(__dirname, "Thread_vector_mono_parchment.svg");
-export const threadLogoLight = join(__dirname, "Thread_vector_mono_aubergine.svg");
+export const threadLogoDark = join(
+  __dirname,
+  "Thread_vector_mono_parchment.svg",
+);
+export const threadLogoLight = join(
+  __dirname,
+  "Thread_vector_mono_aubergine.svg",
+);
 
 export type LogoAssets = {
   knitliLogo: string;

package/src/assets/styles/variables.css

@@ -89,8 +89,8 @@
   /* === FONT FAMILIES === */
   /* Knitli Brand Fonts - Warm, Editorial */
   --font-knitli-display:
-    "Playfair Display", Didot, "Palatino Linotype", "Noto Serif", "DejaVu Serif",
-    serif;
+    "Playfair Display", Didot, "Palatino Linotype", "Noto Serif",
+    "DejaVu Serif", serif;
   --font-knitli-body:
     "Crimson Pro", Baskerville, Cambria, "Palatino Linotype", "Noto Serif",
     "DejaVu Serif", serif;

package/src/components/Footer.astro

@@ -23,6 +23,12 @@ import { Icon } from "@astrojs/starlight/components";
 
 const currentYear = new Date().getFullYear();
 
+const product = (import.meta.env.PUBLIC_DOCS_PRODUCT ?? "") as
+  | "Recoco"
+  | "CodeWeaver"
+  | "Thread"
+  | "";
+
 const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
 ---
 
@@ -30,12 +36,11 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
   <!-- Starlight's native page-level footer: edit link, last updated, pagination, optional credits -->
   <div class="sl-flex page-actions">
     <div class="meta sl-flex">
-      <EditLink/>
-      <LastUpdated/>
+      <EditLink />
+      <LastUpdated />
     </div>
-    <Pagination/>
-    {
-		config.credits && (
+    <Pagination />
+    {config.credits && (
 			<a class="kudos sl-flex" href="https://starlight.astro.build">
 				
 				<Icon name="starlight" /> {
@@ -50,7 +55,7 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
     <div class="footer-content sl-flex">
       <div class="footer-brand">
         <p class="copyright">
-          © {currentYear} Knitli, Inc. All rights reserved.
+          © {currentYear}Knitli, Inc. All rights reserved.
         </p>
         <div class="social-links sl-flex">
           <a
@@ -60,7 +65,7 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
             target="_blank"
             rel="noopener noreferrer"
           >
-            <Icon name="github" size="1.1rem"/>
+            <Icon name="github" size="1.1rem" />
           </a>
           <a
             href="https://x.com/knitli_inc"
@@ -69,7 +74,7 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
             target="_blank"
             rel="noopener noreferrer"
           >
-            <Icon name="x.com" size="1.1rem"/>
+            <Icon name="x.com" size="1.1rem" />
           </a>
           <a
             href="https://bsky.app/profile/knitli.com"
@@ -78,7 +83,7 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
             target="_blank"
             rel="noopener noreferrer"
           >
-            <Icon name="blueSky" size="1.1rem"/>
+            <Icon name="blueSky" size="1.1rem" />
           </a>
           <a
             href="https://linkedin.com/company/knitli"
@@ -87,7 +92,7 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
             target="_blank"
             rel="noopener noreferrer"
           >
-            <Icon name="linkedin" size="1.1rem"/>
+            <Icon name="linkedin" size="1.1rem" />
           </a>
         </div>
       </div>
@@ -95,12 +100,8 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
       <nav class="footer-nav" aria-label="Knitli">
         <p class="nav-heading">Knitli</p>
         <ul>
-          <li>
-            <a href="https://knitli.com">knitli.com</a>
-          </li>
-          <li>
-            <a href="https://blog.knitli.com">Blog</a>
-          </li>
+          <li><a href="https://knitli.com">knitli.com</a></li>
+          <li><a href="https://blog.knitli.com">Blog</a></li>
         </ul>
       </nav>
 
@@ -109,22 +110,31 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
         <ul>
           {shouldShowDocsHomeLink && <li><a href="https://docs.knitli.com">Developer Docs</a></li>}
           <li>
-            <a href="https://docs.knitli.com/recoco/">Recoco</a>
+            {product === "Recoco" ? (
+              <span class="link-current">Recoco</span>
+            ) : (
+              <a href="https://docs.knitli.com/recoco/">Recoco</a>
+            )}
           </li>
           <li>
-            <span class="link-disabled">
-              CodeWeaver
-              <span class="soon-badge">soon</span>
-            </span>
+            {product === "CodeWeaver" ? (
+              <span class="link-current">CodeWeaver</span>
+            ) : (
+              <a href="https://docs.knitli.com/codeweaver/">CodeWeaver</a>
+            )}
           </li>
           <li>
-            <a
-              href="https://docs.rs/thread"
-              target="_blank"
-              rel="noopener noreferrer"
-            >
-              Thread ↗
-            </a>
+            {product === "Thread" ? (
+              <span class="link-current">Thread</span>
+            ) : (
+              <a
+                href="https://docs.rs/thread"
+                target="_blank"
+                rel="noopener noreferrer"
+              >
+                Thread ↗
+              </a>
+            )}
           </li>
         </ul>
       </nav>
@@ -253,23 +263,10 @@ const shouldShowDocsHomeLink = Astro.url.pathname !== "/";
     color: var(--sl-color-accent-high);
   }
 
-  .link-disabled {
+  .link-current {
     font-size: var(--sl-text-sm);
-    color: var(--sl-color-gray-4);
-    display: flex;
-    align-items: center;
-    gap: 0.4rem;
-  }
-
-  .soon-badge {
-    font-size: var(--sl-text-xs);
-    padding: 0.1em 0.4em;
-    border-radius: 3px;
-    background: var(--sl-color-accent-low);
-    color: var(--sl-color-accent-high);
-    font-weight: 600;
-    letter-spacing: 0.05em;
-    text-transform: uppercase;
+    color: var(--sl-color-white);
+    font-weight: 500;
   }
 }
 

package/src/components/PageFrame.astro

@@ -52,12 +52,9 @@ const currentPath = Astro.url.pathname
     </div>
   </nav>
 
-  <header class="header">
-    <slot name="header"/>
-  </header>
+  <header class="header"><slot name="header" /></header>
 
-  {
-    hasSidebar && (
+  {hasSidebar && (
       <nav class="sidebar print:hidden" aria-label={Astro.locals.t('sidebarNav.accessibleLabel')}>
         <MobileMenuToggle />
         <div id="starlight__sidebar" class="sidebar-pane">
@@ -66,12 +63,9 @@ const currentPath = Astro.url.pathname
           </div>
         </div>
       </nav>
-    )
-  }
+    )}
 
-  <div class="main-frame">
-    <slot/>
-  </div>
+  <div class="main-frame"><slot /></div>
 </div>
 
 <style>

package/src/index.ts

@@ -8,6 +8,7 @@
 // Export type definitions
 export * from "./types/index.js";
 
+import { faviconIco, faviconSvg } from "./assets/favicon/index.js";
 import {
   codeweaverPrimary,
   codeweaverReverse,
@@ -16,16 +17,14 @@ import {
   knitliLogo,
   knitliWordmark,
   recocoLogoLg,
-  recocoLogoXs,
   recocoLogoMed,
   recocoLogoSm,
   recocoLogoXl,
+  recocoLogoXs,
   threadLogoDark,
   threadLogoLight,
 } from "./assets/logos/index.js";
 
-import { faviconIco, faviconSvg } from "./assets/favicon/index.js";
-
 import { codeweaverTheme, variables } from "./assets/styles/index.js";
 
 import { docsStyle } from "./styles/index.js";

package/src/templates/AstroConfigTemplate.mjs

@@ -0,0 +1,324 @@
+// SPDX-FileCopyrightText: 2026 Knitli Inc.
+//
+// SPDX-License-Identifier: Apache-2.0
+
+// @ts-check
+
+// import cloudflare from "@astrojs/cloudflare";
+// import mdx from "@astrojs/mdx";
+// import sitemap from "@astrojs/sitemap";
+import starlight from "@astrojs/starlight";
+// import favicons from "astro-favicons";
+import { DocsAssets } from "@knitli/docs-components";
+import { defineConfig, fontProviders } from "astro/config";
+import { searchForWorkspaceRoot } from "vite";
+
+// import starlightHeadingBadges from "starlight-heading-badges";
+// import starlightContextualMenu from "starlight-contextual-menu";
+// import starlightTags from "starlight-tags";
+// import starlightLlmsText from "starlight-llms-txt";
+
+const {
+  headlineLogoDark,
+  headlineLogoLight,
+  variables,
+  docsStyle,
+  faviconIco,
+  faviconSvg,
+} = DocsAssets;
+
+const appName = "APP_NAME";
+const description = "DESCRIPTION";
+
+const shikiCfg = {
+  themes: ["catppuccin-latte", "catppuccin-mocha"],
+  bundledLangs: [
+    "ansi",
+    "rust",
+    "astro",
+    "yaml",
+    "bash",
+    "python",
+    "json",
+    "toml",
+    "typescript",
+    "markdown",
+  ],
+  langAlias: {
+    sh: "bash",
+    js: "typescript",
+    py: "python",
+    rs: "rust",
+    md: "markdown",
+    yml: "yaml",
+  },
+};
+
+// https://astro.build/config
+export default defineConfig({
+  site: "https://docs.knitli.com",
+  base: `/${appName.toLowerCase()}/`,
+  /*
+  adapter: cloudflare({
+    experimental: {
+      headersAndRedirectsDevModeSupport: true,
+    },
+    configPath: "./wrangler.jsonc",
+    imageService: "compile",
+  }),
+*/
+  favicon: faviconIco,
+  // Image optimization
+  image: {
+    service: {
+      entrypoint: "astro/assets/services/sharp",
+    },
+    responsiveStyles: true,
+    layout: "constrained",
+    domains: [
+      "github.com",
+      "raw.githubusercontent.com",
+      "docs.knitli.com",
+      "knitli.com",
+      "avatars.githubusercontent.com",
+      "ui-avatars.com",
+      `${appName.toLowerCase()}.knitli.com`,
+    ],
+  },
+  fonts: [
+    {
+      provider: fontProviders.google,
+      name: "DM Mono",
+      cssVariable: "--font-sans",
+      weights: [400, 500, 700],
+      styles: ["normal", "italic"],
+      subsets: ["latin"],
+      formats: ["woff2"],
+      fallbacks: [
+        "Roboto Mono",
+        "Menlo",
+        "Consolas",
+        "DejaVu Sans Mono",
+        "monospace",
+      ],
+    },
+    {
+      provider: fontProviders.google,
+      name: "JetBrains Mono",
+      cssVariable: "--font-mono",
+      weights: [400, 500, 700],
+      styles: ["normal", "italic"],
+      subsets: ["latin"],
+      formats: ["woff2"],
+      fallbacks: [
+        "DM Mono",
+        "Roboto Mono",
+        "Menlo",
+        "Consolas",
+        "DejaVu Sans Mono",
+        "monospace",
+      ],
+    },
+  ],
+  // Build optimizations
+  build: {
+    inlineStylesheets: "auto",
+    assets: "_astro",
+  },
+  markdown: {
+    shikiConfig: {
+      ...Object.fromEntries(
+        Object.entries(shikiCfg).map(([key, value]) =>
+          key === "themes"
+            ? [
+                key,
+                {
+                  light: "catppuccin-latte",
+                  dark: "catppuccin-mocha",
+                },
+              ]
+            : [key, value],
+        ),
+      ),
+    },
+  },
+  trailingSlash: "always",
+  // Vite configuration for better bundling
+  vite: {
+    server: {
+      fs: {
+        allow: [searchForWorkspaceRoot(process.cwd())],
+      },
+    },
+    assetsInclude: [
+      "src/*.webp",
+      "src/*.png",
+      "src/*.jpg",
+      "src/*.jpeg",
+      "src/*.svg",
+      "src/*.avif",
+    ],
+    build: {
+      cssCodeSplit: true,
+      cssMinify: "lightningcss",
+      rollupOptions: {
+        output: {
+          experimental: {
+            nativeMagicString: true,
+          },
+        },
+        treeshake: "smallest",
+        optimization: {
+          inlineConst: "smart",
+        },
+        ssr: false,
+      },
+    },
+    css: {
+      lightningcss: {},
+    },
+  },
+  prefetch: {
+    defaultStrategy: "viewport",
+  },
+  experimental: {
+    chromeDevtoolsWorkspace: true,
+    clientPrerender: true,
+    contentIntellisense: true,
+    svgo: {
+      plugins: [
+        {
+          name: "preset-default",
+          params: {
+            overrides: {
+              removeMetadata: false,
+            },
+          },
+        },
+      ],
+    },
+    rustCompiler: true,
+  },
+
+  // Static site generation for Cloudflare
+  output: "static",
+  integrations: [
+    starlight({
+      title: `${appName} Docs`,
+      description: description,
+      logo: {
+        dark: headlineLogoDark,
+        light: headlineLogoLight,
+        alt: "knitli logo",
+        replacesTitle: true,
+      },
+      editLink: {
+        baseUrl: `https://github.com/knitli/${appName.toLowerCase()}/edit/main/docs-site/src`,
+      },
+      expressiveCode: {
+        useStarlightDarkModeSwitch: true,
+        themes: ["catppuccin-latte", "catppuccin-mocha"],
+        removeUnusedThemes: true,
+        shiki: {
+          ...Object.fromEntries(
+            Object.entries(shikiCfg).filter(([key]) => key !== "themes"),
+          ),
+        },
+      },
+      plugins: [
+        /*     
+        astroD2({ skipGeneration: true }),
+        starlightLinksValidator(),
+
+        starlightScrollToTop(),
+        starlightChangelogs(),
+        starlightIconsPlugin(),
+        starlightPageActions({ baseUrl: `https://docs.knitli.com/${appName.toLowerCase()}` }),
+        starlightIconsIntegration(),
+        starlightIconsPlugin(),
+        starlightHeadingBadges(), starlightContextualMenu({
+        actions: ["copy", "view", "claude", "chatgpt"], share: true,
+      }),
+      // We need to configure starlight-tags with a tags.yml.
+      //starlightTags(), 
+      starlightLlmsText({
+        projectName: appName,
+        description: `${appName} is a pure-Rust fork of the popular data processing and ETL framework, [CocoIndex](https://cocoindex.io). ${appName} features a highly modular architecture, with all sources, targets, and functions (i.e. transforms) implemented as feature-gated plugins. This allows users to easily customize and extend the framework to fit their specific data processing needs, while keeping the core lightweight and efficient.
+        Like CocoIndex, ${appName} is fast, efficient, and works on data incrementally. Both libraries are built using a *dataflow architecture*, allowing you to easily define complex data processing pipelines with multiple sources, targets, and transforms in only a few lines of code. CocoIndex is built in Rust, but its entire API is only in Python, and does not allow for choosing integrations. ${appName} exposes a robust Rust API that allows you to choose exactly which sources, targets, and transforms you want to use.
+        `,
+        promote: ["getting-started*", "architecture*", "file-processing*", "transient-flow*"],
+        demote: ["contributing*", "changelog*"],
+        minify: {
+          whitespace: true,
+          note: true,
+          details: true,
+        }
+      })
+        */
+      ],
+      social: [
+        {
+          icon: "github",
+          label: "GitHub",
+          href: `https://github.com/knitli/${appName.toLowerCase()}`,
+        },
+      ],
+      components: {
+        Footer: "@knitli/docs-components/Footer.astro",
+        PageFrame: "@knitli/docs-components/PageFrame.astro",
+      },
+      customCss: [variables, docsStyle, "./src/styles/custom.css"],
+      head: [
+        {
+          tag: "meta",
+          attrs: {
+            property: "og:image",
+            content: `https://docs.knitli.com/${appName.toLowerCase()}/og-image.png`,
+          },
+        },
+        {
+          tag: "meta",
+          attrs: {
+            property: "twitter:card",
+            content: "summary_large_image",
+          },
+        },
+      ],
+      sidebar: [
+        {
+          label: "Guides",
+          autogenerate: { directory: "guides" },
+        },
+        {
+          label: "Examples",
+          autogenerate: { directory: "examples" },
+        },
+        {
+          label: "Reference",
+          autogenerate: { directory: "reference" },
+        },
+      ],
+    }),
+    /*  
+    mdx(),
+    favicons({
+      name: `${appName} Docs by Knitli`,
+      short_name: `${appName} Docs`,
+      input: {
+        favicons: [faviconSvg],
+      },
+    }),
+    sitemap({
+      filter: (page) => !/\^\/(?!cdn-cgi\/)/.test(page),
+      changefreq: "weekly",
+      priority: 0.4,
+      lastmod: new Date(),
+      namespaces: {
+        image: false,
+        video: false,
+      },
+    }),
+
+    */
+  ],
+});

package/CHANGELOG.md

@@ -1,67 +0,0 @@
-### Changelog
-
-All notable changes to this project will be documented in this file. Dates are displayed in UTC.
-
-Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
-
-#### 1.1.10
-
-- fix: URL in footer
-
-#### 1.1.9
-
-- feat: Replace recoco logo images with new, sharper version.
-
-#### 1.1.8
-
-- fix: build asset propagation issue
-
-#### 1.1.7
-
-- fix: Another path resolution issue
-
-#### 1.1.6
-
-- fix: typo in Footer component
-
-#### 1.1.5
-
-- fix: path resolution issue on imported assets
-
-#### 1.1.4
-
-- fix: minor discovery issue
-
-#### 1.1.3
-
-- chore: Updated Recoco references to use consistent casing.
-- feat: Bundled knitli shared assets.
-- feat: Add custom.css.
-
-#### 1.1.2
-
-- fix: Move dependencies to dev dependencies to avoid npm install issues
-
-#### 1.1.1
-
-> 2026-02-19
-
-- feat: Add `PageFrame.astro` — Starlight `PageFrame` override with fixed cross-site subnav bar (breadcrumb left, Knitli Home + Blog links right)
-- feat: Add `Footer.astro` — Starlight `Footer` override that preserves native page-level footer (edit link, last updated, pagination, credits) and appends Knitli brand footer below
-- feat: Update `DocsBreadcrumb.astro` — migrate styles to Starlight CSS variables, add `inline` variant for embedding in subnav bars, fix segment href generation, update Documentation link to point to `https://docs.knitli.com`
-- feat: `PageFrame` reads `PUBLIC_DOCS_PRODUCT` env var to conditionally render breadcrumb; derives content path from `BASE_URL` for correct segment stripping across sub-path and standalone deployments
-- feat: `PageFrame` uses `var(--sl-subnav-height, 2rem)` CSS fallback — no manual variable definition required in consuming sites
-- fix: Subnav links correctly right-aligned when no breadcrumb is present (`margin-inline-start: auto`)
-- chore: Remove `DocsHeader.astro` and `DocsFooter.astro` (replaced by `PageFrame.astro` and `Footer.astro`); stubs remain with hard errors to guide migration
-- chore: Update `package.json` exports — add `PageFrame.astro`, `Footer.astro`; remove `DocsHeader.astro`, `DocsFooter.astro`; add `@astrojs/starlight >=0.30.0` peer dependency
-
-#### 1.1.0
-
-> 2026-02-19
-
-- chore: Bump version
-
-#### 1.0.4
-
-- chore: Updated licensing and README to clarify difference between Knitli brand assets (proprietary) and the rest of the project (MIT OR Apache-2.0).
-- chore: Updated configuration and tsconfig