[Docs] Fix TooltipProvider missing from Tooltip API Reference section (#440)

* fix(kumo): surface TooltipProvider in Tooltip API Reference

Register TooltipProvider in the component registry as a pass-through
sub-component of Tooltip via a new SUB_COMPONENT_OVERRIDES map. No
runtime change: TooltipProvider stays as a sibling named export.
Adds TooltipBase.Provider props (delay, closeDelay, timeout) to
PASSTHROUGH_COMPONENT_DOCS and a TooltipProvider section to the
Tooltip docs page.

* chore: remove tooltip provider changeset

* chore: restore tooltip-provider-registry changeset

---------

Co-authored-by: Matt Rothenberg <mattrothenberg@users.noreply.github.com>

Author: pedromenezes1

.changeset/tooltip-provider-registry.md

@@ -0,0 +1,5 @@
+---
+"@cloudflare/kumo": patch
+---
+
+TooltipProvider props (`delay`, `closeDelay`, `timeout`) are now shown in the Tooltip component's API Reference on the docs site.

packages/kumo-docs-astro/src/pages/components/tooltip.mdx

@@ -125,5 +125,12 @@ For delay grouping across multiple tooltips, see [TooltipProvider](#tooltipprovi
 
 ## API Reference
 
-  <PropsTable component="Tooltip" />
+### Tooltip
+
+<PropsTable component="Tooltip" />
+
+### TooltipProvider
+
+<PropsTable component="Tooltip.Provider" />
+
 </ComponentSection>

packages/kumo/scripts/component-registry/index.test.ts

@@ -943,3 +943,45 @@ interface GroupProps extends BaseProps {
     expect(props).toEqual({});
   });
 });
+
+describe("SUB_COMPONENT_OVERRIDES", () => {
+  it("declares a Tooltip.Provider entry that passes through to TooltipBase.Provider", async () => {
+    const { SUB_COMPONENT_OVERRIDES, PASSTHROUGH_COMPONENT_DOCS } =
+      await import("./metadata.js");
+
+    expect(SUB_COMPONENT_OVERRIDES.Tooltip).toBeDefined();
+    const tooltipOverrides = SUB_COMPONENT_OVERRIDES.Tooltip;
+    expect(tooltipOverrides).toHaveLength(1);
+
+    const provider = tooltipOverrides[0];
+    expect(provider.name).toBe("Provider");
+    expect(provider.valueName).toBe("TooltipProvider");
+    expect(provider.isPassThrough).toBe(true);
+    expect(provider.baseComponent).toBe("TooltipBase.Provider");
+    expect(provider.propsType).toBeNull();
+
+    // The baseComponent must resolve to a documented passthrough entry so the
+    // merge + lookup path in index.ts produces real docs, not an empty stub.
+    expect(
+      PASSTHROUGH_COMPONENT_DOCS[provider.baseComponent as string],
+    ).toBeDefined();
+  });
+
+  it("entries have the same shape as detectSubComponents() results", async () => {
+    const { SUB_COMPONENT_OVERRIDES } = await import("./metadata.js");
+
+    for (const overrides of Object.values(SUB_COMPONENT_OVERRIDES)) {
+      for (const entry of overrides) {
+        // Required fields of SubComponentConfig.
+        expect(typeof entry.name).toBe("string");
+        expect(typeof entry.valueName).toBe("string");
+        expect(typeof entry.description).toBe("string");
+        expect(typeof entry.isPassThrough).toBe("boolean");
+        // propsType may be a string or null.
+        expect(
+          entry.propsType === null || typeof entry.propsType === "string",
+        ).toBe(true);
+      }
+    }
+  });
+});

packages/kumo/scripts/component-registry/index.ts

@@ -62,6 +62,7 @@ import {
   ADDITIONAL_COMPONENT_PROPS,
   PROP_TYPE_OVERRIDES,
   COMPONENT_STYLING_METADATA,
+  SUB_COMPONENT_OVERRIDES,
 } from "./metadata.js";
 
 // External imports - demo examples from kumo-docs-astro
@@ -598,14 +599,21 @@ async function processComponent(
     }
   }
 
-  // Detect and process sub-components
+  // Merge SUB_COMPONENT_OVERRIDES after source detection.
+  // Detected entries win on name conflict so source-level patterns aren't masked.
   const detectedSubComponents = detectSubComponents(sourcePath);
+  const subComponentOverrides = SUB_COMPONENT_OVERRIDES[config.name] ?? [];
+  const detectedNames = new Set(detectedSubComponents.map((sc) => sc.name));
+  const mergedSubComponents = [
+    ...detectedSubComponents,
+    ...subComponentOverrides.filter((o) => !detectedNames.has(o.name)),
+  ];
   let subComponentSchemas: Record<string, SubComponentSchema> | undefined;
 
-  if (detectedSubComponents.length > 0) {
+  if (mergedSubComponents.length > 0) {
     subComponentSchemas = {};
 
-    for (const subComp of detectedSubComponents) {
+    for (const subComp of mergedSubComponents) {
       let subProps = extractSubComponentProps(sourcePath, subComp, CLI_FLAGS);
       let description = subComp.description;
       let usageExamples: string[] | undefined;

packages/kumo/scripts/component-registry/metadata.ts

@@ -8,7 +8,12 @@
  * - Styling metadata for Figma plugin
  */
 
-import type { PropSchema, PassthroughDoc, ComponentStyling } from "./types.js";
+import type {
+  PropSchema,
+  PassthroughDoc,
+  ComponentStyling,
+  SubComponentConfig,
+} from "./types.js";
 
 // =============================================================================
 // Pass-through Component Documentation
@@ -158,6 +163,66 @@ export const PASSTHROUGH_COMPONENT_DOCS: Record<string, PassthroughDoc> = {
 </Combobox.Collection>`,
     ],
   },
+
+  // Tooltip sub-components
+  "TooltipBase.Provider": {
+    description:
+      "Groups multiple tooltips so that after the first tooltip is shown, switching to another skips the open delay. Place once at your app root or layout.",
+    props: {
+      delay: {
+        type: "number",
+        description:
+          "How long to wait (ms) before opening a tooltip once the pointer enters the trigger.",
+        default: "600",
+      },
+      closeDelay: {
+        type: "number",
+        description: "How long to wait (ms) before closing a tooltip.",
+        default: "0",
+      },
+      timeout: {
+        type: "number",
+        description:
+          "Grace period (ms) during which a just-closed tooltip's delay is skipped when another tooltip opens.",
+        default: "400",
+      },
+    },
+    usageExamples: ["<TooltipProvider>\n  <App />\n</TooltipProvider>"],
+  },
+};
+
+// =============================================================================
+// Sub-Component Overrides
+// =============================================================================
+
+/**
+ * Manual sub-component entries that are merged into the registry alongside
+ * entries detected by `detectSubComponents()` in `sub-components.ts`.
+ *
+ * Use this when a component exposes a related API (e.g., a sibling named
+ * export like `TooltipProvider`) that we want documented as a sub-component
+ * (e.g., `Tooltip.Provider`) for the registry / docs, *without* changing the
+ * component's runtime shape (no `Object.assign`, no attached property).
+ *
+ * Detected sub-components take precedence over overrides with the same
+ * `name`, so a real source-level compound pattern will always win and
+ * prevent silent masking of detector regressions.
+ *
+ * Keyed by the parent component name (e.g., "Tooltip"). Values have the same
+ * shape as `detectSubComponents()` entries so they feed directly into the
+ * existing processing loop in `index.ts`.
+ */
+export const SUB_COMPONENT_OVERRIDES: Record<string, SubComponentConfig[]> = {
+  Tooltip: [
+    {
+      name: "Provider",
+      valueName: "TooltipProvider",
+      propsType: null,
+      description: "Provider sub-component (wraps TooltipBase)",
+      isPassThrough: true,
+      baseComponent: "TooltipBase.Provider",
+    },
+  ],
 };
 
 // =============================================================================