@knitli/astro-docs-template 0.1.1 → 0.1.2

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env bun
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/{src/cli.ts → dist/cli.js}

@@ -1,43 +1,25 @@
 #!/usr/bin/env bun
-// SPDX-FileCopyrightText: 2026 Knitli Inc.
-//
-// SPDX-License-Identifier: Apache-2.0
-
-import { createInterface } from "node:readline/promises";
-import { stdin, stdout } from "node:process";
-import {
-  addPieces,
-  initDocsTemplate,
-  PIECES,
-  PIECE_NAMES,
-  type InitOptions,
-  type PieceName,
-} from "./index.js";
-
-// ── Arg parsing ──
-
-function parseArgs(argv: string[]) {
-  const flags: Record<string, string> = {};
-  const positional: string[] = [];
+import { stdout, stdin } from 'node:process';
+import { createInterface } from 'node:readline/promises';
+import { PIECES, PIECE_NAMES, addPieces, initDocsTemplate } from './index.js';
 
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
   for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i]!;
+    const arg = argv[i];
     if (arg === "--help" || arg === "-h") {
       flags.help = "true";
     } else if (arg === "--force" || arg === "-f") {
       flags.force = "true";
     } else if (arg.startsWith("--") && i + 1 < argv.length) {
-      flags[arg.slice(2)] = argv[++i]!;
+      flags[arg.slice(2)] = argv[++i];
     } else {
       positional.push(arg);
     }
   }
-
   return { flags, positional };
 }
-
-// ── Help text ──
-
 const HELP = `knitli-docs — scaffold and manage Knitli docs sites
 
 Usage:
@@ -46,9 +28,7 @@ Usage:
   knitli-docs list                        Show available pieces
 
 Pieces:
-${Object.entries(PIECES)
-  .map(([name, { description }]) => `  ${name.padEnd(18)} ${description}`)
-  .join("\n")}
+${Object.entries(PIECES).map(([name, { description }]) => `  ${name.padEnd(18)} ${description}`).join("\n")}
 
 Options:
   --app-name <name>       Product name (e.g. "Recoco")
@@ -59,60 +39,37 @@ Options:
   --force, -f             Overwrite existing files
   --help, -h              Show this help
 `;
-
-// ── Interactive prompts ──
-
-async function getOptions(
-  flags: Record<string, string>,
-): Promise<InitOptions> {
+async function getOptions(flags) {
   const rl = createInterface({ input: stdin, output: stdout });
-
-  const ask = async (
-    question: string,
-    defaultValue?: string,
-  ): Promise<string> => {
+  const ask = async (question, defaultValue) => {
     const suffix = defaultValue ? ` [${defaultValue}]` : "";
     const answer = await rl.question(`${question}${suffix}: `);
     return answer.trim() || defaultValue || "";
   };
-
   try {
-    const appName =
-      flags["app-name"] || (await ask("Product name (e.g. Recoco)"));
+    const appName = flags["app-name"] || await ask("Product name (e.g. Recoco)");
     if (!appName) {
       console.error("Error: product name is required");
       process.exit(1);
     }
-
-    const name =
-      flags.name ||
-      (await ask(
-        "npm package name",
-        `@knitli-site/${appName.toLowerCase()}-docs`,
-      ));
-    const description =
-      flags.description || (await ask("Short description"));
-    const workerName =
-      flags["worker-name"] ||
-      (await ask("Worker name", `${appName.toLowerCase()}-docs`));
-
+    const name = flags.name || await ask(
+      "npm package name",
+      `@knitli-site/${appName.toLowerCase()}-docs`
+    );
+    const description = flags.description || await ask("Short description");
+    const workerName = flags["worker-name"] || await ask("Worker name", `${appName.toLowerCase()}-docs`);
     return { appName, name, description, workerName };
   } finally {
     rl.close();
   }
 }
-
-// ── Commands ──
-
 async function main() {
   const { flags, positional } = parseArgs(process.argv.slice(2));
   const command = positional[0];
-
   if (flags.help || !command) {
     console.log(HELP);
     process.exit(0);
   }
-
   switch (command) {
     case "list": {
       console.log("\nAvailable pieces:\n");
@@ -125,54 +82,55 @@ async function main() {
       console.log();
       break;
     }
-
     case "init": {
       const dir = flags.dir || positional[1] || ".";
       const options = await getOptions(flags);
-      console.log(`\nScaffolding into ${dir} ...\n`);
+      console.log(`
+Scaffolding into ${dir} ...
+`);
       const created = initDocsTemplate(dir, options);
-      console.log(`\nDone — ${created.length} files created`);
+      console.log(`
+Done — ${created.length} files created`);
       break;
     }
-
     case "add": {
       const pieces = positional.slice(1).filter((p) => !p.startsWith("-"));
       if (pieces.length === 0) {
         console.error(
-          "Error: specify at least one piece. Run 'knitli-docs list' to see options.",
+          "Error: specify at least one piece. Run 'knitli-docs list' to see options."
         );
         process.exit(1);
       }
-
       const invalid = pieces.filter(
-        (p) => !PIECE_NAMES.includes(p as PieceName),
+        (p) => !PIECE_NAMES.includes(p)
       );
       if (invalid.length > 0) {
         console.error(`Error: unknown piece(s): ${invalid.join(", ")}`);
         console.error(`Available: ${PIECE_NAMES.join(", ")}`);
         process.exit(1);
       }
-
       const dir = flags.dir || ".";
       const options = await getOptions(flags);
-      console.log(`\nAdding ${pieces.join(", ")} to ${dir} ...\n`);
+      console.log(`
+Adding ${pieces.join(", ")} to ${dir} ...
+`);
       const created = addPieces(dir, {
         ...options,
-        pieces: pieces as PieceName[],
-        force: flags.force === "true",
+        pieces,
+        force: flags.force === "true"
       });
-      console.log(`\nDone — ${created.length} files created`);
+      console.log(`
+Done — ${created.length} files created`);
       break;
     }
-
     default: {
-      console.error(`Unknown command: ${command}\n`);
+      console.error(`Unknown command: ${command}
+`);
       console.log(HELP);
       process.exit(1);
     }
   }
 }
-
 main().catch((err) => {
   console.error(err.message);
   process.exit(1);

package/dist/config.d.ts

@@ -0,0 +1,59 @@
+import type { OutgoingHttpHeaders } from "node:http2";
+type defaultIntegration = "sitemap" | "astroD2" | "markdoc" | "mdx" | "favicons" | "cloudflare-pages-headers";
+export declare const headlineLogoDark: string, headlineLogoLight: string, variables: string, docsStyle: string, faviconIco: string, faviconSvg: string;
+declare const shikiCfg: {
+    themes: {
+        light: "catppuccin-latte";
+        dark: "catppuccin-mocha";
+    };
+    bundledLangs: string[];
+    langAlias: {
+        js: string;
+        md: string;
+        py: string;
+        rs: string;
+        sh: string;
+        yml: string;
+    };
+};
+declare const imgDomains: {
+    protocol: string;
+    hostname: string;
+}[];
+export interface DocsTemplateOptions {
+    appName: string;
+    description: string;
+    llmConfig: {
+        llmDescription: string;
+        promotePatterns: string[];
+        demotePatterns: string[];
+    };
+    rootDir: string;
+    shikiConfig?: typeof shikiCfg;
+    logoDark?: string;
+    logoLight?: string;
+    imageDomains?: typeof imgDomains;
+    is_codeweaver?: boolean;
+    sitemapFilter?: (page: string) => boolean;
+    linkValidationConfig?: Record<string, unknown>;
+    sidebarConfig?: {
+        label: string;
+        autogenerate: {
+            directory: string;
+        };
+    }[];
+    unwantedPlugins?: string[];
+    pluginConfigs?: Record<string, any>;
+    unwantedIntegrations?: defaultIntegration[];
+    integrationConfigs?: Record<string, any>;
+    headersConfig?: OutgoingHttpHeaders;
+}
+export type IntegrationOptions = Pick<DocsTemplateOptions, "appName" | "sitemapFilter" | "integrationConfigs"> & {
+    unwantedIntegrations?: defaultIntegration[];
+};
+export type PluginOptions = Pick<DocsTemplateOptions, "appName" | "llmConfig" | "pluginConfigs"> & {
+    unwantedPlugins?: string[];
+};
+export default function createConfig(options: DocsTemplateOptions): import("astro").AstroUserConfig<never, never, never>;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA6BtD,KAAK,kBAAkB,GACnB,SAAS,GACT,SAAS,GACT,SAAS,GACT,KAAK,GACL,UAAU,GACV,0BAA0B,CAAC;AAQ/B,eAAO,MACL,gBAAgB,UAChB,iBAAiB,UACjB,SAAS,UACT,SAAS,UACT,UAAU,UACV,UAAU,QACE,CAAC;AAEf,QAAA,MAAM,QAAQ;;;;;;;;;;;;;;CAyBb,CAAC;AAEF,QAAA,MAAM,UAAU;;;GAMf,CAAC;AA8DF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,EAAE,CAAC;QAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,QAAQ,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;IACjC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/C,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,YAAY,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;KACrC,EAAE,CAAC;IACJ,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAE5C,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,mBAAmB,CAAC;CACrC;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,mBAAmB,EACnB,SAAS,GAAG,eAAe,GAAG,oBAAoB,CACnD,GAAG;IAAE,oBAAoB,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC;AA+DpD,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,mBAAmB,EACnB,SAAS,GAAG,WAAW,GAAG,eAAe,CAC1C,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAoEnC,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,OAAO,EAAE,mBAAmB,wDAuOhE"}

package/{src/config.ts → dist/config.js}

@@ -1,65 +1,43 @@
-// SPDX-FileCopyrightText: 2026 Knitli Inc.
-//
-// SPDX-License-Identifier: Apache-2.0
+import cloudflare from '@astrojs/cloudflare';
+import markdoc from '@astrojs/markdoc';
+import mdx from '@astrojs/mdx';
+import sitemap from '@astrojs/sitemap';
+import starlight from '@astrojs/starlight';
+import { DocsAssets } from '@knitli/docs-components';
+import llmEnhancements from '@nuasite/llm-enhancements';
+import { fontProviders, defineConfig } from 'astro/config';
+import cloudflarePagesHeaders from 'astro-cloudflare-pages-headers';
+import astroD2 from 'astro-d2';
+import favicons from 'astro-favicons';
+import rehypeExternalLinks from 'rehype-external-links';
+import starlightAnnouncement from 'starlight-announcement';
+import starlightChangelogs from 'starlight-changelogs';
+import starlightHeadingBadges from 'starlight-heading-badges';
+import starlightLinksValidator from 'starlight-links-validator';
+import starlightLlmsText from 'starlight-llms-txt';
+import starlightPageActions from 'starlight-page-actions';
+import { starlightIconsIntegration, starlightIconsPlugin } from 'starlight-plugin-icons';
+import starlightScrollToTop from 'starlight-scroll-to-top';
+import starlightSidebarTopics from 'starlight-sidebar-topics';
+import starlightTags from 'starlight-tags';
+import { searchForWorkspaceRoot } from 'vite';
+import viteTsconfigPaths from 'vite-tsconfig-paths';
 
-// @ts-check
-
-import type { OutgoingHttpHeaders } from "node:http2";
-import cloudflare from "@astrojs/cloudflare";
-import markdoc from "@astrojs/markdoc";
-import mdx from "@astrojs/mdx";
-import sitemap from "@astrojs/sitemap";
-import starlight from "@astrojs/starlight";
-import { DocsAssets } from "@knitli/docs-components";
-import llmEnhancements from "@nuasite/llm-enhancements";
-import { defineConfig, fontProviders } from "astro/config";
-import cloudflarePagesHeaders from "astro-cloudflare-pages-headers";
-import astroD2 from "astro-d2";
-import favicons from "astro-favicons";
-import rehypeExternalLinks from "rehype-external-links";
-import starlightAnnouncement from "starlight-announcement";
-import starlightChangelogs from "starlight-changelogs";
-import starlightHeadingBadges from "starlight-heading-badges";
-import starlightLinksValidator from "starlight-links-validator";
-import starlightLlmsText from "starlight-llms-txt";
-import starlightPageActions from "starlight-page-actions";
-import {
-  starlightIconsIntegration,
-  starlightIconsPlugin,
-} from "starlight-plugin-icons";
-import starlightScrollToTop from "starlight-scroll-to-top";
-import starlightSidebarTopics from "starlight-sidebar-topics";
-import starlightTags from "starlight-tags";
-import { searchForWorkspaceRoot } from "vite";
-import viteTsconfigPaths from "vite-tsconfig-paths";
-
-type defaultIntegration =
-  | "sitemap"
-  | "astroD2"
-  | "markdoc"
-  | "mdx"
-  | "favicons"
-  | "cloudflare-pages-headers";
-
-function nonNullable<T>(value: T): value is NonNullable<T> {
+function nonNullable(value) {
   return value != null;
 }
-
-// ── Defaults (defined before interface so `typeof` references work) ──
-
-export const {
+const {
   headlineLogoDark,
   headlineLogoLight,
   variables,
   docsStyle,
   faviconIco,
-  faviconSvg,
+  faviconSvg
 } = DocsAssets;
-
 const shikiCfg = {
   themes: {
-    light: "catppuccin-latte" as const,
-    dark: "catppuccin-mocha" as const,
+    light: "catppuccin-latte",
+    dark: "catppuccin-mocha"
   },
   bundledLangs: [
     "ansi",
@@ -71,7 +49,7 @@ const shikiCfg = {
     "rust",
     "toml",
     "typescript",
-    "yaml",
+    "yaml"
   ],
   langAlias: {
     js: "typescript",
@@ -79,64 +57,61 @@ const shikiCfg = {
     py: "python",
     rs: "rust",
     sh: "bash",
-    yml: "yaml",
-  },
+    yml: "yaml"
+  }
 };
-
 const imgDomains = [
   { protocol: "https", hostname: "ui-avatars.com" },
   { protocol: "https", hostname: "knitli.com" },
   { protocol: "https", hostname: "*.knitli.com" },
   { protocol: "https", hostname: "*.githubusercontent.com" },
-  { protocol: "https", hostname: "*.cloudflare.com" },
+  { protocol: "https", hostname: "*.cloudflare.com" }
 ];
-
 const defaultFontConfig = [
   {
     provider: fontProviders.google(),
     name: "DM Mono",
     cssVariable: "--font-sans",
-    weights: [400, 500, 700] as [number, ...number[]],
-    styles: ["normal", "italic"] as [string, ...string[]],
-    subsets: ["latin"] as [string, ...string[]],
-    formats: ["woff2"] as [string, ...string[]],
+    weights: [400, 500, 700],
+    styles: ["normal", "italic"],
+    subsets: ["latin"],
+    formats: ["woff2"],
     fallbacks: [
       "Roboto Mono",
       "Menlo",
       "Consolas",
       "DejaVu Sans Mono",
-      "monospace",
-    ],
+      "monospace"
+    ]
   },
   {
     provider: fontProviders.google(),
     name: "JetBrains Mono",
     cssVariable: "--font-mono",
-    weights: [400, 500, 700] as [number, ...number[]],
-    styles: ["normal", "italic"] as [string, ...string[]],
-    subsets: ["latin"] as [string, ...string[]],
-    formats: ["woff2"] as [string, ...string[]],
+    weights: [400, 500, 700],
+    styles: ["normal", "italic"],
+    subsets: ["latin"],
+    formats: ["woff2"],
     fallbacks: [
       "DM Mono",
       "Roboto Mono",
       "Menlo",
       "Consolas",
       "DejaVu Sans Mono",
-      "monospace",
-    ],
-  },
+      "monospace"
+    ]
+  }
 ];
-
 const codeweaverFontConfig = [
   { ...defaultFontConfig[1], cssVariable: "--font-sans" },
   {
     provider: fontProviders.google(),
     name: "IBM Plex Mono",
     cssVariable: "--font-mono",
-    weights: [400, 500, 700] as [number, ...number[]],
-    styles: ["normal", "italic"] as [string, ...string[]],
-    subsets: ["latin"] as [string, ...string[]],
-    formats: ["woff2"] as [string, ...string[]],
+    weights: [400, 500, 700],
+    styles: ["normal", "italic"],
+    subsets: ["latin"],
+    formats: ["woff2"],
     fallbacks: [
       "JetBrains Mono",
       "DM Mono",
@@ -144,53 +119,16 @@ const codeweaverFontConfig = [
       "Menlo",
       "Consolas",
       "DejaVu Sans Mono",
-      "monospace",
-    ],
-  },
+      "monospace"
+    ]
+  }
 ];
-
-// ── Public interface ──
-
-export interface DocsTemplateOptions {
-  appName: string;
-  description: string;
-  llmConfig: {
-    llmDescription: string;
-    promotePatterns: string[];
-    demotePatterns: string[];
-  };
-  rootDir: string;
-  shikiConfig?: typeof shikiCfg;
-  logoDark?: string;
-  logoLight?: string;
-  imageDomains?: typeof imgDomains;
-  is_codeweaver?: boolean;
-  sitemapFilter?: (page: string) => boolean;
-  linkValidationConfig?: Record<string, unknown>;
-  sidebarConfig?: {
-    label: string;
-    autogenerate: { directory: string };
-  }[];
-  unwantedPlugins?: string[];
-  // biome-ignore lint/suspicious/noExplicitAny: plugin configs are opaque pass-throughs
-  pluginConfigs?: Record<string, any>;
-  unwantedIntegrations?: defaultIntegration[];
-  // biome-ignore lint/suspicious/noExplicitAny: integration configs are opaque pass-throughs
-  integrationConfigs?: Record<string, any>;
-  headersConfig?: OutgoingHttpHeaders;
-}
-
-export type IntegrationOptions = Pick<
-  DocsTemplateOptions,
-  "appName" | "sitemapFilter" | "integrationConfigs"
-> & { unwantedIntegrations?: defaultIntegration[] };
-
-const getIntegrations = (options: IntegrationOptions) => {
+const getIntegrations = (options) => {
   const {
     appName,
     sitemapFilter,
     integrationConfigs,
-    unwantedIntegrations = [],
+    unwantedIntegrations = []
   } = options;
   const defaultIntegrations = [
     astroD2({ skipGeneration: true }),
@@ -201,57 +139,45 @@ const getIntegrations = (options: IntegrationOptions) => {
       name: `${appName} Docs by Knitli`,
       short_name: `${appName} Docs`,
       input: {
-        favicons: [faviconSvg],
-      },
+        favicons: [faviconSvg]
+      }
     }),
     cloudflarePagesHeaders({}),
     sitemap({
       filter: sitemapFilter || ((page) => !/\^\/(?!cdn-cgi\/)/.test(page)),
       changefreq: "weekly",
       priority: 0.4,
-      lastmod: new Date(),
+      lastmod: /* @__PURE__ */ new Date(),
       namespaces: {
         image: false,
-        video: false,
-      },
-    }),
+        video: false
+      }
+    })
   ];
-
   const filtered = defaultIntegrations.filter((integration) => {
     const name = integration?.name;
-    return !name || !unwantedIntegrations.includes(name as defaultIntegration);
+    return !name || !unwantedIntegrations.includes(name);
   });
-
   if (!integrationConfigs) return filtered;
-
-  const overrides = Object.entries(integrationConfigs)
-    .map(([integrationName, config]) => {
-      switch (integrationName) {
-        case "astroD2":
-          return astroD2(config);
-        case "markdoc":
-          return markdoc(config);
-        case "mdx":
-          return mdx(config);
-        case "favicons":
-          return favicons(config);
-        case "sitemap":
-          return sitemap(config);
-        default:
-          return null;
-      }
-    })
-    .filter(nonNullable);
-
+  const overrides = Object.entries(integrationConfigs).map(([integrationName, config]) => {
+    switch (integrationName) {
+      case "astroD2":
+        return astroD2(config);
+      case "markdoc":
+        return markdoc(config);
+      case "mdx":
+        return mdx(config);
+      case "favicons":
+        return favicons(config);
+      case "sitemap":
+        return sitemap(config);
+      default:
+        return null;
+    }
+  }).filter(nonNullable);
   return [...filtered, ...overrides];
 };
-
-export type PluginOptions = Pick<
-  DocsTemplateOptions,
-  "appName" | "llmConfig" | "pluginConfigs"
-> & { unwantedPlugins?: string[] };
-
-const get_plugins = (options: PluginOptions) => {
+const get_plugins = (options) => {
   const { appName, llmConfig, pluginConfigs, unwantedPlugins = [] } = options;
   const defaultPlugins = [
     starlightAnnouncement(),
@@ -263,12 +189,10 @@ const get_plugins = (options: PluginOptions) => {
     starlightPageActions({
       baseUrl: `https://docs.knitli.com/${appName.toLowerCase()}`,
       actions: { claude: true, chatgpt: true, markdown: true },
-      share: true,
+      share: true
     }),
     starlightTags({ onInlineTagsNotFound: "warn" }),
-    pluginConfigs?.starlightSidebarTopics
-      ? starlightSidebarTopics(pluginConfigs.starlightSidebarTopics)
-      : null,
+    pluginConfigs?.starlightSidebarTopics ? starlightSidebarTopics(pluginConfigs.starlightSidebarTopics) : null,
     starlightScrollToTop({ showOnHomepage: false }),
     // We need to configure starlight-tags with a tags.yml.
     //starlightTags(),
@@ -280,44 +204,35 @@ const get_plugins = (options: PluginOptions) => {
       minify: {
         whitespace: true,
         note: true,
-        details: true,
-      },
-    }),
-  ];
-
-  const filtered = defaultPlugins
-    .filter(nonNullable)
-    .filter((plugin) => !unwantedPlugins.includes(plugin.name));
-
-  if (!pluginConfigs) return filtered;
-
-  const overrides = Object.entries(pluginConfigs)
-    .map(([pluginName, config]) => {
-      switch (pluginName) {
-        case "starlightAnnouncement":
-          return starlightAnnouncement(config);
-        case "starlightIconsIntegration":
-          return starlightIconsIntegration(config);
-        case "starlightIconsPlugin":
-          return starlightIconsPlugin(config);
-        case "starlightLinksValidator":
-          return starlightLinksValidator(config);
-        case "starlightPageActions":
-          return starlightPageActions(config);
-        case "starlightTags":
-          return starlightTags(config);
-        case "starlightScrollToTop":
-          return starlightScrollToTop(config);
-        default:
-          return null;
+        details: true
       }
     })
-    .filter(nonNullable);
-
+  ];
+  const filtered = defaultPlugins.filter(nonNullable).filter((plugin) => !unwantedPlugins.includes(plugin.name));
+  if (!pluginConfigs) return filtered;
+  const overrides = Object.entries(pluginConfigs).map(([pluginName, config]) => {
+    switch (pluginName) {
+      case "starlightAnnouncement":
+        return starlightAnnouncement(config);
+      case "starlightIconsIntegration":
+        return starlightIconsIntegration(config);
+      case "starlightIconsPlugin":
+        return starlightIconsPlugin(config);
+      case "starlightLinksValidator":
+        return starlightLinksValidator(config);
+      case "starlightPageActions":
+        return starlightPageActions(config);
+      case "starlightTags":
+        return starlightTags(config);
+      case "starlightScrollToTop":
+        return starlightScrollToTop(config);
+      default:
+        return null;
+    }
+  }).filter(nonNullable);
   return [...filtered, ...overrides];
 };
-
-export default function createConfig(options: DocsTemplateOptions) {
+function createConfig(options) {
   const {
     appName,
     description,
@@ -334,59 +249,57 @@ export default function createConfig(options: DocsTemplateOptions) {
     integrationConfigs,
     unwantedIntegrations,
     unwantedPlugins,
-    headersConfig,
+    headersConfig
   } = options;
-
-  // https://astro.build/config
   return defineConfig({
     site: "https://docs.knitli.com",
     base: `/${appName.toLowerCase()}/`,
     adapter: cloudflare({
       prerenderEnvironment: "workerd",
       experimental: {
-        headersAndRedirectsDevModeSupport: true,
+        headersAndRedirectsDevModeSupport: true
       },
       configPath: `${rootDir}/wrangler.jsonc`,
-      imageService: "compile",
+      imageService: "compile"
     }),
     // Image optimization
     image: {
       service: {
-        entrypoint: "astro/assets/services/sharp",
+        entrypoint: "astro/assets/services/sharp"
       },
       responsiveStyles: true,
       layout: "constrained",
-      remotePatterns: imageDomains,
+      remotePatterns: imageDomains
     },
     compressHTML: true,
     // biome-ignore lint/suspicious/noExplicitAny: Astro's FontFamily generic inference doesn't match spread patterns
-    fonts: (is_codeweaver ? codeweaverFontConfig : defaultFontConfig) as any,
+    fonts: is_codeweaver ? codeweaverFontConfig : defaultFontConfig,
     // Build optimizations
     build: {
       inlineStylesheets: "auto",
-      assets: "_astro",
+      assets: "_astro"
     },
     markdown: {
       shikiConfig: Object.fromEntries(
-        Object.entries(shikiConfig).filter(([key]) => key !== "bundledLangs"),
+        Object.entries(shikiConfig).filter(([key]) => key !== "bundledLangs")
       ),
       rehypePlugins: [
         rehypeExternalLinks({
           content: { type: "text", value: " ↗" },
-          rel: ["nofollow"],
-        }),
-      ],
+          rel: ["nofollow"]
+        })
+      ]
     },
     server: {
-      headers: headersConfig,
+      headers: headersConfig
     },
     trailingSlash: "always",
     // Vite configuration for better bundling
     vite: {
       server: {
         fs: {
-          allow: [searchForWorkspaceRoot(rootDir)],
-        },
+          allow: [searchForWorkspaceRoot(rootDir)]
+        }
       },
       assetsInclude: [
         "src/*.webp",
@@ -394,11 +307,11 @@ export default function createConfig(options: DocsTemplateOptions) {
         "src/*.jpg",
         "src/*.jpeg",
         "src/*.svg",
-        "src/*.avif",
+        "src/*.avif"
       ],
       plugins: [viteTsconfigPaths({ loose: true })],
       define: {
-        "import.meta.env.PUBLIC_DOCS_PRODUCT": JSON.stringify(appName),
+        "import.meta.env.PUBLIC_DOCS_PRODUCT": JSON.stringify(appName)
       },
       build: {
         cssMinify: "lightningcss",
@@ -411,7 +324,7 @@ export default function createConfig(options: DocsTemplateOptions) {
             dir: `${rootDir}/dist/_astro/`,
             compact: true,
             interop: "esModule",
-            experimentalMinChunkSize: 10000,
+            experimentalMinChunkSize: 1e4,
             banner: `
           /* SPDX-FileCopyrightText: 2026 Knitli Inc.
           * SPDX-License-Identifier: MIT OR Apache-2.0
@@ -423,22 +336,22 @@ export default function createConfig(options: DocsTemplateOptions) {
               arrowFunctions: true,
               constBindings: true,
               objectShorthand: true,
-              symbols: true,
+              symbols: true
             },
             entryFileNames: "assets/[name]-[hash].js",
             chunkFileNames: "assets/[name]-[hash].js",
-            assetFileNames: "assets/[name]-[hash][extname]",
+            assetFileNames: "assets/[name]-[hash][extname]"
           },
-          treeshake: "smallest",
+          treeshake: "smallest"
         },
-        ssr: false,
+        ssr: false
       },
       css: {
-        lightningcss: {},
-      },
+        lightningcss: {}
+      }
     },
     prefetch: {
-      defaultStrategy: "viewport",
+      defaultStrategy: "viewport"
     },
     prerenderConflictBehavior: "warn",
     experimental: {
@@ -447,7 +360,7 @@ export default function createConfig(options: DocsTemplateOptions) {
       contentIntellisense: true,
       queuedRendering: {
         contentCache: true,
-        enabled: true,
+        enabled: true
       },
       rustCompiler: true,
       svgo: {
@@ -456,14 +369,13 @@ export default function createConfig(options: DocsTemplateOptions) {
             name: "preset-default",
             params: {
               overrides: {
-                removeMetadata: false,
-              },
-            },
-          },
-        ],
-      },
+                removeMetadata: false
+              }
+            }
+          }
+        ]
+      }
     },
-
     // Static site generation for Cloudflare
     output: "static",
     integrations: [
@@ -471,20 +383,20 @@ export default function createConfig(options: DocsTemplateOptions) {
         appName,
         sitemapFilter,
         integrationConfigs,
-        unwantedIntegrations,
+        unwantedIntegrations
       }),
       starlight({
         title: `${appName} Docs`,
         pagefind: true,
-        description: description,
+        description,
         logo: {
           dark: logoDark,
           light: logoLight,
           alt: is_codeweaver ? "CodeWeaver Logo" : "Knitli Logo",
-          replacesTitle: true,
+          replacesTitle: true
         },
         editLink: {
-          baseUrl: `https://github.com/knitli/${appName.toLowerCase()}/edit/main/docs-site/src`,
+          baseUrl: `https://github.com/knitli/${appName.toLowerCase()}/edit/main/docs-site/src`
         },
         expressiveCode: {
           useStarlightDarkModeSwitch: true,
@@ -492,27 +404,27 @@ export default function createConfig(options: DocsTemplateOptions) {
           removeUnusedThemes: true,
           shiki: {
             ...Object.fromEntries(
-              Object.entries(shikiConfig).filter(([key]) => key !== "themes"),
-            ),
-          },
+              Object.entries(shikiConfig).filter(([key]) => key !== "themes")
+            )
+          }
         },
         plugins: get_plugins({
           appName,
           llmConfig,
           pluginConfigs,
-          unwantedPlugins,
+          unwantedPlugins
           // biome-ignore lint/suspicious/noExplicitAny: Starlight plugin types are complex Zod inferences
-        }) as any[],
+        }),
         social: [
           {
             icon: "github",
             label: "GitHub",
-            href: `https://github.com/knitli/${appName.toLowerCase()}`,
-          },
+            href: `https://github.com/knitli/${appName.toLowerCase()}`
+          }
         ],
         components: {
           Footer: "@knitli/docs-components/Footer.astro",
-          PageFrame: "@knitli/docs-components/PageFrame.astro",
+          PageFrame: "@knitli/docs-components/PageFrame.astro"
         },
         customCss: [variables, docsStyle, `${rootDir}/src/styles/custom.css`],
         head: [
@@ -520,32 +432,34 @@ export default function createConfig(options: DocsTemplateOptions) {
             tag: "meta",
             attrs: {
               property: "og:image",
-              content: `https://docs.knitli.com/${appName.toLowerCase()}/og-image.png`,
-            },
+              content: `https://docs.knitli.com/${appName.toLowerCase()}/og-image.png`
+            }
           },
           {
             tag: "meta",
             attrs: {
               property: "twitter:card",
-              content: "summary_large_image",
-            },
-          },
+              content: "summary_large_image"
+            }
+          }
         ],
         sidebar: sidebarConfig || [
           {
             label: "Guides",
-            autogenerate: { directory: "guides" },
+            autogenerate: { directory: "guides" }
           },
           {
             label: "Examples",
-            autogenerate: { directory: "examples" },
+            autogenerate: { directory: "examples" }
           },
           {
             label: "Reference",
-            autogenerate: { directory: "reference" },
-          },
-        ],
-      }),
-    ],
+            autogenerate: { directory: "reference" }
+          }
+        ]
+      })
+    ]
   });
 }
+
+export { createConfig as default, docsStyle, faviconIco, faviconSvg, headlineLogoDark, headlineLogoLight, variables };

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+export { type DocsTemplateOptions, default as createConfig } from "./config.js";
+export interface InitOptions {
+    /** Display name for the product (e.g. "Recoco", "CodeWeaver") */
+    appName: string;
+    /** npm package name (e.g. "@knitli-site/recoco-docs") */
+    name: string;
+    /** Short product description */
+    description: string;
+    /** Cloudflare Worker name (e.g. "recoco-docs") */
+    workerName?: string;
+    /** Whether this is a CodeWeaver-branded site */
+    is_codeweaver?: boolean;
+}
+export interface AddPiecesOptions extends InitOptions {
+    pieces: PieceName[];
+    /** Overwrite existing files (default: false — skips with a warning) */
+    force?: boolean;
+}
+export declare const PIECES: {
+    readonly config: {
+        readonly description: "Astro config using createConfig()";
+        readonly paths: readonly ["astro.config.ts"];
+    };
+    readonly wrangler: {
+        readonly description: "Cloudflare Worker deployment config";
+        readonly paths: readonly ["wrangler.jsonc"];
+    };
+    readonly tsconfig: {
+        readonly description: "TypeScript config extending shared base";
+        readonly paths: readonly ["tsconfig.json"];
+    };
+    readonly content: {
+        readonly description: "Content collections, env types, and tags";
+        readonly paths: readonly ["src/content.config.ts", "src/env.d.ts", "tags.yml"];
+    };
+    readonly mise: {
+        readonly description: "mise dev tasks (build, deploy, clean, etc.)";
+        readonly paths: readonly ["mise.toml"];
+    };
+    readonly styles: {
+        readonly description: "Custom CSS hook for site-specific styles";
+        readonly paths: readonly ["src/styles/custom.css"];
+    };
+    readonly deps: {
+        readonly description: "package.json with template dependencies";
+        readonly paths: readonly ["package.json"];
+    };
+    readonly "starter-content": {
+        readonly description: "Example documentation pages";
+        readonly paths: readonly ["src/content/docs"];
+    };
+};
+export type PieceName = keyof typeof PIECES;
+export declare const PIECE_NAMES: PieceName[];
+/**
+ * Initialize a new Knitli docs site from the template scaffolding.
+ *
+ * Copies all files from the scaffolding directory to the target path,
+ * applying placeholder substitution to text files.
+ */
+export declare function initDocsTemplate(targetPath: string, options: InitOptions): string[];
+/**
+ * Add specific pieces from the template scaffolding to an existing project.
+ *
+ * Unlike initDocsTemplate, this only copies the files belonging to the
+ * requested pieces and skips existing files unless force is set.
+ */
+export declare function addPieces(targetPath: string, options: AddPiecesOptions): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,mBAAmB,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,aAAa,CAAC;AAOhF,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAID,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCT,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAC5C,eAAO,MAAM,WAAW,EAA0B,SAAS,EAAE,CAAC;AAyF9D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,GACnB,MAAM,EAAE,CAWV;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,GACxB,MAAM,EAAE,CAyCV"}

package/{src/index.ts → dist/index.js}

@@ -1,89 +1,46 @@
-// SPDX-FileCopyrightText: 2026 Knitli Inc.
-//
-// SPDX-License-Identifier: Apache-2.0
-
-import {
-  cpSync,
-  existsSync,
-  mkdirSync,
-  readdirSync,
-  readFileSync,
-  statSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, join, resolve } from "node:path";
-import { fileURLToPath } from "node:url";
-
-export { type DocsTemplateOptions, default as createConfig } from "./config.js";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const SCAFFOLDING_DIR = resolve(__dirname, "../scaffolding");
-
-// ── Options ──
-
-export interface InitOptions {
-  /** Display name for the product (e.g. "Recoco", "CodeWeaver") */
-  appName: string;
-  /** npm package name (e.g. "@knitli-site/recoco-docs") */
-  name: string;
-  /** Short product description */
-  description: string;
-  /** Cloudflare Worker name (e.g. "recoco-docs") */
-  workerName?: string;
-  /** Whether this is a CodeWeaver-branded site */
-  is_codeweaver?: boolean;
-}
-
-export interface AddPiecesOptions extends InitOptions {
-  pieces: PieceName[];
-  /** Overwrite existing files (default: false — skips with a warning) */
-  force?: boolean;
-}
-
-// ── Piece definitions ──
-
-export const PIECES = {
+import { existsSync, statSync, mkdirSync, readdirSync, readFileSync, writeFileSync, cpSync } from 'node:fs';
+import { dirname, resolve, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export { default as createConfig } from './config.js';
+
+const __dirname$1 = dirname(fileURLToPath(import.meta.url));
+const SCAFFOLDING_DIR = resolve(__dirname$1, "../scaffolding");
+const PIECES = {
   config: {
     description: "Astro config using createConfig()",
-    paths: ["astro.config.ts"],
+    paths: ["astro.config.ts"]
   },
   wrangler: {
     description: "Cloudflare Worker deployment config",
-    paths: ["wrangler.jsonc"],
+    paths: ["wrangler.jsonc"]
   },
   tsconfig: {
     description: "TypeScript config extending shared base",
-    paths: ["tsconfig.json"],
+    paths: ["tsconfig.json"]
   },
   content: {
     description: "Content collections, env types, and tags",
-    paths: ["src/content.config.ts", "src/env.d.ts", "tags.yml"],
+    paths: ["src/content.config.ts", "src/env.d.ts", "tags.yml"]
   },
   mise: {
     description: "mise dev tasks (build, deploy, clean, etc.)",
-    paths: ["mise.toml"],
+    paths: ["mise.toml"]
   },
   styles: {
     description: "Custom CSS hook for site-specific styles",
-    paths: ["src/styles/custom.css"],
+    paths: ["src/styles/custom.css"]
   },
   deps: {
     description: "package.json with template dependencies",
-    paths: ["package.json"],
+    paths: ["package.json"]
   },
   "starter-content": {
     description: "Example documentation pages",
-    paths: ["src/content/docs"],
-  },
-} as const;
-
-export type PieceName = keyof typeof PIECES;
-export const PIECE_NAMES = Object.keys(PIECES) as PieceName[];
-
-// ── Shared helpers ──
-
-/** File extensions that should have placeholder substitution applied */
-const TEXT_EXTENSIONS = new Set([
+    paths: ["src/content/docs"]
+  }
+};
+const PIECE_NAMES = Object.keys(PIECES);
+const TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ts",
   ".js",
   ".mjs",
@@ -96,42 +53,28 @@ const TEXT_EXTENSIONS = new Set([
   ".css",
   ".html",
   ".astro",
-  ".toml",
+  ".toml"
 ]);
-
-function isTextFile(filePath: string): boolean {
+function isTextFile(filePath) {
   return TEXT_EXTENSIONS.has(filePath.slice(filePath.lastIndexOf(".")));
 }
-
-function buildReplacements(options: InitOptions): Record<string, string> {
+function buildReplacements(options) {
   return {
     "{{appName}}": options.appName,
     "{{appNameLower}}": options.appName.toLowerCase(),
     "{{name}}": options.name,
     "{{description}}": options.description,
-    "{{workerName}}":
-      options.workerName ?? `${options.appName.toLowerCase()}-docs`,
+    "{{workerName}}": options.workerName ?? `${options.appName.toLowerCase()}-docs`
   };
 }
-
-function applyReplacements(
-  content: string,
-  replacements: Record<string, string>,
-): string {
+function applyReplacements(content, replacements) {
   let result = content;
   for (const [placeholder, value] of Object.entries(replacements)) {
     result = result.replaceAll(placeholder, value);
   }
   return result;
 }
-
-function copyFile(
-  srcPath: string,
-  destPath: string,
-  replacements: Record<string, string>,
-  created: string[],
-  force?: boolean,
-): void {
+function copyFile(srcPath, destPath, replacements, created, force) {
   if (!force && existsSync(destPath)) {
     console.log(`  skip ${destPath} (exists, use --force to overwrite)`);
     return;
@@ -145,14 +88,7 @@ function copyFile(
   }
   created.push(destPath);
 }
-
-function copyDirRecursive(
-  srcDir: string,
-  destDir: string,
-  replacements: Record<string, string>,
-  created: string[],
-  force?: boolean,
-): void {
+function copyDirRecursive(srcDir, destDir, replacements, created, force) {
   mkdirSync(destDir, { recursive: true });
   for (const entry of readdirSync(srcDir)) {
     const srcPath = join(srcDir, entry);
@@ -164,73 +100,51 @@ function copyDirRecursive(
     }
   }
 }
-
-// ── Public API ──
-
-/**
- * Initialize a new Knitli docs site from the template scaffolding.
- *
- * Copies all files from the scaffolding directory to the target path,
- * applying placeholder substitution to text files.
- */
-export function initDocsTemplate(
-  targetPath: string,
-  options: InitOptions,
-): string[] {
+function initDocsTemplate(targetPath, options) {
   const target = resolve(targetPath);
   const replacements = buildReplacements(options);
-  const created: string[] = [];
-
+  const created = [];
   if (!existsSync(SCAFFOLDING_DIR)) {
     throw new Error(`Scaffolding directory not found at ${SCAFFOLDING_DIR}`);
   }
-
   copyDirRecursive(SCAFFOLDING_DIR, target, replacements, created, true);
   return created;
 }
-
-/**
- * Add specific pieces from the template scaffolding to an existing project.
- *
- * Unlike initDocsTemplate, this only copies the files belonging to the
- * requested pieces and skips existing files unless force is set.
- */
-export function addPieces(
-  targetPath: string,
-  options: AddPiecesOptions,
-): string[] {
+function addPieces(targetPath, options) {
   const target = resolve(targetPath);
   const replacements = buildReplacements(options);
-  const created: string[] = [];
-
+  const created = [];
   if (!existsSync(SCAFFOLDING_DIR)) {
     throw new Error(`Scaffolding directory not found at ${SCAFFOLDING_DIR}`);
   }
-
   for (const piece of options.pieces) {
     const pieceDef = PIECES[piece];
     if (!pieceDef) {
       throw new Error(
-        `Unknown piece: ${piece}. Available: ${PIECE_NAMES.join(", ")}`,
+        `Unknown piece: ${piece}. Available: ${PIECE_NAMES.join(", ")}`
       );
     }
-
     for (const relPath of pieceDef.paths) {
       const srcPath = join(SCAFFOLDING_DIR, relPath);
       const destPath = join(target, relPath);
-
       if (!existsSync(srcPath)) {
         console.warn(`  warn: ${relPath} not found in scaffolding, skipping`);
         continue;
       }
-
       if (statSync(srcPath).isDirectory()) {
-        copyDirRecursive(srcPath, destPath, replacements, created, options.force);
+        copyDirRecursive(
+          srcPath,
+          destPath,
+          replacements,
+          created,
+          options.force
+        );
       } else {
         copyFile(srcPath, destPath, replacements, created, options.force);
       }
     }
   }
-
   return created;
 }
+
+export { PIECES, PIECE_NAMES, addPieces, initDocsTemplate };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knitli/astro-docs-template",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Opinionated Astro + Starlight docs site template with Knitli branding",
   "keywords": [
     "knitli",
@@ -19,20 +19,26 @@
   "author": "Knitli Inc.",
   "type": "module",
   "exports": {
-    ".": "./src/index.ts",
-    "./config": "./src/config.ts"
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    }
   },
   "bin": {
-    "knitli-docs": "src/cli.ts"
+    "knitli-docs": "dist/cli.js"
   },
   "files": [
-    "src",
+    "dist",
     "scaffolding",
     "README.md",
     "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "bunx tsc --noCheck",
+    "build": "vite build && tsc --emitDeclarationOnly --noCheck --noEmit false",
     "prepublishOnly": "bun run build",
     "publish": "npm publish --access public",
     "typecheck": "bunx tsc --noEmit"
@@ -72,7 +78,8 @@
     "lightningcss": "catalog:optimization",
     "sharp": "catalog:astro-core",
     "svgo": "catalog:optimization",
-    "typescript": "catalog:dev-common"
+    "typescript": "catalog:dev-common",
+    "vite": "catalog:dev-common"
   },
   "devEngines": {
     "packageManager": {

package/scaffolding/package.json

@@ -5,7 +5,9 @@
   "type": "module",
   "scripts": {
     "astro": "bunx astro",
-    "prebuild": "test -f ./node_modules/bun/install.js && node ./node_modules/bun/install.js; bunx wrangler types; bunx astro sync",
+    "prepare": "test -f ./node_modules/bun/install.js && node ./node_modules/bun/install.js || true",
+
+    "prebuild": "bunx wrangler types; bunx astro sync",
     "build": "bunx astro build",
     "deploy": "bun run build && bunx wrangler deploy",
     "dev": "bunx astro dev",