@fjader/svelte 0.2.3 → 0.2.4

package/dist/types.d.ts

@@ -4,6 +4,8 @@ import type { ChartConfig } from './config/ChartConfig.svelte';
 import type { DimValue } from './query-engine/categorical-identity';
 import type { AutoBinNode } from './sql/bin';
 import type { SelectionResponse } from './components/rendering/activity-reads';
+/** What a mark does with NULL in its categorical channels; see BaseMarkProps.nulls. */
+export type NullsResponse = 'keep' | 'drop';
 import type { RollingAvgNode } from './sql/rolling-avg';
 export type ContinuousScaleType = 'linear' | 'log' | 'symlog' | 'pow' | 'identity';
 export type DiscreteScaleType = 'band' | 'point';
@@ -58,6 +60,13 @@ export interface SqlTransform {
     apply(query: SelectQuery, config?: MarkConfig): SelectQuery;
     /** Channel aliases this transform adds to the result beyond the base select (e.g. stack's y0/y1). */
     channels?: string[];
+    /**
+     * The row predicate this transform adds to the query, when that is all it does
+     * (`filter`). It applies to the source rows, before any grouping, so a query
+     * over a pre-aggregated table cannot apply it (the columns it names are gone):
+     * the table is built with it instead, and the read leaves it out.
+     */
+    where?: unknown;
     /**
      * The channels whose values identify each row, leading term first, when this
      * transform guarantees exactly one row per combination of them — or null when
@@ -104,6 +113,11 @@ export interface ChannelIdentity {
      * when dense() pads from the whole dim as it did before.
      */
     present?: string;
+    /**
+     * The NULL category's id, when the mark drops NULL (`nulls="drop"`): `dense()`
+     * pads no row for it, as its rows are filtered out.
+     */
+    dropNullId?: number;
 }
 export interface MarkConfig {
     markType: string;
@@ -196,6 +210,33 @@ export interface BaseMarkProps {
      * own chart, so the marks under it do not move while it is dragged.
      */
     selectionResponse?: SelectionResponse;
+    /**
+     * Whether this mark adds its categories to a band axis's domain (default
+     * `true`). `false`: the mark follows the axis the other marks on it decide
+     * (their categories, their order); rows of categories the axis does not show
+     * are not drawn. For a layer that gives context to another, such as the whole
+     * behind a part. It cannot rank or reduce its own categories, so `topN`, `sort`
+     * and an explicit `domain` are refused with it (an error is logged and the
+     * mark contributes).
+     *
+     * Known limit: when the axis shows an Other bucket (another mark's topN with
+     * `includeOthers`), a follower has no Other row of its own. Its bars of
+     * categories that leave the axis walk to Other's slot and are gone when the
+     * transition ends, and nothing draws the whole behind Other. Folding such
+     * categories into an Other row would need the follower's query to depend on
+     * the axis's current categories.
+     */
+    contributeDomain?: boolean;
+    /**
+     * What this mark does with NULL in its categorical channels: its band axis,
+     * ordinal colour, series and facet.
+     *
+     * - `'keep'` (the default): NULL is a category like any other. It is ranked
+     *   by its measure, drawn, and labelled "(null)", in the null colour.
+     * - `'drop'`: rows whose value in any of those channels is NULL are left out
+     *   before any transform, so a top N ranks, and Other sums, without them.
+     */
+    nulls?: NullsResponse;
     scheme?: ColorScheme;
     limit?: number;
     transforms?: Transform[];

package/package.json

@@ -18,7 +18,7 @@
 		"type": "git",
 		"url": "git+https://github.com/dlyngman/fjader.git"
 	},
-	"version": "0.2.3",
+	"version": "0.2.4",
 	"type": "module",
 	"svelte": "./dist/index.js",
 	"exports": {
@@ -60,6 +60,7 @@
 		"@types/d3-color": "^3.1.3",
 		"@types/d3-scale": "^4.0.9",
 		"@types/d3-scale-chromatic": "^3.1.0",
+		"@uwdata/mosaic-sql": "^0.35.0",
 		"@webgpu/types": "^0.1.69",
 		"duckdb": "^1.4.4",
 		"eslint": "^10.0.0",
@@ -80,12 +81,12 @@
 		"vitest": "^4.0.18"
 	},
 	"peerDependencies": {
+		"@uwdata/mosaic-sql": "^0.34.2 || ^0.35.0",
 		"svelte": "^5.0.0"
 	},
 	"dependencies": {
 		"@duckdb/duckdb-wasm": "1.30.0",
 		"@uwdata/flechette": "2.3.0",
-		"@uwdata/mosaic-sql": "^0.34.2",
 		"d3-array": "^3.2.4",
 		"d3-color": "^3.1.0",
 		"d3-format": "^3.1.0",