@capillaryjs/capillary-viz 1.0.0-alpha.1

package/dist/lineChart.d.ts

@@ -0,0 +1,67 @@
+import type { CivilDate } from './dates.js';
+import type { HistoryShape } from './series.js';
+export interface LineGraphRange {
+    readonly minX?: CivilDate;
+    readonly maxX?: CivilDate;
+    readonly minY?: number;
+}
+export interface ChartPoint {
+    readonly date: CivilDate;
+    readonly day: number;
+    readonly value: number;
+    readonly baseValue: number;
+    readonly displayValue: number;
+    readonly x: number;
+    readonly y: number;
+    readonly baseY: number;
+}
+export interface ChartSeries {
+    readonly key: string;
+    readonly label: string;
+    readonly color: string;
+    readonly colorKey?: string;
+    readonly shape: HistoryShape;
+    readonly points: readonly ChartPoint[];
+}
+export interface DateMark {
+    readonly date: CivilDate;
+    readonly day: number;
+    readonly x: number;
+}
+export interface ValueTick {
+    readonly value: number;
+    readonly y: number;
+}
+export interface LineChartModel {
+    readonly minDate: CivilDate;
+    readonly maxDate: CivilDate;
+    readonly minDay: number;
+    readonly maxDay: number;
+    readonly minY: number;
+    readonly maxY: number;
+    readonly width: number;
+    readonly height: number;
+    readonly plotLeft: number;
+    readonly plotTop: number;
+    readonly plotWidth: number;
+    readonly plotHeight: number;
+    readonly stacked: boolean;
+    readonly series: readonly ChartSeries[];
+    readonly dateMarks: readonly DateMark[];
+    readonly valueTicks: readonly ValueTick[];
+}
+export interface LineChartOptions {
+    readonly stacked?: boolean;
+    readonly range?: LineGraphRange;
+    readonly width?: number;
+    readonly height?: number;
+    readonly maxDateMarks?: number;
+    readonly today?: CivilDate;
+}
+/** Calculate normalized, optionally stacked chart coordinates without a DOM. */
+export declare function buildLineChartModel(shapes: readonly HistoryShape[], options?: LineChartOptions): LineChartModel;
+export declare function valueAtDate(shape: HistoryShape, date: CivilDate): number;
+export declare function linePath(points: readonly ChartPoint[], smooth: boolean): string;
+export declare function areaPath(points: readonly ChartPoint[], smooth: boolean): string;
+export declare function buildIntegerTicks(minimum: number, maximum: number, target?: number): number[];
+//# sourceMappingURL=lineChart.d.ts.map

package/dist/lineChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineChart.d.ts","sourceRoot":"","sources":["../src/lineChart.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAA;AAE7C,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;CACzC;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAA;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,SAAS,EAAE,CAAA;CAC5C;AAED,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC7B;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,GAAE,gBAAqB,GAC/B,cAAc,CAoFhB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAExE;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAgB/E;AAED,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAkB/E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,EAAE,CAkBxF"}

package/dist/series.d.ts

@@ -0,0 +1,31 @@
+import type { Category } from './grouping.js';
+import type { CivilDate } from './dates.js';
+export interface HistoryShape {
+    readonly key: string;
+    readonly label: string;
+    readonly color: string;
+    readonly colorKey?: string;
+    readonly values: Readonly<Record<CivilDate, number>>;
+    /** Carry the latest earlier value into dates with no explicit point. */
+    readonly carryForward?: boolean;
+}
+export interface SeriesCategory {
+    readonly key: string;
+    readonly label: string;
+    readonly color: string;
+    readonly colorKey?: string;
+}
+/** Collect date/category deltas and build ordinary or cumulative history shapes. */
+export declare class SeriesBuilder {
+    private readonly categories;
+    private readonly byKey;
+    private readonly deltas;
+    constructor(categories: readonly SeriesCategory[] | readonly Category<unknown>[]);
+    addOne(date: CivilDate, categoryKey: string): this;
+    removeOne(date: CivilDate, categoryKey: string): this;
+    add(date: CivilDate, categoryKey: string, delta: number): this;
+    build(): readonly HistoryShape[];
+    buildCumulative(): readonly HistoryShape[];
+    private allDates;
+}
+//# sourceMappingURL=series.d.ts.map

package/dist/series.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"series.d.ts","sourceRoot":"","sources":["../src/series.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAA;AAM3C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,YAAY,CAAA;AAEzC,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAA;IACpD,wEAAwE;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,oFAAoF;AACpF,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2B;IACtD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4C;gBAEvD,UAAU,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,QAAQ,CAAC,OAAO,CAAC,EAAE;IAShF,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIlD,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIrD,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY9D,KAAK,IAAI,SAAS,YAAY,EAAE;IAUhC,eAAe,IAAI,SAAS,YAAY,EAAE;IAe1C,OAAO,CAAC,QAAQ;CAInB"}

package/dist/splits.d.ts

@@ -0,0 +1,43 @@
+import { Emitter } from '@capillaryjs/capillary';
+import type { ReadableEmitter } from '@capillaryjs/capillary';
+import type { CategoryVisibility, VisualizationValueEmitter } from './grouping.js';
+import { GroupingCriterion } from './grouping.js';
+export interface SplitPreset {
+    readonly key: string;
+    readonly label: string;
+    readonly active: readonly string[];
+    readonly inactive?: readonly string[];
+}
+/** Ordered split selection shared by controls, presets, and block models. */
+export declare class SplitSelectionModel<TItem> {
+    readonly criteria: readonly GroupingCriterion<TItem>[];
+    readonly presets: readonly SplitPreset[];
+    readonly order$: ReadableEmitter<readonly GroupingCriterion<TItem>[]>;
+    readonly activeSplits$: ReadableEmitter<readonly GroupingCriterion<TItem>[]>;
+    readonly activePreset$: Emitter<string | null>;
+    private readonly byKey;
+    private readonly state$;
+    private readonly orderEmitter;
+    private readonly activeSplitsEmitter;
+    private readonly activeEmitters;
+    private disposed;
+    constructor(criteria: readonly GroupingCriterion<TItem>[], options?: {
+        readonly active?: readonly string[];
+        readonly presets?: readonly SplitPreset[];
+    });
+    activeState(criterionKey: string): VisualizationValueEmitter<CategoryVisibility>;
+    isActive(criterionKey: string): boolean;
+    toggle(criterionKey: string, eventOrCause?: unknown): boolean;
+    move(criterionKey: string, targetIndex: number, eventOrCause?: unknown): boolean;
+    moveBy(criterionKey: string, offset: number, eventOrCause?: unknown): boolean;
+    setSplits(active: readonly string[], inactive?: readonly string[], eventOrCause?: unknown): boolean;
+    applyPreset(presetKey: string): boolean;
+    dispose(): void;
+    private requireKey;
+    private assertActive;
+}
+export declare function createSplitSelection<TItem>(criteria: readonly GroupingCriterion<TItem>[], options?: {
+    readonly active?: readonly string[];
+    readonly presets?: readonly SplitPreset[];
+}): SplitSelectionModel<TItem>;
+//# sourceMappingURL=splits.d.ts.map

package/dist/splits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splits.d.ts","sourceRoot":"","sources":["../src/splits.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAC3E,OAAO,KAAK,EAAsB,eAAe,EAAC,MAAM,wBAAwB,CAAA;AAEhF,OAAO,KAAK,EAAC,kBAAkB,EAAE,yBAAyB,EAAC,MAAM,eAAe,CAAA;AAChF,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAA;AAE/C,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAOD,6EAA6E;AAC7E,qBAAa,mBAAmB,CAAC,KAAK;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAA;IACtD,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IACxC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC,SAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACrE,QAAQ,CAAC,aAAa,EAAE,eAAe,CAAC,SAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAC5E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC9C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA+C;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG5B;IACD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGnC;IACD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAC9E,OAAO,CAAC,QAAQ,CAAQ;gBAGpB,QAAQ,EAAE,SAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAC7C,OAAO,GAAE;QACL,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;QACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;KACvC;IAgDV,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,yBAAyB,CAAC,kBAAkB,CAAC;IAWhF,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIvC,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO;IAc7D,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO;IAkBhF,MAAM,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO;IAU7E,SAAS,CACL,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,EAC5B,YAAY,CAAC,EAAE,OAAO,GACvB,OAAO;IAkBV,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASvC,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,YAAY;CAGvB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EACtC,QAAQ,EAAE,SAAS,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAC7C,OAAO,GAAE;IACL,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;CACvC,GACP,mBAAmB,CAAC,KAAK,CAAC,CAE5B"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "type": "module",
+  "name": "@capillaryjs/capillary-viz",
+  "private": false,
+  "version": "1.0.0-alpha.1",
+  "description": "Reactive analytical controls, block mosaics, and history charts for Capillary UI applications.",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "Sylwell Software",
+    "email": "npm@sylwellsoftware.com",
+    "url": "https://sylwellsoftware.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/capillaryjs/capillaryjs.git",
+    "directory": "packages/capillary-viz"
+  },
+  "homepage": "https://github.com/capillaryjs/capillaryjs#readme",
+  "bugs": {
+    "url": "https://github.com/capillaryjs/capillaryjs/issues"
+  },
+  "keywords": [
+    "charts",
+    "capillary-ui",
+    "reactive",
+    "treemap",
+    "typescript",
+    "visualization"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./styles/structural.css": "./styles/structural.css"
+  },
+  "files": [
+    "dist",
+    "styles",
+    "CHANGELOG.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "sideEffects": [
+    "./styles/*.css"
+  ],
+  "scripts": {
+    "build": "pnpm build:styles && vite build && tsc -p tsconfig.build.json",
+    "build:styles": "node --import tsx scripts/build-structural-css.mjs",
+    "prepack": "pnpm typecheck && pnpm test && pnpm build && pnpm test:types:consumer",
+    "test": "node --import tsx --test test/*.test.ts",
+    "test:types:consumer": "tsc -p test-types/consumer/tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "watch": "vite build --watch"
+  },
+  "peerDependencies": {
+    "@capillaryjs/capillary": "^1.0.0-alpha.1",
+    "@capillaryjs/capillary-ui": "^1.0.0-alpha.1"
+  },
+  "devDependencies": {
+    "@capillaryjs/capillary": "^1.0.0-alpha.1",
+    "@capillaryjs/capillary-ui": "^1.0.0-alpha.1",
+    "vite": "^6.3.5"
+  },
+  "engines": {
+    "node": ">=22",
+    "pnpm": ">=10"
+  },
+  "packageManager": "pnpm@10.11.0"
+}