@gscdump/analysis 3.0.0 → 3.2.0

package/README.md

@@ -16,8 +16,11 @@ npm install @gscdump/analysis
 
 | Subpath | Use when |
 |---|---|
-| `@gscdump/analysis` | Top-level barrel: row analyzers, source-backed analyzers, `SQL_ANALYZERS`, `analyzeInBrowser`, `defaultAnalyzerRegistry`, contract types re-exported from engine. |
+| `@gscdump/analysis` | Pure analyzers, `analyzeInBrowser`, and shared analyzer contracts. |
 | `@gscdump/analysis/registry` | Pre-built `defaultAnalyzerRegistry` (rows + sql). Convenience for callers who don't care about bundle size. |
+| `@gscdump/analysis/errors` | Typed analysis failures and rendering helpers. |
+| `@gscdump/analysis/report` | Report registry and runtime. |
+| `@gscdump/analysis/source` | Portable source factories. |
 
 The contract layer (`Analyzer`, `Plan`, `Capability`, `AnalysisParams`, `AnalysisResult`, `AnalysisQuerySource`, `runAnalyzerFromSource`, `createAnalyzerRegistry`, `defineAnalyzer`, period helpers, `createEngineQuerySource`) lives in `@gscdump/engine` under the `/analyzer`, `/analysis-types`, `/period`, `/source`, and `/resolver` subpaths. Most are re-exported from `@gscdump/analysis` for convenience.
 
@@ -44,11 +47,11 @@ const decay = analyzeDecay(currentRows, previousRows)
 Meta-analyses live in the report layer. Run a composed evidence report via `runReport`:
 
 ```ts
+import { defaultAnalyzerRegistry } from '@gscdump/analysis/registry'
 import {
-  defaultAnalyzerRegistry,
   defaultReportRegistry,
   runReport,
-} from '@gscdump/analysis'
+} from '@gscdump/analysis/report'
 import { resolveWindow } from '@gscdump/engine/period'
 
 const report = defaultReportRegistry.getReport('health')!
@@ -76,7 +79,7 @@ const movers = await analyzeMoversFromSource(source, { current, previous })
 SQL-native path. `SQL_ANALYZERS` dispatch through `runAnalyzerFromSource` against an engine-backed source.
 
 ```ts
-import { ROW_ANALYZERS, SQL_ANALYZERS } from '@gscdump/analysis'
+import { ROW_ANALYZERS, SQL_ANALYZERS } from '@gscdump/analysis/registry'
 import { createAnalyzerRegistry, runAnalyzerFromSource } from '@gscdump/engine/analyzer'
 import { createEngineQuerySource } from '@gscdump/engine/source'
 
@@ -145,8 +148,8 @@ Available source factories:
 
 - `createGscApiQuerySource({ client, siteUrl })` — `@gscdump/engine-gsc-api`
 - `createLiveGscSource({ accessToken, siteUrl })` — `@gscdump/engine-gsc-api`
-- `createCompositeSource({ engine, gsc })` — `@gscdump/analysis`; engine first, GSC fallback
-- `createInMemoryQuerySource({ queryRows })` — `@gscdump/analysis`
+- `createCompositeSource({ engine, gsc })` — `@gscdump/analysis/source`; engine first, GSC fallback
+- `createInMemoryQuerySource({ queryRows })` — `@gscdump/analysis/source`
 - `createEngineQuerySource({ engine, ctx })` — `@gscdump/engine/source`
 - `createSqliteQuerySource({ ... })` — `@gscdump/engine-sqlite`
 
@@ -172,7 +175,7 @@ Presets: `last-7d`, `last-28d`, `last-30d`, `last-90d`, `last-180d`, `last-365d`
 | Row analyzers (`analyzeMovers`, `analyzeDecay`, ...) | Public |
 | Source factories + `analyzeFromSource` | Public |
 | `Analyzer<P, R>` contract + `createAnalyzerRegistry` (re-exported from `@gscdump/engine/analyzer`) | Public |
-| Source factories on the package root | Public |
+| Source factories under `@gscdump/analysis/source` | Public |
 | Per-analyzer modules under `analysis/src/analyzers/<name>` | Private |
 
 ## Related

package/dist/analyzer/all.mjs

@@ -1,32 +1,32 @@
-import { bayesianCtrAnalyzer } from "../analyzers/bayesian-ctr.mjs";
-import { bipartitePagerankAnalyzer } from "../analyzers/bipartite-pagerank.mjs";
 import { brandAnalyzer } from "../analyzers/brand.mjs";
 import { cannibalizationAnalyzer } from "../analyzers/cannibalization.mjs";
-import { changePointAnalyzer } from "../analyzers/change-point.mjs";
 import { clusteringAnalyzer } from "../analyzers/clustering.mjs";
 import { concentrationAnalyzer } from "../analyzers/concentration.mjs";
+import { decayAnalyzer } from "../analyzers/decay.mjs";
+import { moversAnalyzer } from "../analyzers/movers.mjs";
+import { opportunityAnalyzer } from "../analyzers/opportunity.mjs";
+import { seasonalityAnalyzer } from "../analyzers/seasonality.mjs";
+import { strikingDistanceAnalyzer } from "../analyzers/striking-distance.mjs";
+import { zeroClickAnalyzer } from "../analyzers/zero-click.mjs";
+import { bayesianCtrAnalyzer } from "../analyzers/bayesian-ctr.mjs";
+import { bipartitePagerankAnalyzer } from "../analyzers/bipartite-pagerank.mjs";
+import { changePointAnalyzer } from "../analyzers/change-point.mjs";
 import { contentVelocityAnalyzer } from "../analyzers/content-velocity.mjs";
 import { ctrAnomalyAnalyzer } from "../analyzers/ctr-anomaly.mjs";
 import { ctrCurveAnalyzer } from "../analyzers/ctr-curve.mjs";
 import { darkTrafficAnalyzer } from "../analyzers/dark-traffic.mjs";
 import { dataDetailAnalyzer } from "../analyzers/data-detail.mjs";
 import { dataQueryAnalyzer } from "../analyzers/data-query.mjs";
-import { decayAnalyzer } from "../analyzers/decay.mjs";
 import { deviceGapAnalyzer } from "../analyzers/device-gap.mjs";
 import { intentAtlasAnalyzer } from "../analyzers/intent-atlas.mjs";
 import { keywordBreadthAnalyzer } from "../analyzers/keyword-breadth.mjs";
 import { longTailAnalyzer } from "../analyzers/long-tail.mjs";
-import { moversAnalyzer } from "../analyzers/movers.mjs";
-import { opportunityAnalyzer } from "../analyzers/opportunity.mjs";
 import { positionDistributionAnalyzer } from "../analyzers/position-distribution.mjs";
 import { positionVolatilityAnalyzer } from "../analyzers/position-volatility.mjs";
 import { queryMigrationAnalyzer } from "../analyzers/query-migration.mjs";
-import { seasonalityAnalyzer } from "../analyzers/seasonality.mjs";
 import { stlDecomposeAnalyzer } from "../analyzers/stl-decompose.mjs";
-import { strikingDistanceAnalyzer } from "../analyzers/striking-distance.mjs";
 import { survivalAnalyzer } from "../analyzers/survival.mjs";
 import { trendsAnalyzer } from "../analyzers/trends.mjs";
-import { zeroClickAnalyzer } from "../analyzers/zero-click.mjs";
 const ALL_ANALYZERS = [
 	bayesianCtrAnalyzer,
 	bipartitePagerankAnalyzer,

package/dist/analyzers/bipartite-pagerank.mjs

@@ -1,8 +1,8 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const BIPARTITE_PAGERANK_ITERATIONS = 25;
 const BIPARTITE_PAGERANK_DAMPING = .85;
 const bipartitePagerankAnalyzer = defineAnalyzer({

package/dist/analyzers/brand.mjs

@@ -1,11 +1,11 @@
-import { rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { rowString } from "../analyzer/row-values.mjs";
 import { analysisErrorToException, analysisErrors } from "../errors.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { err, ok, unwrapResult } from "gscdump/result";
 function escapeRegexAlt(s) {
 	return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");

package/dist/analyzers/cannibalization.mjs

@@ -1,11 +1,11 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { createSorter } from "../types.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const sortRowResults = createSorter((item, metric) => {
 	switch (metric) {
 		case "clicks": return item.totalClicks;

package/dist/analyzers/clustering.mjs

@@ -1,10 +1,10 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const INTENT_PREFIXES_REGEX = "^(how to|what is|what are|why is|why do|where to|when to|best|top|vs|versus|compare|review|buy|cheap|free|near me)(\\s|$)";
 const INTENT_PREFIXES = [
 	"how to",

package/dist/analyzers/concentration.mjs

@@ -1,10 +1,10 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { pagesQueryState, queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 function analyzeConcentration(items, options = {}) {
 	const { topN = 10 } = options;
 	if (items.length === 0) return {

package/dist/analyzers/dark-traffic.mjs

@@ -1,8 +1,8 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const darkTrafficAnalyzer = defineAnalyzer({
 	id: "dark-traffic",
 	buildSql(params) {

package/dist/analyzers/decay.mjs

@@ -1,12 +1,12 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { pagesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { buildPeriodMap, createMetricSorter } from "../types.mjs";
 import { paginateInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { comparisonOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const sortResults = createMetricSorter("lostClicks", {
 	lostClicks: "desc",
 	declinePercent: "desc",

package/dist/analyzers/device-gap.mjs

@@ -1,8 +1,8 @@
 import { rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const deviceGapAnalyzer = defineAnalyzer({
 	id: "device-gap",
 	buildSql(params) {

package/dist/analyzers/intent-atlas.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { daysAgoUtc } from "gscdump/dates";
 const INTENT_ATLAS_STOP_WORDS = [
 	"the",

package/dist/analyzers/keyword-breadth.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const keywordBreadthAnalyzer = defineAnalyzer({
 	id: "keyword-breadth",
 	buildSql(params) {

package/dist/analyzers/long-tail.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 function downsampleLogRank(points) {
 	const toPoint = (p) => ({
 		rank: num(p.rank),

package/dist/analyzers/movers.mjs

@@ -1,12 +1,12 @@
-import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
+import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
 import { buildPeriodMap } from "../types.mjs";
 import { percentDifference } from "../scoring.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { comparisonOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 function withCanonicalFields(r) {
 	return {
 		...r,

package/dist/analyzers/opportunity.mjs

@@ -1,10 +1,10 @@
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
 import { paginateClause, paginateSortedInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const EXPECTED_CTR_BY_POSITION = {
 	1: .3,
 	2: .15,

package/dist/analyzers/position-distribution.mjs

@@ -1,8 +1,8 @@
 import { rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const positionDistributionAnalyzer = defineAnalyzer({
 	id: "position-distribution",
 	buildSql(params) {

package/dist/analyzers/position-volatility.mjs

@@ -1,9 +1,9 @@
 import { rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 const positionVolatilityAnalyzer = defineAnalyzer({
 	id: "position-volatility",
 	buildSql(params) {

package/dist/analyzers/query-migration.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { MS_PER_DAY, toIsoDate } from "gscdump/dates";
 const queryMigrationAnalyzer = defineAnalyzer({
 	id: "query-migration",

package/dist/analyzers/seasonality.mjs

@@ -1,9 +1,9 @@
-import { rowBoolean, rowString } from "../analyzer/row-values.mjs";
 import { datesQueryState } from "../analyzer/adapt-rows.mjs";
+import { rowBoolean, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 function calculateCV(values) {
 	if (values.length === 0) return 0;
 	const mean = values.reduce((a, b) => a + b, 0) / values.length;

package/dist/analyzers/stl-decompose.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowBoolean, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { daysAgoUtc } from "gscdump/dates";
 const stlDecomposeAnalyzer = defineAnalyzer({
 	id: "stl-decompose",

package/dist/analyzers/striking-distance.mjs

@@ -1,9 +1,9 @@
 import { queriesQueryState } from "../analyzer/adapt-rows.mjs";
 import { paginateSortedInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
-import { num } from "@gscdump/engine/analysis-types";
 const DEFAULT_ROW_LIMIT = 25e3;
 function paginateStrikingDistance(results, options) {
 	return paginateSortedInMemory(results, {

package/dist/analyzers/survival.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { MS_PER_DAY, daysAgoUtc } from "gscdump/dates";
 const survivalAnalyzer = defineAnalyzer({
 	id: "survival",

package/dist/analyzers/trends.mjs

@@ -1,9 +1,9 @@
 import { parseJsonRows, rowString } from "../analyzer/row-values.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { defaultEndDate } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { MS_PER_DAY, toIsoDate } from "gscdump/dates";
 const trendsAnalyzer = defineAnalyzer({
 	id: "trends",

package/dist/analyzers/zero-click.mjs

@@ -1,9 +1,9 @@
 import { paginateClause, paginateSortedInMemory } from "../analyzer/paginate.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { defineAnalyzer } from "@gscdump/engine/analyzer";
 import { periodOf } from "@gscdump/engine/period";
 import { enumeratePartitions } from "@gscdump/engine/planner";
 import { METRIC_EXPR } from "@gscdump/engine/sql-fragments";
-import { num } from "@gscdump/engine/analysis-types";
 import { between, date, gsc, page, query } from "gscdump/query";
 const DEFAULT_ROW_LIMIT = 25e3;
 function analyzeZeroClick(rows, options = {}) {

package/dist/browser.d.mts

@@ -1,5 +1,5 @@
-import { AnalyzerRegistry } from "@gscdump/engine/analyzer";
 import { AnalysisParams, AnalysisResult } from "@gscdump/engine/analysis-types";
+import { AnalyzerRegistry } from "@gscdump/engine/analyzer";
 import { AttachedTableRunner, AttachedTableRunner as AnalyzerRunner, AttachedTableSourceOptions, AttachedTableSourceOptions as BrowserAnalyzeOptions } from "@gscdump/engine/source";
 declare function analyzeInBrowser(runner: AttachedTableRunner, opts: AttachedTableSourceOptions, params: AnalysisParams, registry: AnalyzerRegistry): Promise<AnalysisResult>;
 export { type AnalyzerRunner, type BrowserAnalyzeOptions, analyzeInBrowser };

package/dist/index.d.mts

@@ -1,7 +1,3 @@
-import { ROW_ANALYZERS } from "./analyzer/row-analyzers.mjs";
-import { SQL_ANALYZERS } from "./sql-analyzers.mjs";
-import { defaultAnalyzerRegistry } from "./default-registry.mjs";
-import { AnalysisError, AnalysisErrorKind, analysisErrorToException, analysisErrors, formatAnalysisError, isAnalysisError } from "./errors.mjs";
 import { BaseMetrics, DateRow, PageRow, QueriesRow, QueryPageRow, SortOrder, createSorter } from "./types.mjs";
 import { BrandSegmentationOptions, BrandSegmentationResult, BrandSegmentationRow, BrandSummary, analyzeBrandSegmentation } from "./analyzers/brand.mjs";
 import { CannibalizationCompetitor, CannibalizationEvent, CannibalizationOptions, CannibalizationPage, CannibalizationResult, CannibalizationSortMetric, analyzeCannibalization } from "./analyzers/cannibalization.mjs";
@@ -16,17 +12,10 @@ import { ZeroClickOptions, ZeroClickResult, analyzeZeroClick } from "./analyzers
 import { AnalyzerRunner, BrowserAnalyzeOptions, analyzeInBrowser } from "./browser.mjs";
 import { INTENT_CLASSIFIER_VERSION, IntentClassification, SEARCH_INTENT_CODE, SearchIntent, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
 import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
-import { FormatReportOptions, formatReport } from "./report/format.mjs";
-import { REPORTS, defaultReportRegistry } from "./report/registry.mjs";
-import { DryRunReportResult, RunReportOptions, dryRunReport, runReport, runReportResult } from "./report/runtime.mjs";
-import "./report/index.mjs";
 import { CurrentSitemapScope, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SitemapCollapsePolicy, SitemapCollapseState, SitemapDelta, SitemapHealthDiff, SitemapHealthInput, SitemapHealthRow, SitemapHealthTotals, classifySitemapCollapse, compareCurrentSitemapScope, diffSitemapHealth, sitemapHistoryHasCollapse } from "./sitemap-health.mjs";
-import { CompositeSourceOptions, createCompositeSource } from "./source/composite.mjs";
-import { IN_MEMORY_DEFAULT_CAPABILITIES, InMemoryQuerySourceOptions, createInMemoryQuerySource } from "./source/in-memory.mjs";
-import "./source/index.mjs";
+import { AnalysisParams, AnalysisResult, AnalysisTool, num } from "@gscdump/engine/analysis-types";
 import { Analyzer, AnalyzerCapabilityError, AnalyzerRegistry, AnalyzerRegistryInit, AnalyzerVariants, DefineAnalyzerOptions, DefinedAnalyzer, Plan, ReduceContext, ReduceCtx, Reducer, RequiredCapability, RowQueriesPlan, SqlExtraQuery, SqlPlan, SqlPlanSpec, TypedRowQuery, createAnalyzerRegistry, defineAnalyzer, runAnalyzerFromSource } from "@gscdump/engine/analyzer";
 import { AnalysisPeriod, ComparisonMode, ComparisonPeriod, PadTimeseriesOptions, ResolveWindowOptions, ResolvedWindow, WindowPreset, comparisonOf, padTimeseries, periodOf, resolveWindow } from "@gscdump/engine/period";
-import { AnalysisParams, AnalysisResult, AnalysisTool, num } from "@gscdump/engine/analysis-types";
 import { AnalysisQuerySource, AnalysisSourceKind, ENGINE_QUERY_CAPABILITIES, EngineQuerySourceOptions, ExecuteSqlOptions, FileSet, QueryRow, SourceCapabilities, createEngineQuerySource, queryRows, runAnalyzerWithEngine } from "@gscdump/engine/source";
 import { DefineReportOptions, DefinedReport, ReportContext, ReportFinding, ReportPlanStep, ReportResult, ReportSection } from "@gscdump/engine/report";
-export { type AnalysisError, type AnalysisErrorKind, type AnalysisParams, type AnalysisPeriod, type AnalysisQuerySource, type AnalysisResult, type AnalysisSourceKind, type AnalysisTool, type Analyzer, AnalyzerCapabilityError, type AnalyzerRegistry, type AnalyzerRegistryInit, type AnalyzerRunner, type AnalyzerVariants, type BaseMetrics, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSegmentationRow, type BrandSummary, type BrowserAnalyzeOptions, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ClusterType, type ClusteringOptions, type ClusteringResult, type ComparisonMode, type ComparisonPeriod, type CompositeSourceOptions, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, type CurrentSitemapScope, type DateRow, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DefineAnalyzerOptions, type DefineReportOptions, type DefinedAnalyzer, type DefinedReport, type DryRunReportResult, ENGINE_QUERY_CAPABILITIES, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, type FormatReportOptions, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, type InMemoryQuerySourceOptions, type IntentClassification, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, NORMALIZER_VERSION, type OpportunityFactors, type OpportunityOptions, type OpportunityResult, type OpportunitySortMetric, type OpportunityWeights, type PadTimeseriesOptions, type PageRow, type Plan, type QueriesRow, type QueryPageRow, type QueryRow, REPORTS, ROW_ANALYZERS, type ReduceContext, type ReduceCtx, type Reducer, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, type RunReportOptions, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SQL_ANALYZERS, type SearchIntent, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type SitemapCollapsePolicy, type SitemapCollapseState, type SitemapDelta, type SitemapHealthDiff, type SitemapHealthInput, type SitemapHealthRow, type SitemapHealthTotals, type SortOrder, type SourceCapabilities, type SqlExtraQuery, type SqlPlan, type SqlPlanSpec, type StrikingDistanceInputRow, type StrikingDistanceOptions, type StrikingDistanceResult, type TypedRowQuery, type WindowPreset, type ZeroClickOptions, type ZeroClickResult, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, sitemapHistoryHasCollapse };
+export { type AnalysisParams, type AnalysisPeriod, type AnalysisQuerySource, type AnalysisResult, type AnalysisSourceKind, type AnalysisTool, type Analyzer, AnalyzerCapabilityError, type AnalyzerRegistry, type AnalyzerRegistryInit, type AnalyzerRunner, type AnalyzerVariants, type BaseMetrics, type BrandSegmentationOptions, type BrandSegmentationResult, type BrandSegmentationRow, type BrandSummary, type BrowserAnalyzeOptions, type CannibalizationCompetitor, type CannibalizationEvent, type CannibalizationOptions, type CannibalizationPage, type CannibalizationResult, type CannibalizationSortMetric, type ClusterType, type ClusteringOptions, type ClusteringResult, type ComparisonMode, type ComparisonPeriod, type ConcentrationInput, type ConcentrationItem, type ConcentrationOptions, type ConcentrationResult, type ConcentrationRiskLevel, type CurrentSitemapScope, type DateRow, type DecayInput, type DecayOptions, type DecayResult, type DecaySeriesPoint, type DecaySortMetric, type DefineAnalyzerOptions, type DefineReportOptions, type DefinedAnalyzer, type DefinedReport, ENGINE_QUERY_CAPABILITIES, type EngineQuerySourceOptions, type ExecuteSqlOptions, type FileSet, INTENT_CLASSIFIER_VERSION, type IntentClassification, type KeywordCluster, type MonthlyData, type MoverData, type MoversInput, type MoversOptions, type MoversResult, type MoversSortMetric, NORMALIZER_VERSION, type OpportunityFactors, type OpportunityOptions, type OpportunityResult, type OpportunitySortMetric, type OpportunityWeights, type PadTimeseriesOptions, type PageRow, type Plan, type QueriesRow, type QueryPageRow, type QueryRow, type ReduceContext, type ReduceCtx, type Reducer, type ReportContext, type ReportFinding, type ReportPlanStep, type ReportResult, type ReportSection, type RequiredCapability, type ResolveWindowOptions, type ResolvedWindow, type RowQueriesPlan, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, type SearchIntent, type SeasonalityMetric, type SeasonalityOptions, type SeasonalityResult, type SitemapCollapsePolicy, type SitemapCollapseState, type SitemapDelta, type SitemapHealthDiff, type SitemapHealthInput, type SitemapHealthRow, type SitemapHealthTotals, type SortOrder, type SourceCapabilities, type SqlExtraQuery, type SqlPlan, type SqlPlanSpec, type StrikingDistanceInputRow, type StrikingDistanceOptions, type StrikingDistanceResult, type TypedRowQuery, type WindowPreset, type ZeroClickOptions, type ZeroClickResult, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createEngineQuerySource, createSorter, defineAnalyzer, diffSitemapHealth, encodeIntent, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, sitemapHistoryHasCollapse };

package/dist/index.mjs

@@ -1,31 +1,20 @@
-import { analysisErrorToException, analysisErrors, formatAnalysisError, isAnalysisError } from "./errors.mjs";
 import { analyzeBrandSegmentation } from "./analyzers/brand.mjs";
 import { createSorter } from "./types.mjs";
 import { analyzeCannibalization } from "./analyzers/cannibalization.mjs";
 import { analyzeClustering } from "./analyzers/clustering.mjs";
 import { analyzeConcentration, analyzeKeywordConcentration, analyzePageConcentration } from "./analyzers/concentration.mjs";
-import { INTENT_CLASSIFIER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
-import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
 import { analyzeDecay } from "./analyzers/decay.mjs";
 import { analyzeMovers } from "./analyzers/movers.mjs";
 import { analyzeOpportunity } from "./analyzers/opportunity.mjs";
 import { analyzeSeasonality } from "./analyzers/seasonality.mjs";
 import { analyzeStrikingDistance } from "./analyzers/striking-distance.mjs";
 import { analyzeZeroClick } from "./analyzers/zero-click.mjs";
-import { ROW_ANALYZERS } from "./analyzer/row-analyzers.mjs";
 import { analyzeInBrowser } from "./browser.mjs";
-import { SQL_ANALYZERS } from "./sql-analyzers.mjs";
-import { defaultAnalyzerRegistry } from "./default-registry.mjs";
-import { formatReport } from "./report/format.mjs";
-import { REPORTS, defaultReportRegistry } from "./report/registry.mjs";
-import { dryRunReport, runReport, runReportResult } from "./report/runtime.mjs";
-import "./report/index.mjs";
+import { INTENT_CLASSIFIER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
+import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
 import { SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, classifySitemapCollapse, compareCurrentSitemapScope, diffSitemapHealth, sitemapHistoryHasCollapse } from "./sitemap-health.mjs";
-import { createCompositeSource } from "./source/composite.mjs";
-import { IN_MEMORY_DEFAULT_CAPABILITIES, createInMemoryQuerySource } from "./source/in-memory.mjs";
-import "./source/index.mjs";
+import { num } from "@gscdump/engine/analysis-types";
 import { AnalyzerCapabilityError, createAnalyzerRegistry, defineAnalyzer, runAnalyzerFromSource } from "@gscdump/engine/analyzer";
 import { comparisonOf, padTimeseries, periodOf, resolveWindow } from "@gscdump/engine/period";
-import { num } from "@gscdump/engine/analysis-types";
 import { ENGINE_QUERY_CAPABILITIES, createEngineQuerySource, queryRows, runAnalyzerWithEngine } from "@gscdump/engine/source";
-export { AnalyzerCapabilityError, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, IN_MEMORY_DEFAULT_CAPABILITIES, NORMALIZER_VERSION, REPORTS, ROW_ANALYZERS, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, SQL_ANALYZERS, analysisErrorToException, analysisErrors, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createCompositeSource, createEngineQuerySource, createInMemoryQuerySource, createSorter, defaultAnalyzerRegistry, defaultReportRegistry, defineAnalyzer, diffSitemapHealth, dryRunReport, encodeIntent, formatAnalysisError, formatReport, isAnalysisError, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, runReport, runReportResult, sitemapHistoryHasCollapse };
+export { AnalyzerCapabilityError, ENGINE_QUERY_CAPABILITIES, INTENT_CLASSIFIER_VERSION, NORMALIZER_VERSION, SEARCH_INTENT_CODE, SITEMAP_SYNC_COLLAPSE_POLICY, SITEMAP_TRUST_COLLAPSE_POLICY, analyzeBrandSegmentation, analyzeCannibalization, analyzeClustering, analyzeConcentration, analyzeDecay, analyzeInBrowser, analyzeKeywordConcentration, analyzeMovers, analyzeOpportunity, analyzePageConcentration, analyzeSeasonality, analyzeStrikingDistance, analyzeZeroClick, classifyQueryIntent, classifySitemapCollapse, compareCurrentSitemapScope, comparisonOf, createAnalyzerRegistry, createEngineQuerySource, createSorter, defineAnalyzer, diffSitemapHealth, encodeIntent, normalizeQuery, num, padTimeseries, periodOf, queryRows, resolveWindow, runAnalyzerFromSource, runAnalyzerWithEngine, sitemapHistoryHasCollapse };

package/dist/query/index.mjs

@@ -1,4 +1,4 @@
-import { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows } from "./analyzers.mjs";
 import "./intent.mjs";
 import "./normalize.mjs";
+import { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows } from "./analyzers.mjs";
 export { buildDataDetailPlan, buildDataDetailRows, buildDataQueryPlan, buildDataQueryRows, shapeDataDetailRowResults, shapeDataDetailRows, shapeDataQueryRowResults, shapeDataQueryRows };

package/dist/query-dimension.d.mts

@@ -0,0 +1,3 @@
+import { INTENT_CLASSIFIER_VERSION, IntentClassification, SEARCH_INTENT_CODE, SearchIntent, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
+import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
+export { INTENT_CLASSIFIER_VERSION, type IntentClassification, NORMALIZER_VERSION, SEARCH_INTENT_CODE, type SearchIntent, classifyQueryIntent, encodeIntent, normalizeQuery };

package/dist/query-dimension.mjs

@@ -0,0 +1,3 @@
+import { INTENT_CLASSIFIER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent } from "./query/intent.mjs";
+import { NORMALIZER_VERSION, normalizeQuery } from "./query/normalize.mjs";
+export { INTENT_CLASSIFIER_VERSION, NORMALIZER_VERSION, SEARCH_INTENT_CODE, classifyQueryIntent, encodeIntent, normalizeQuery };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gscdump/analysis",
   "type": "module",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "description": "GSC analyzers — striking-distance, opportunity, movers, decay, brand, clustering, concentration, seasonality. Pure row-based + DuckDB-native.",
   "author": {
     "name": "Harlan Wilton",
@@ -36,6 +36,11 @@
       "import": "./dist/errors.mjs",
       "default": "./dist/errors.mjs"
     },
+    "./query-dimension": {
+      "types": "./dist/query-dimension.d.mts",
+      "import": "./dist/query-dimension.mjs",
+      "default": "./dist/query-dimension.mjs"
+    },
     "./report": {
       "types": "./dist/report/index.d.mts",
       "import": "./dist/report/index.mjs",
@@ -57,9 +62,9 @@
   },
   "dependencies": {
     "pluralize": "^8.0.0",
-    "@gscdump/engine": "^3.0.0",
-    "@gscdump/engine-gsc-api": "^3.0.0",
-    "gscdump": "^3.0.0"
+    "@gscdump/engine": "^3.2.0",
+    "@gscdump/engine-gsc-api": "^3.2.0",
+    "gscdump": "^3.2.0"
   },
   "devDependencies": {
     "vitest": "^4.1.10"