@gem-sdk/analytic

GemX-specific analytic components, hooks, and types — extracted from gemx-shopify-app so they can be shared across repos (dev / staging apps, and future consumers).

Migration is incremental, bottom-up: pure types and helpers first, then leaf presentational charts, then the orchestration components. We do not move the whole feature at once — each slice is moved only after its dependencies already live here.

Status

| Slice | Source in app | Status | | --- | --- | --- | | types/chart | app/modules/page-analytic/modules/analytic/types/chart.ts | ✅ migrated |

Extraction order (planned)

1. Pure types / helpers — zero app coupling (types/chart, chart transform helpers).
2. Leaf charts — depend only on @shopify/polaris-viz + the types above (PAFunnelChart, PALineChartTooltip, PAPercent).
3. Shared foundations — decide per dependency whether to extract, inject, or keep: ~/types/metric, ~/core/gemxql types, design-system primitives.
4. Composite charts — PALineChart, PACardLineChart, PADonutChart, grids.
5. Orchestration — PageAnalyticDetail and providers (last; depends on everything).

Consuming from the app

The app consumes published dev versions (e.g. "@gem-sdk/analytic": "0.0.1-dev.x"), the same way it consumes @gem-sdk/heatmap-react. After migrating a slice:

yarn build && yarn changeset   # publish a dev version
# then bump the version in the app's package.json and rewire imports

@shopify/polaris-viz, @shopify/polaris-viz-core, react and react-dom are peerDependencies — provided by the consuming app, never bundled.