feat(docs): add Foundation; group it and Query Filters under Libraries

- Add GravityKit/Foundation as a documented product (scanned from src/)
- New "Libraries" category + navbar heading under Free Add-Ons
- Move Query Filters from GravityKit Products to Libraries
- generate-hooks: add replaceIgnoreHooks so Foundation documents its own
  gk/foundation/* hooks while every other product keeps ignoring them
- Homepage: skip product-card icons when no static/img/{id}.svg exists

Foundation generates 137 hooks (39 actions, 98 filters) with no hook
leakage into other products. Production build passes.

Claude-Session: https://claude.ai/code/session_01WGs3aAJqYoXNEVCiru5obx

Author: zackkatz

docusaurus.config.js

@@ -36,6 +36,17 @@ const products_with_docs = config_products
 // every page.
 const product_ids_with_docs = new Set(products_with_docs.map((p) => p.id));
 
+// Product icons live at static/img/{id}.svg. Not every product has one (e.g.
+// Foundation, Query Filters), so build a set of ids that do. The homepage uses
+// this to skip rendering a broken icon for products without an artwork file.
+const product_icon_dir = fileURLToPath(new URL('./static/img', import.meta.url));
+const product_ids_with_icons = fs.existsSync(product_icon_dir)
+  ? fs
+      .readdirSync(product_icon_dir)
+      .filter((file) => file.endsWith('.svg'))
+      .map((file) => file.replace(/\.svg$/, ''))
+  : [];
+
 // Read actual plugin versions from repository files
 const product_versions = readAllProductVersions(config_products);
 
@@ -129,6 +140,16 @@ const gravitykit_nav = {
       className: 'dropdown-heading-item',
     },
     ...getFreeProducts(),
+    {
+      type: 'html',
+      value: '<hr class="dropdown-separator">',
+    },
+    {
+      type: 'html',
+      value: '<span class="dropdown-heading">Libraries</span>',
+      className: 'dropdown-heading-item',
+    },
+    ...getProductsByCategory('libraries'),
   ],
 };
 
@@ -274,6 +295,12 @@ const config = {
   tagline: 'Comprehensive documentation for all GravityKit products',
   favicon: 'img/favicon-192.png',
 
+  // Build-time data made available to pages via siteConfig.customFields.
+  customFields: {
+    // Product ids that have a static/img/{id}.svg icon file.
+    productIdsWithIcons: product_ids_with_icons,
+  },
+
   // Client modules - runs on every page load
   clientModules: [
     './src/clientModules/docsbot.js',

repos-config.json

@@ -63,6 +63,11 @@
       "label": "MCPs",
       "description": "Model Context Protocol servers that connect AI assistants to your WordPress site.",
       "position": 6
+    },
+    "libraries": {
+      "label": "Libraries",
+      "description": "Shared developer libraries that power GravityKit products.",
+      "position": 7
     }
   },
   "products": [
@@ -278,12 +283,22 @@
       "category": "gravitykit",
       "purchaseUrl": "https://www.gravitykit.com/products/gravitysearch/"
     },
+    {
+      "id": "foundation",
+      "repo": "GravityKit/Foundation",
+      "label": "Foundation",
+      "description": "The shared framework powering every GravityKit product: licensing, settings, admin UI, translations, and plugin updates.",
+      "category": "libraries",
+      "srcDir": "src",
+      "replaceIgnoreHooks": true,
+      "ignoreHooks": ["deprecated_*", "private_*", "_internal_*"]
+    },
     {
       "id": "query-filters",
       "repo": "GravityKit/Query-Filters",
       "label": "Query Filters",
       "description": "Advanced filtering for Gravity Forms' GF_Query and form fields — the shared library behind Advanced Filter, GravityExport, GravityCalendar, GravityCharts, and GravityBoard.",
-      "category": "gravitykit"
+      "category": "libraries"
     },
     {
       "id": "gravityflow",

scripts/generate-hooks.mjs

@@ -711,7 +711,14 @@ function generateHooksDocs(product, config, options) {
       hooksConfig.ignoreFiles = [...hooksConfig.ignoreFiles, ...product.ignoreFiles];
     }
     if (product.ignoreHooks) {
-      hooksConfig.ignoreHooks = [...hooksConfig.ignoreHooks, ...product.ignoreHooks];
+      // By default a product's ignoreHooks are appended to the shared defaults.
+      // A product that needs to document hooks the defaults would strip (e.g.
+      // Foundation documenting its own gk/foundation/* hooks) sets
+      // replaceIgnoreHooks: true to replace the defaults entirely. This keeps
+      // every other product still ignoring those hooks.
+      hooksConfig.ignoreHooks = product.replaceIgnoreHooks
+        ? [...product.ignoreHooks]
+        : [...hooksConfig.ignoreHooks, ...product.ignoreHooks];
     }
 
     const configPath = path.join(tempWorkDir, 'wp-hooks-doc.json');

src/pages/index.js

@@ -129,13 +129,16 @@ function HomepageHeader() {
  * @returns {JSX.Element}
  */
 function ProductCard({ product, showImage = true }) {
+  const { siteConfig } = useDocusaurusContext();
   const imagePath = useBaseUrl(`/img/${product.id}.svg`);
+  const iconIds = siteConfig.customFields?.productIdsWithIcons || [];
+  const hasIcon = iconIds.includes(product.id);
 
   return (
     <div className={clsx('col col--4 margin-bottom--lg')}>
       <div className="card">
         <div className="card__header">
-          {showImage && (
+          {showImage && hasIcon && (
             <Link to={product.link}>
               <img
                 src={imagePath}