@launchdarkly/toolbar 1.3.1 → 1.4.1

package/dist/core/context/ReactMountContext.d.ts

@@ -1,2 +1,3 @@
 declare const ReactMountContext: import("react").Context<HTMLElement>;
+export declare const useReactMount: () => HTMLElement;
 export default ReactMountContext;

package/dist/core/ui/Toolbar/context/AnalyticsProvider.d.ts

@@ -1,9 +1,7 @@
-import type { LDClient } from 'launchdarkly-js-client-sdk';
 import { ToolbarAnalytics } from '../../../utils/analytics';
 interface AnalyticsProviderProps {
     children: React.ReactNode;
-    ldClient?: LDClient | null;
 }
-export declare function AnalyticsProvider({ children, ldClient }: AnalyticsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function AnalyticsProvider({ children }: AnalyticsProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useAnalytics(): ToolbarAnalytics;
 export {};

package/dist/core/ui/Toolbar/context/InternalClientProvider.d.ts

@@ -0,0 +1,76 @@
+import { type ReactNode } from 'react';
+import type { LDClient, LDContext } from 'launchdarkly-js-client-sdk';
+export interface AuthState {
+    authenticated: boolean;
+    userId?: string;
+    email?: string;
+    [key: string]: unknown;
+}
+export interface InternalClientContextValue {
+    /**
+     * The internal LaunchDarkly client for toolbar features and analytics.
+     * null if not yet initialized.
+     */
+    client: LDClient | null;
+    /**
+     * Whether the internal client is currently initializing.
+     */
+    loading: boolean;
+    /**
+     * Error during initialization, if any.
+     */
+    error: Error | null;
+}
+export interface InternalClientProviderProps {
+    children: ReactNode;
+    /**
+     * Client-side id for the internal toolbar client.
+     * This should be LaunchDarkly's internal toolbar client-side id.
+     * If not provided, the internal client will not be initialized.
+     */
+    clientSideId?: string;
+    /**
+     * Initial context for the internal client.
+     * If not provided, an anonymous context will be used.
+     */
+    initialContext?: LDContext;
+    /**
+     * Base URL for the LaunchDarkly instance.
+     * Defaults to standard LaunchDarkly production environment.
+     * Set this if using a custom LaunchDarkly instance.
+     */
+    baseUrl?: string;
+    /**
+     * Stream URL for the LaunchDarkly instance.
+     * Defaults to standard LaunchDarkly production environment.
+     * Set this if using a custom LaunchDarkly instance.
+     */
+    streamUrl?: string;
+    /**
+     * Events URL for the LaunchDarkly instance.
+     * Defaults to standard LaunchDarkly production environment.
+     * Set this if using a custom LaunchDarkly instance.
+     */
+    eventsUrl?: string;
+}
+/**
+ * InternalClientProvider manages the toolbar's internal LaunchDarkly client.
+ *
+ * This provider handles:
+ * - Initializing the internal client for toolbar features and analytics
+ * - Updating context when user authenticates
+ * - Sending analytics to LaunchDarkly's internal project
+ *
+ * The external client (user's app client) is accessed separately via plugins.
+ */
+export declare function InternalClientProvider({ children, clientSideId, initialContext, baseUrl, streamUrl, eventsUrl, }: InternalClientProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Hook to access the internal LaunchDarkly client.
+ */
+export declare function useInternalClient(): InternalClientContextValue;
+/**
+ * Hook to get just the client instance (or null if not ready).
+ *
+ * This is a convenience hook for cases where you don't need loading/error state.
+ */
+export declare function useInternalClientInstance(): LDClient | null;

package/dist/flags/createToolbarFlagFunction.d.ts

@@ -0,0 +1,17 @@
+import type { LDClient } from 'launchdarkly-js-client-sdk';
+/**
+ * Sets the internal client. Called during initialization.
+ */
+export declare function setToolbarFlagClient(client: LDClient | null): void;
+/**
+ * Gets the current internal client.
+ */
+export declare function getToolbarFlagClient(): LDClient | null;
+/**
+ * Creates a function that returns the value of a toolbar feature flag.
+ *
+ * @param flagKey - The LaunchDarkly flag key
+ * @param defaultValue - Default value if client isn't initialized or flag doesn't exist
+ * @returns A function that returns the current flag value
+ */
+export declare function createToolbarFlagFunction<T>(flagKey: string, defaultValue: T): () => T;

package/dist/flags/index.d.ts

@@ -0,0 +1,2 @@
+export * from './toolbarFlags';
+export { createToolbarFlagFunction, getToolbarFlagClient, setToolbarFlagClient } from './createToolbarFlagFunction';

package/dist/flags/toolbarFlags.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Toolbar feature flags
+ *
+ * These flags control features within the toolbar itself using the toolbar's
+ * internal LaunchDarkly client (not the user's application client).
+ *
+ * To add a toolbar feature flag, export it here like:
+ * export const myFeature = createToolbarFlagFunction('my-feature-key', defaultValue);
+ */
+export declare const __placeholder: () => boolean;

package/dist/index.cjs

@@ -553,7 +553,7 @@ async function lazyLoad(signal, url) {
     }
 }
 var package_namespaceObject = {
-    rE: "1.3.1"
+    rE: "1.4.1"
 };
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;

package/dist/js/index.js

@@ -519,7 +519,7 @@ async function lazyLoad(signal, url) {
     }
 }
 var package_namespaceObject = {
-    rE: "1.3.1"
+    rE: "1.4.1"
 };
 function useLaunchDarklyToolbar(args) {
     const { toolbarBundleUrl, enabled, ...initConfig } = args;

package/dist/types/constants.d.ts

@@ -0,0 +1 @@
+export declare const TOOLBAR_DOM_ID = "ld-toolbar";

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@launchdarkly/toolbar",
-  "version": "1.3.1",
+  "version": "1.4.1",
   "description": "A React component that provides a developer-friendly toolbar for interacting with LaunchDarkly during development",
   "keywords": [
     "launchdarkly",
@@ -51,30 +51,30 @@
     "@codemirror/language": "^6.11.3",
     "@codemirror/lint": "^6.9.2",
     "@codemirror/state": "^6.5.2",
-    "@codemirror/view": "^6.38.6",
+    "@codemirror/view": "^6.38.8",
     "@launchpad-ui/components": "^0.17.5",
     "@launchpad-ui/tokens": "^0.15.1",
     "@lezer/highlight": "^1.2.3",
     "@react-aria/focus": "^3.21.2",
     "@react-stately/flags": "^3.1.2",
-    "@rsbuild/core": "^1.6.6",
+    "@rsbuild/core": "^1.6.7",
     "@rsbuild/plugin-react": "^1.4.2",
-    "@rslib/core": "^0.17.0",
-    "@storybook/addon-docs": "^10.0.7",
+    "@rslib/core": "^0.18.0",
+    "@storybook/addon-docs": "^10.0.8",
     "@storybook/addon-essentials": "^9.0.0-alpha.12",
     "@storybook/addon-interactions": "^9.0.0-alpha.10",
-    "@storybook/addon-links": "^10.0.7",
-    "@storybook/addon-onboarding": "^10.0.7",
+    "@storybook/addon-links": "^10.0.8",
+    "@storybook/addon-onboarding": "^10.0.8",
     "@storybook/blocks": "^9.0.0-alpha.17",
-    "@storybook/react": "^10.0.7",
-    "@storybook/react-vite": "^9.0.5",
+    "@storybook/react": "^10.0.8",
+    "@storybook/react-vite": "^10.0.8",
     "@storybook/test": "^9.0.0-alpha.2",
     "@tanstack/react-virtual": "^3.13.12",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^24.10.1",
     "@types/react": "19.2.4",
-    "@types/react-dom": "19.2.2",
+    "@types/react-dom": "19.2.3",
     "@vanilla-extract/css": "^1.17.4",
     "@vanilla-extract/vite-plugin": "^5.1.1",
     "@vanilla-extract/webpack-plugin": "^2.3.22",
@@ -83,14 +83,14 @@
     "jsdom": "^27.2.0",
     "launchdarkly-js-client-sdk": "^3.9.0",
     "motion": "^12.19.2",
-    "oxlint": "^1.24.0",
+    "oxlint": "^1.29.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "storybook": "^9.1.16",
-    "storybook-addon-rslib": "^2.1.4",
-    "storybook-react-rsbuild": "^2.1.4",
+    "storybook": "^10.0.8",
+    "storybook-addon-rslib": "^2.1.6",
+    "storybook-react-rsbuild": "^2.1.6",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.8"
+    "vitest": "^4.0.12"
   },
   "peerDependencies": {
     "launchdarkly-js-client-sdk": ">=3.9.0 <4.0.0",