@patternfly/patternfly-doc-core 1.16.1 → 1.18.0

package/dist/docs/_worker.js/pages/api/_version_/_section_/_page_/props.astro.mjs

@@ -0,0 +1,49 @@
+globalThis.process ??= {}; globalThis.process.env ??= {};
+import { c as createJsonResponse } from '../../../../../chunks/apiHelpers_CD8DANYs.mjs';
+import { g as getConfig } from '../../../../../chunks/getConfig_DO3RhTb7.mjs';
+import { join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { s as sentenceCase } from '../../../../../chunks/case_DEd0yJND.mjs';
+export { r as renderers } from '../../../../../chunks/_@astro-renderers_OzpRq-hZ.mjs';
+
+const prerender = false;
+const GET = async ({ params }) => {
+  const { page } = params;
+  if (!page) {
+    return createJsonResponse(
+      { error: "Page parameter is required" },
+      400
+    );
+  }
+  try {
+    const config = await getConfig(`${process.cwd()}/pf-docs.config.mjs`);
+    const outputDir = config?.outputDir || join(process.cwd(), "dist");
+    const propsFilePath = join(outputDir, "props.json");
+    const propsDataFile = readFileSync(propsFilePath);
+    const props = JSON.parse(propsDataFile.toString());
+    const propsData = props[sentenceCase(page)];
+    if (propsData === void 0) {
+      return createJsonResponse(
+        { error: `Props data for ${page} not found` },
+        404
+      );
+    }
+    return createJsonResponse(propsData);
+  } catch (error) {
+    const details = error instanceof Error ? error.message : String(error);
+    return createJsonResponse(
+      { error: "Props data not found", details },
+      500
+    );
+  }
+};
+
+const _page = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
+  __proto__: null,
+  GET,
+  prerender
+}, Symbol.toStringTag, { value: 'Module' }));
+
+const page = () => _page;
+
+export { page };

package/dist/docs/_worker.js/pages/api/_version_/_section_/names.astro.mjs

@@ -0,0 +1,36 @@
+globalThis.process ??= {}; globalThis.process.env ??= {};
+import { c as createJsonResponse } from '../../../../chunks/apiHelpers_CD8DANYs.mjs';
+import { g as getConfig } from '../../../../chunks/getConfig_DO3RhTb7.mjs';
+import { join } from 'node:path';
+import { readFileSync } from 'node:fs';
+export { r as renderers } from '../../../../chunks/_@astro-renderers_OzpRq-hZ.mjs';
+
+const prerender = false;
+const GET = async ({}) => {
+  try {
+    const config = await getConfig(`${process.cwd()}/pf-docs.config.mjs`);
+    const outputDir = config?.outputDir || join(process.cwd(), "dist");
+    const propsFilePath = join(outputDir, "props.json");
+    const propsDataFile = readFileSync(propsFilePath);
+    const props = JSON.parse(propsDataFile.toString());
+    const propsKey = new RegExp("Props", "i");
+    const names = Object.keys(props).filter((name) => !propsKey.test(name));
+    return createJsonResponse(names);
+  } catch (error) {
+    const details = error instanceof Error ? error.message : String(error);
+    return createJsonResponse(
+      { error: "Component names data not found", details },
+      500
+    );
+  }
+};
+
+const _page = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
+  __proto__: null,
+  GET,
+  prerender
+}, Symbol.toStringTag, { value: 'Module' }));
+
+const page = () => _page;
+
+export { page };

package/dist/docs/_worker.js/pages/api/_version_/tokens/_category_.astro.mjs

@@ -0,0 +1,54 @@
+globalThis.process ??= {}; globalThis.process.env ??= {};
+import { c as createJsonResponse } from '../../../../chunks/apiHelpers_CD8DANYs.mjs';
+import { f as fetchApiIndex } from '../../../../chunks/fetch_CoXtH9RF.mjs';
+import { a as getTokensForCategory, b as getTokenCategories, c as filterTokens } from '../../../../chunks/tokens_BSL29Ypc.mjs';
+export { r as renderers } from '../../../../chunks/_@astro-renderers_OzpRq-hZ.mjs';
+
+const prerender = false;
+const GET = async ({ params, url }) => {
+  const { version, category } = params;
+  if (!version || !category) {
+    return createJsonResponse(
+      { error: "Version and category parameters are required" },
+      400
+    );
+  }
+  try {
+    const index = await fetchApiIndex(url);
+    if (!index.versions.includes(version)) {
+      return createJsonResponse(
+        { error: `Version '${version}' not found` },
+        404
+      );
+    }
+    const tokens = getTokensForCategory(category);
+    if (!tokens) {
+      const validCategories = getTokenCategories();
+      return createJsonResponse(
+        {
+          error: `Category '${category}' not found`,
+          validCategories
+        },
+        404
+      );
+    }
+    const filterParam = url.searchParams.get("filter");
+    const filteredTokens = filterParam ? filterTokens(tokens, filterParam) : tokens;
+    return createJsonResponse(filteredTokens);
+  } catch (error) {
+    return createJsonResponse(
+      { error: "Failed to load tokens", details: error },
+      500
+    );
+  }
+};
+
+const _page = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
+  __proto__: null,
+  GET,
+  prerender
+}, Symbol.toStringTag, { value: 'Module' }));
+
+const page = () => _page;
+
+export { page };

package/dist/docs/_worker.js/pages/api/_version_/tokens/all.astro.mjs

@@ -0,0 +1,41 @@
+globalThis.process ??= {}; globalThis.process.env ??= {};
+import { c as createJsonResponse } from '../../../../chunks/apiHelpers_CD8DANYs.mjs';
+import { f as fetchApiIndex } from '../../../../chunks/fetch_CoXtH9RF.mjs';
+import { g as getTokensByCategory, f as filterTokensByCategory } from '../../../../chunks/tokens_BSL29Ypc.mjs';
+export { r as renderers } from '../../../../chunks/_@astro-renderers_OzpRq-hZ.mjs';
+
+const prerender = false;
+const GET = async ({ params, url }) => {
+  const { version } = params;
+  if (!version) {
+    return createJsonResponse({ error: "Version parameter is required" }, 400);
+  }
+  try {
+    const index = await fetchApiIndex(url);
+    if (!index.versions.includes(version)) {
+      return createJsonResponse(
+        { error: `Version '${version}' not found` },
+        404
+      );
+    }
+    const tokensByCategory = getTokensByCategory();
+    const filterParam = url.searchParams.get("filter");
+    const filteredTokens = filterParam ? filterTokensByCategory(tokensByCategory, filterParam) : tokensByCategory;
+    return createJsonResponse(filteredTokens);
+  } catch (error) {
+    return createJsonResponse(
+      { error: "Failed to load tokens", details: error },
+      500
+    );
+  }
+};
+
+const _page = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
+  __proto__: null,
+  GET,
+  prerender
+}, Symbol.toStringTag, { value: 'Module' }));
+
+const page = () => _page;
+
+export { page };

package/dist/docs/_worker.js/pages/api/_version_/tokens.astro.mjs

@@ -0,0 +1,39 @@
+globalThis.process ??= {}; globalThis.process.env ??= {};
+import { c as createJsonResponse } from '../../../chunks/apiHelpers_CD8DANYs.mjs';
+import { f as fetchApiIndex } from '../../../chunks/fetch_CoXtH9RF.mjs';
+import { b as getTokenCategories } from '../../../chunks/tokens_BSL29Ypc.mjs';
+export { r as renderers } from '../../../chunks/_@astro-renderers_OzpRq-hZ.mjs';
+
+const prerender = false;
+const GET = async ({ params, url }) => {
+  const { version } = params;
+  if (!version) {
+    return createJsonResponse({ error: "Version parameter is required" }, 400);
+  }
+  try {
+    const index = await fetchApiIndex(url);
+    if (!index.versions.includes(version)) {
+      return createJsonResponse(
+        { error: `Version '${version}' not found` },
+        404
+      );
+    }
+    const categories = getTokenCategories();
+    return createJsonResponse(categories);
+  } catch (error) {
+    return createJsonResponse(
+      { error: "Failed to load tokens", details: error },
+      500
+    );
+  }
+};
+
+const _page = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
+  __proto__: null,
+  GET,
+  prerender
+}, Symbol.toStringTag, { value: 'Module' }));
+
+const page = () => _page;
+
+export { page };

package/dist/docs/_worker.js/pages/api/openapi.json.astro.mjs

@@ -219,6 +219,70 @@ const GET = async ({ url }) => {
           }
         }
       },
+      "/{version}/{section}/names": {
+        get: {
+          summary: "Get component names",
+          description: "Returns the component names that have props data",
+          operationId: "getNames",
+          parameters: [
+            {
+              name: "version",
+              in: "path",
+              required: true,
+              description: "Documentation version",
+              schema: {
+                type: "string",
+                enum: versions
+              },
+              example: "v6"
+            },
+            {
+              name: "section",
+              in: "path",
+              required: true,
+              description: "Documentation section",
+              schema: {
+                type: "string"
+              },
+              example: "components"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Component names with props data",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    }
+                  },
+                  example: [
+                    "Alert",
+                    "AlertGroup"
+                  ]
+                }
+              }
+            },
+            "404": {
+              description: "Props not found",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      error: {
+                        type: "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "/{version}/{section}/{page}": {
         get: {
           summary: "List tabs for a page",
@@ -290,6 +354,100 @@ const GET = async ({ url }) => {
           }
         }
       },
+      "/{version}/{section}/{page}/props": {
+        get: {
+          summary: "Get component props",
+          description: "Returns the props for the specified component",
+          operationId: "getProps",
+          parameters: [
+            {
+              name: "version",
+              in: "path",
+              required: true,
+              description: "Documentation version",
+              schema: {
+                type: "string",
+                enum: versions
+              },
+              example: "v6"
+            },
+            {
+              name: "section",
+              in: "path",
+              required: true,
+              description: "Documentation section",
+              schema: {
+                type: "string"
+              },
+              example: "components"
+            },
+            {
+              name: "page",
+              in: "path",
+              required: true,
+              description: "Page ID (kebab-cased)",
+              schema: {
+                type: "string"
+              },
+              example: "alert"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Props for the specified component",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "array",
+                    items: {
+                      type: "object",
+                      properties: {
+                        name: { type: "string" },
+                        type: { type: "string" },
+                        description: { type: "string" },
+                        defaultValue: { type: "string" }
+                      }
+                    }
+                  },
+                  example: [
+                    {
+                      name: "actionClose",
+                      type: "React.ReactNode",
+                      description: "Close button; use the alert action close button component."
+                    },
+                    {
+                      name: "actionLinks",
+                      type: "React.ReactNode",
+                      description: "Action links; use a single alert action link component or multiple wrapped in an array\nor React fragment."
+                    },
+                    {
+                      name: "children",
+                      type: "React.ReactNode",
+                      description: "Content rendered inside the alert.",
+                      defaultValue: "''"
+                    }
+                  ]
+                }
+              }
+            },
+            "404": {
+              description: "Props not found",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      error: {
+                        type: "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
       "/{version}/{section}/{page}/{tab}": {
         get: {
           summary: "Validate and redirect to text endpoint",
@@ -621,6 +779,249 @@ export const AlertBasic = () => <Alert title="Basic alert" />;`
             }
           }
         }
+      },
+      "/{version}/tokens": {
+        get: {
+          summary: "List token categories",
+          description: "Returns an alphabetically sorted array of available design token categories from @patternfly/react-tokens. Categories are determined by token name prefixes (e.g., c_, t_, chart_). Optimized for MCP/LLM consumption.",
+          operationId: "getTokenCategories",
+          parameters: [
+            {
+              name: "version",
+              in: "path",
+              required: true,
+              description: "Documentation version",
+              schema: {
+                type: "string",
+                enum: versions
+              },
+              example: "v6"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "List of token categories",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "array",
+                    items: {
+                      type: "string"
+                    }
+                  },
+                  example: ["c", "chart", "global", "hidden", "l", "t"]
+                }
+              }
+            },
+            "404": {
+              description: "Version not found",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      error: {
+                        type: "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/{version}/tokens/{category}": {
+        get: {
+          summary: "Get tokens for a category",
+          description: "Returns design tokens for a specific category with optional filtering. Each token includes name (CSS variable name), value (resolved value), and var (CSS var() reference). Use the filter query parameter for case-insensitive substring matching to minimize response size.",
+          operationId: "getTokensByCategory",
+          parameters: [
+            {
+              name: "version",
+              in: "path",
+              required: true,
+              description: "Documentation version",
+              schema: {
+                type: "string",
+                enum: versions
+              },
+              example: "v6"
+            },
+            {
+              name: "category",
+              in: "path",
+              required: true,
+              description: "Token category (e.g., c, t, chart)",
+              schema: {
+                type: "string"
+              },
+              example: "c"
+            },
+            {
+              name: "filter",
+              in: "query",
+              required: false,
+              description: "Case-insensitive substring filter to match against token names",
+              schema: {
+                type: "string"
+              },
+              example: "alert"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Array of tokens matching the criteria",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "array",
+                    items: {
+                      type: "object",
+                      properties: {
+                        name: {
+                          type: "string",
+                          description: "CSS variable name"
+                        },
+                        value: {
+                          type: "string",
+                          description: "Resolved CSS value"
+                        },
+                        var: {
+                          type: "string",
+                          description: "CSS var() reference"
+                        }
+                      },
+                      required: ["name", "value", "var"]
+                    }
+                  },
+                  example: [
+                    {
+                      name: "--pf-v6-c-alert--Color",
+                      value: "#000",
+                      var: "var(--pf-v6-c-alert--Color)"
+                    }
+                  ]
+                }
+              }
+            },
+            "404": {
+              description: "Category not found",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      error: {
+                        type: "string"
+                      },
+                      validCategories: {
+                        type: "array",
+                        items: {
+                          type: "string"
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/{version}/tokens/all": {
+        get: {
+          summary: "Get all tokens grouped by category",
+          description: "Returns all design tokens organized by category with optional filtering. Use the filter query parameter to minimize response size for MCP/LLM consumption. Empty categories are excluded from filtered results.",
+          operationId: "getAllTokens",
+          parameters: [
+            {
+              name: "version",
+              in: "path",
+              required: true,
+              description: "Documentation version",
+              schema: {
+                type: "string",
+                enum: versions
+              },
+              example: "v6"
+            },
+            {
+              name: "filter",
+              in: "query",
+              required: false,
+              description: "Case-insensitive substring filter to match against token names across all categories",
+              schema: {
+                type: "string"
+              },
+              example: "color"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Object with category keys and token arrays as values",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    additionalProperties: {
+                      type: "array",
+                      items: {
+                        type: "object",
+                        properties: {
+                          name: {
+                            type: "string",
+                            description: "CSS variable name"
+                          },
+                          value: {
+                            type: "string",
+                            description: "Resolved CSS value"
+                          },
+                          var: {
+                            type: "string",
+                            description: "CSS var() reference"
+                          }
+                        },
+                        required: ["name", "value", "var"]
+                      }
+                    }
+                  },
+                  example: {
+                    c: [
+                      {
+                        name: "--pf-v6-c-alert--Color",
+                        value: "#000",
+                        var: "var(--pf-v6-c-alert--Color)"
+                      }
+                    ],
+                    t: [
+                      {
+                        name: "--pf-v6-t-global--Color",
+                        value: "#333",
+                        var: "var(--pf-v6-t-global--Color)"
+                      }
+                    ]
+                  }
+                }
+              }
+            },
+            "404": {
+              description: "Version not found",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      error: {
+                        type: "string"
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
       }
     },
     tags: [