@graphysdk/react 1.9.0-beta.1792146771330 → 1.9.0-beta.1792149244850

package/README.md

@@ -60,6 +60,16 @@ const spec = pipe(
 );
 ```
 
+## Chart count
+
+Production browser builds send one anonymous count the first time a chart appears. The count includes the chart type and similar flags. It does not include cell values, column names, or labels. Development builds print one console line and send nothing.
+
+```tsx
+<GraphProvider data={data} spec={spec} telemetry={false}>
+  <GraphRenderer />
+</GraphProvider>
+```
+
 ## Custom geoms
 
 Plugin authoring uses the same package. `Geom`, the value readers, `defineGeomRenderer`, and `createGraphyKit` are all exported from `@graphysdk/react` — there is no need to add `@graphysdk/viz-engine` or `@graphysdk/react-renderer` as direct dependencies.

package/dist/chart-telemetry.d.ts

@@ -0,0 +1,14 @@
+import { ChartShape } from '@graphysdk/telemetry';
+interface PostChartCreatedOptions {
+    dsn?: string;
+    fetchImpl?: typeof fetch;
+    version?: string;
+}
+/** The address baked into this build. A function so tests can stand in a real DSN without a publish. */
+export declare function getChartCountDsn(): string;
+export declare function canSendChartCount(nodeEnv: string | undefined, hasWindow: boolean, dsn: string): boolean;
+/** Once per page. The caller only invokes this in development. */
+export declare function noteChartCountInDevelopment(): void;
+export declare function resetChartCountNotice(): void;
+export declare function postChartCreated(shape: ChartShape, options?: PostChartCreatedOptions): void;
+export {};

package/dist/create-graphy-kit.d.ts

@@ -1,6 +1,13 @@
-import { CreateGraphyKitOptions, GraphyKit } from '@graphysdk/react-renderer';
+import { ReactElement } from 'react';
+import { CreateGraphyKitOptions, GraphProviderProps, GraphyKit } from '@graphysdk/react-renderer';
 import { Plugin } from '@graphysdk/viz-engine';
+import { ChartCountProps } from './use-chart-telemetry';
+type KitProviderProps = Omit<GraphProviderProps, 'plugins' | 'theme'> & ChartCountProps;
+type ReactGraphyKit<P extends readonly Plugin[]> = Omit<GraphyKit<P>, 'GraphProvider'> & {
+    GraphProvider: (props: KitProviderProps) => ReactElement;
+};
 /**
  * Enables "Made with Graphy" by default. Explicit opt-outs still win.
  */
-export declare function createGraphyKit<const P extends readonly Plugin[] = []>(options?: CreateGraphyKitOptions<P>): GraphyKit<P>;
+export declare function createGraphyKit<const P extends readonly Plugin[] = []>(options?: CreateGraphyKitOptions<P>): ReactGraphyKit<P>;
+export {};