@asymmetric-effort/specifyjs 0.2.98 → 0.2.100

package/dist/types/components/viz/matrix/src/Matrix.d.ts

@@ -0,0 +1,29 @@
+export interface MatrixProps {
+    /** 2D grid of values — data[row][col] */
+    data: number[][];
+    /** Shared row/column labels for square matrices */
+    labels?: string[];
+    /** Explicit row labels (overrides `labels`) */
+    rowLabels?: string[];
+    /** Explicit column labels (overrides `labels`) */
+    columnLabels?: string[];
+    /** SVG width in pixels (default: 500) */
+    width?: number;
+    /** SVG height in pixels (default: 500) */
+    height?: number;
+    /** Color gradient from low to high (default: white to blue) */
+    colorScale?: string[];
+    /** Show numeric value in each cell (default: true) */
+    showValues?: boolean;
+    /** Highlight diagonal cells (default: true) */
+    showDiagonal?: boolean;
+    /** Cell border color (default: '#e5e7eb') */
+    cellBorderColor?: string;
+    /** Chart title */
+    title?: string;
+    /** Padding around the chart in px (default: 70) */
+    padding?: number;
+    /** If true, mirror values across diagonal for correlation matrices (default: false) */
+    symmetric?: boolean;
+}
+export declare function Matrix(props: MatrixProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/matrix/src/index.d.ts

@@ -0,0 +1,2 @@
+export { Matrix } from './Matrix';
+export type { MatrixProps } from './Matrix';

package/dist/types/components/viz/partition/src/Partition.d.ts

@@ -0,0 +1,31 @@
+export interface PartitionNode {
+    label: string;
+    value?: number;
+    color?: string;
+    children?: PartitionNode[];
+}
+export interface PartitionProps {
+    /** Root node of the partition data */
+    data: PartitionNode;
+    /** SVG width in pixels (default: 600) */
+    width?: number;
+    /** SVG height in pixels (default: 400) */
+    height?: number;
+    /** Layout orientation (default: 'horizontal') */
+    orientation?: 'horizontal' | 'vertical';
+    /** Show labels inside cells (default: true) */
+    showLabels?: boolean;
+    /** Show values inside cells (default: true) */
+    showValues?: boolean;
+    /** Color palette for cells without explicit color */
+    colors?: string[];
+    /** Border color around cells (default: '#ffffff') */
+    borderColor?: string;
+    /** Border width in px (default: 1) */
+    borderWidth?: number;
+    /** Chart title */
+    title?: string;
+    /** Padding around chart area in px (default: 10) */
+    padding?: number;
+}
+export declare function Partition(props: PartitionProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/partition/src/index.d.ts

@@ -0,0 +1,2 @@
+export { Partition } from './Partition';
+export type { PartitionProps, PartitionNode } from './Partition';

package/dist/types/components/viz/pivot-table/src/PivotTable.d.ts

@@ -0,0 +1,25 @@
+export interface PivotTableProps {
+    /** Array of data records */
+    data: Record<string, unknown>[];
+    /** Row dimension field names */
+    rows: string[];
+    /** Column dimension field names */
+    columns: string[];
+    /** Value field names to aggregate */
+    values: string[];
+    /** Aggregation function (default: 'sum') */
+    aggregation?: 'sum' | 'count' | 'avg' | 'min' | 'max';
+    /** SVG width in pixels (default: 600) */
+    width?: number;
+    /** SVG height in pixels (default: 400) */
+    height?: number;
+    /** Show totals row and column (default: true) */
+    showTotals?: boolean;
+    /** Chart title */
+    title?: string;
+    /** Header background color (default: '#3b82f6') */
+    headerColor?: string;
+    /** Cell padding in px (default: 8) */
+    cellPadding?: number;
+}
+export declare function PivotTable(props: PivotTableProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/pivot-table/src/index.d.ts

@@ -0,0 +1,2 @@
+export { PivotTable } from './PivotTable';
+export type { PivotTableProps } from './PivotTable';

package/dist/types/components/viz/radar-chart/src/RadarChart.d.ts

@@ -0,0 +1,35 @@
+export interface RadarAxis {
+    label: string;
+    max?: number;
+}
+export interface RadarSeries {
+    label: string;
+    values: number[];
+    color: string;
+    fillOpacity?: number;
+}
+export interface RadarChartProps {
+    /** Axes definition — one per spoke of the radar */
+    axes: RadarAxis[];
+    /** Data series to overlay on the chart */
+    series: RadarSeries[];
+    /** SVG width in pixels (default: 500) */
+    width?: number;
+    /** SVG height in pixels (default: 500) */
+    height?: number;
+    /** Number of concentric grid rings (default: 5) */
+    levels?: number;
+    /** Show axis labels around the perimeter (default: true) */
+    showLabels?: boolean;
+    /** Show value annotations at data points (default: false) */
+    showValues?: boolean;
+    /** Show legend (default: true) */
+    showLegend?: boolean;
+    /** Show dots at data points (default: true) */
+    showDots?: boolean;
+    /** Grid line color (default: '#d1d5db') */
+    gridColor?: string;
+    /** Chart title */
+    title?: string;
+}
+export declare function RadarChart(props: RadarChartProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/radar-chart/src/index.d.ts

@@ -0,0 +1,2 @@
+export { RadarChart } from './RadarChart';
+export type { RadarChartProps, RadarAxis, RadarSeries } from './RadarChart';

package/dist/types/components/viz/sankey/src/SankeyDiagram.d.ts

@@ -0,0 +1,38 @@
+export interface SankeyNode {
+    id: string;
+    label: string;
+    color?: string;
+}
+export interface SankeyLink {
+    source: string;
+    target: string;
+    value: number;
+    color?: string;
+}
+export interface SankeyDiagramProps {
+    /** Array of nodes */
+    nodes: SankeyNode[];
+    /** Array of links (flows) between nodes */
+    links: SankeyLink[];
+    /** SVG width in pixels (default: 800) */
+    width?: number;
+    /** SVG height in pixels (default: 500) */
+    height?: number;
+    /** Width of each node rectangle in pixels (default: 20) */
+    nodeWidth?: number;
+    /** Vertical padding between nodes in pixels (default: 10) */
+    nodePadding?: number;
+    /** Show node labels (default: true) */
+    showLabels?: boolean;
+    /** Show flow values on links (default: false) */
+    showValues?: boolean;
+    /** Link fill opacity 0..1 (default: 0.4) */
+    linkOpacity?: number;
+    /** Color palette for auto-coloring nodes */
+    colors?: string[];
+    /** Chart title */
+    title?: string;
+    /** Padding around chart area in px (default: 40) */
+    padding?: number;
+}
+export declare function SankeyDiagram(props: SankeyDiagramProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/sankey/src/index.d.ts

@@ -0,0 +1,2 @@
+export { SankeyDiagram } from './SankeyDiagram';
+export type { SankeyDiagramProps, SankeyNode, SankeyLink } from './SankeyDiagram';

package/dist/types/components/viz/sunburst/src/Sunburst.d.ts

@@ -0,0 +1,27 @@
+export interface SunburstNode {
+    label: string;
+    value?: number;
+    color?: string;
+    children?: SunburstNode[];
+}
+export interface SunburstProps {
+    /** Root node of the sunburst data */
+    data: SunburstNode;
+    /** SVG width in pixels (default: 500) */
+    width?: number;
+    /** SVG height in pixels (default: 500) */
+    height?: number;
+    /** Inner radius of the first ring (default: 40) */
+    innerRadius?: number;
+    /** Show labels on segments (default: true) */
+    showLabels?: boolean;
+    /** Color palette for segments without explicit color */
+    colors?: string[];
+    /** Stroke color between segments (default: '#ffffff') */
+    strokeColor?: string;
+    /** Stroke width between segments (default: 1) */
+    strokeWidth?: number;
+    /** Chart title */
+    title?: string;
+}
+export declare function Sunburst(props: SunburstProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/sunburst/src/index.d.ts

@@ -0,0 +1,2 @@
+export { Sunburst } from './Sunburst';
+export type { SunburstProps, SunburstNode } from './Sunburst';

package/dist/types/components/viz/tree-map/src/TreeMap.d.ts

@@ -0,0 +1,29 @@
+export interface TreeMapNode {
+    label: string;
+    value: number;
+    color?: string;
+    children?: TreeMapNode[];
+}
+export interface TreeMapProps {
+    /** Root node of the treemap data */
+    data: TreeMapNode;
+    /** SVG width in pixels (default: 600) */
+    width?: number;
+    /** SVG height in pixels (default: 400) */
+    height?: number;
+    /** Show labels inside cells (default: true) */
+    showLabels?: boolean;
+    /** Show values inside cells (default: true) */
+    showValues?: boolean;
+    /** Color palette for cells without explicit color */
+    colors?: string[];
+    /** Border color around cells (default: '#ffffff') */
+    borderColor?: string;
+    /** Border width in px (default: 2) */
+    borderWidth?: number;
+    /** Inner padding for nested cells in px (default: 2) */
+    padding?: number;
+    /** Chart title */
+    title?: string;
+}
+export declare function TreeMap(props: TreeMapProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/tree-map/src/index.d.ts

@@ -0,0 +1,2 @@
+export { TreeMap } from './TreeMap';
+export type { TreeMapProps, TreeMapNode } from './TreeMap';

package/dist/types/components/viz/us-state-map/src/USStateMap.d.ts

@@ -0,0 +1,23 @@
+export interface USStateMapProps {
+    /** SVG width in pixels (default: 959) */
+    width?: number;
+    /** SVG height in pixels (default: 593) */
+    height?: number;
+    /** Map of state abbreviation to fill color */
+    stateColors?: Record<string, string>;
+    /** Default fill color for states not in stateColors (default: '#D0D0D0') */
+    defaultColor?: string;
+    /** Border color between states (default: '#FFFFFF') */
+    strokeColor?: string;
+    /** Border width between states (default: 1) */
+    strokeWidth?: number;
+    /** Click handler — receives the state abbreviation */
+    onStateClick?: (stateId: string) => void;
+    /** Hover handler — receives the state abbreviation or null on mouse leave */
+    onStateHover?: (stateId: string | null) => void;
+    /** Highlight color on hover (default: '#FFD700') */
+    hoverColor?: string;
+    /** Accessible title for the SVG (default: 'Map of the United States') */
+    title?: string;
+}
+export declare function USStateMap(props: USStateMapProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/us-state-map/src/index.d.ts

@@ -0,0 +1,4 @@
+export { USStateMap } from "./USStateMap";
+export type { USStateMapProps } from "./USStateMap";
+export { US_STATE_PATHS } from "./us-state-paths";
+export type { StatePathData } from "./us-state-paths";

package/dist/types/components/viz/us-state-map/src/us-state-paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * US state SVG path data extracted from a public domain (CC0) blank US map.
+ * Each entry maps a two-letter state abbreviation to its name and SVG path.
+ * The paths are designed for a viewBox of "0 0 959 593".
+ */
+export interface StatePathData {
+    name: string;
+    path: string;
+}
+export declare const US_STATE_PATHS: Record<string, StatePathData>;

package/dist/types/components/viz/vector-field/src/VectorField.d.ts

@@ -0,0 +1,61 @@
+export interface VectorDatum {
+    x: number;
+    y: number;
+    dx: number;
+    dy: number;
+    magnitude?: number;
+}
+/** Function signature for a custom compute worker */
+export type ComputeWorkerFn = (gridPoints: {
+    x: number;
+    y: number;
+}[], uniforms: Record<string, number>) => {
+    dx: number;
+    dy: number;
+}[];
+export interface VectorFieldProps {
+    /** Pre-computed vector data */
+    data?: VectorDatum[];
+    /** Function that computes vector at each grid point */
+    vectorFunction?: (x: number, y: number) => {
+        dx: number;
+        dy: number;
+    };
+    /** Width in pixels (default: 600) */
+    width?: number;
+    /** Height in pixels (default: 600) */
+    height?: number;
+    /** Number of arrows per axis when using vectorFunction (default: 15, max: 50) */
+    gridSize?: number;
+    /** X-axis domain (default: [-5, 5]) */
+    xRange?: [number, number];
+    /** Y-axis domain (default: [-5, 5]) */
+    yRange?: [number, number];
+    /** Scale factor for arrow length (default: 1) */
+    arrowScale?: number;
+    /** Default arrow color (default: '#3b82f6') */
+    arrowColor?: string;
+    /** Show background grid (default: true) */
+    showGrid?: boolean;
+    /** Show axes through origin (default: true) */
+    showAxes?: boolean;
+    /** Color arrows by magnitude (default: false) */
+    colorByMagnitude?: boolean;
+    /** Color scale for magnitude coloring (default: blue-red) */
+    colorScale?: string[];
+    /** Chart title */
+    title?: string;
+    /** Padding around chart area in px (default: 50) */
+    padding?: number;
+    /** Font size for axis tick labels in px (default: 10) */
+    tickFontSize?: number;
+    /** Arrow stroke width (default: 1.5) */
+    arrowWidth?: number;
+    /** Rendering mode: 'svg' for DOM-based, 'canvas' for Canvas 2D (default: 'svg') */
+    renderer?: 'svg' | 'canvas';
+    /** Enable GPU-accelerated compute via a custom worker function (default: false) */
+    useGPU?: boolean;
+    /** Custom compute function for vector field calculation (e.g. for radio propagation) */
+    computeWorker?: ComputeWorkerFn;
+}
+export declare function VectorField(props: VectorFieldProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/vector-field/src/index.d.ts

@@ -0,0 +1,2 @@
+export { VectorField } from './VectorField';
+export type { VectorFieldProps, VectorDatum, ComputeWorkerFn } from './VectorField';

package/dist/types/components/viz/waterfall/src/WaterfallChart.d.ts

@@ -0,0 +1,32 @@
+export interface WaterfallDatum {
+    label: string;
+    value: number;
+    type?: 'increase' | 'decrease' | 'total';
+}
+export interface WaterfallChartProps {
+    /** Data points to render */
+    data: WaterfallDatum[];
+    /** SVG width in pixels (default: 600) */
+    width?: number;
+    /** SVG height in pixels (default: 400) */
+    height?: number;
+    /** Color for increase bars (default: '#10b981') */
+    increaseColor?: string;
+    /** Color for decrease bars (default: '#ef4444') */
+    decreaseColor?: string;
+    /** Color for total bars (default: '#3b82f6') */
+    totalColor?: string;
+    /** Color for connector lines (default: '#94a3b8') */
+    connectorColor?: string;
+    /** Show value labels on bars (default: true) */
+    showValues?: boolean;
+    /** Show grid lines (default: true) */
+    showGrid?: boolean;
+    /** Show connector lines between bars (default: true) */
+    showConnectors?: boolean;
+    /** Chart title */
+    title?: string;
+    /** Padding around chart area in px (default: 60) */
+    padding?: number;
+}
+export declare function WaterfallChart(props: WaterfallChartProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/waterfall/src/index.d.ts

@@ -0,0 +1,2 @@
+export { WaterfallChart } from './WaterfallChart';
+export type { WaterfallChartProps, WaterfallDatum } from './WaterfallChart';

package/dist/types/components/viz/word-cloud/src/WordCloud.d.ts

@@ -0,0 +1,30 @@
+export interface WordDatum {
+    text: string;
+    weight: number;
+    color?: string;
+}
+export interface WordCloudProps {
+    /** Array of words with weights */
+    words: WordDatum[];
+    /** SVG width in pixels (default: 600) */
+    width?: number;
+    /** SVG height in pixels (default: 400) */
+    height?: number;
+    /** Minimum font size in px (default: 10) */
+    minFontSize?: number;
+    /** Maximum font size in px (default: 64) */
+    maxFontSize?: number;
+    /** Font family (default: 'sans-serif') */
+    fontFamily?: string;
+    /** Color palette for words without explicit color */
+    colors?: string[];
+    /** Allowed rotation angles in degrees (default: [0, -45, 45, 90]) */
+    rotations?: number[];
+    /** Padding between words in px (default: 4) */
+    padding?: number;
+    /** Spiral type for placement (default: 'archimedean') */
+    spiral?: 'archimedean' | 'rectangular';
+    /** Chart title */
+    title?: string;
+}
+export declare function WordCloud(props: WordCloudProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/word-cloud/src/index.d.ts

@@ -0,0 +1,2 @@
+export { WordCloud } from './WordCloud';
+export type { WordCloudProps, WordDatum } from './WordCloud';

package/dist/types/components/viz/wrapper/src/VizWrapper.d.ts

@@ -0,0 +1,60 @@
+export type Position = 'top' | 'bottom' | 'left' | 'right';
+export interface LegendItem {
+    label: string;
+    color: string;
+    /** Optional dash pattern for line charts (e.g. '5,3') */
+    dash?: string;
+    /** Shape: circle, square, line (default: circle) */
+    shape?: 'circle' | 'square' | 'line';
+}
+export interface VizWrapperProps {
+    /** Title text */
+    title?: string;
+    /** Position of the title relative to content (default: 'top') */
+    titlePosition?: Position;
+    /** Title alignment: 'start' | 'center' | 'end' (default: 'center') */
+    titleAlign?: 'start' | 'center' | 'end';
+    /** Title font size (default: '16px') */
+    titleFontSize?: string;
+    /** Title font weight (default: '600') */
+    titleFontWeight?: string;
+    /** Title color (default: '#1f2937') */
+    titleColor?: string;
+    /** Legend items */
+    legend?: LegendItem[];
+    /** Position of the legend relative to content (default: 'bottom') */
+    legendPosition?: Position;
+    /** Legend alignment: 'start' | 'center' | 'end' (default: 'center') */
+    legendAlign?: 'start' | 'center' | 'end';
+    /** Legend font size (default: '12px') */
+    legendFontSize?: string;
+    /** Legend item spacing in px (default: 16) */
+    legendGap?: number;
+    /** Container width (default: 'auto') */
+    width?: string | number;
+    /** Container height (default: 'auto') */
+    height?: string | number;
+    /** Background color (default: '#ffffff') */
+    backgroundColor?: string;
+    /** Border (default: '1px solid #e5e7eb') */
+    border?: string;
+    /** Border radius (default: '8px') */
+    borderRadius?: string;
+    /** Padding around the entire wrapper (default: '16px') */
+    padding?: string;
+    /** Gap between title/legend/content (default: '12px') */
+    gap?: string;
+    /** Box shadow (default: none) */
+    boxShadow?: string;
+    /** Font family (default: inherit) */
+    fontFamily?: string;
+    /** CSS contain value for isolation (default: 'layout style paint') */
+    contain?: string;
+    /** Extra className on the outer container */
+    className?: string;
+    /** Extra inline style on the outer container */
+    style?: Record<string, string>;
+    /** The visualization content (children) */
+    children?: unknown;
+}
+export declare function VizWrapper(props: VizWrapperProps): import("specifyjs/shared/types").SpecElement<import("specifyjs/shared/types").Props>;

package/dist/types/components/viz/wrapper/src/index.d.ts

@@ -0,0 +1,2 @@
+export { VizWrapper } from './VizWrapper';
+export type { VizWrapperProps, Position, LegendItem, } from './VizWrapper';

package/dist/types/compute/context.d.ts

@@ -0,0 +1,20 @@
+import type { ComputeContext } from './types';
+/**
+ * Force a specific backend for all subsequent {@link createComputeContext}
+ * calls.
+ *
+ * Passing a new value clears the cached backend so the next
+ * {@link createComputeContext} call will create a fresh instance.
+ *
+ * @param name - Backend to use ('webgpu', 'webgl', or 'cpu').
+ */
+export declare function setComputeBackend(name: 'webgpu' | 'webgl' | 'cpu'): void;
+/**
+ * Create (or return the cached) {@link ComputeContext}.
+ *
+ * Auto-detection order: WebGPU -> WebGL -> CPU.
+ * The first backend that reports {@link ComputeBackend.isAvailable | isAvailable()}
+ * is initialised and cached for the lifetime of the page.
+ */
+export declare function createComputeContext(): Promise<ComputeContext>;
+//# sourceMappingURL=context.d.ts.map

package/dist/types/compute/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/compute/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,cAAc,EAIf,MAAM,SAAS,CAAC;AAsBjB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,CAGxE;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,cAAc,CAAC,CAQpE"}

package/dist/types/compute/cpu-backend.d.ts

@@ -0,0 +1,15 @@
+import type { BackendInfo, ComputeBackend, KernelName, KernelParams, KernelResult } from './types';
+/** Pure TypeScript CPU backend — the universal fallback. */
+export declare class CpuBackend implements ComputeBackend {
+    /** @inheritdoc */
+    readonly info: BackendInfo;
+    /** CPU backend is always available. */
+    isAvailable(): boolean;
+    /** No initialisation required for the CPU backend. */
+    init(): Promise<void>;
+    /** Execute the named kernel synchronously on the CPU. */
+    execute(kernel: KernelName, params: KernelParams): Promise<KernelResult>;
+    /** No resources to release on the CPU backend. */
+    dispose(): void;
+}
+//# sourceMappingURL=cpu-backend.d.ts.map

package/dist/types/compute/cpu-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cpu-backend.d.ts","sourceRoot":"","sources":["../../../src/compute/cpu-backend.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAEd,UAAU,EACV,YAAY,EACZ,YAAY,EACb,MAAM,SAAS,CAAC;AAiOjB,4DAA4D;AAC5D,qBAAa,UAAW,YAAW,cAAc;IAC/C,kBAAkB;IAClB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAIxB;IAEF,uCAAuC;IACvC,WAAW,IAAI,OAAO;IAItB,sDAAsD;IAChD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,yDAAyD;IACnD,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ9E,kDAAkD;IAClD,OAAO,IAAI,IAAI;CAGhB"}

package/dist/types/compute/index.d.ts

@@ -0,0 +1,3 @@
+export { createComputeContext, setComputeBackend } from './context';
+export type { KernelName, ComputeBuffer, KernelParams, KernelResult, BackendInfo, ComputeBackend, ComputeContext, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/compute/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/compute/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAEpE,YAAY,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,cAAc,EACd,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/types/compute/types.d.ts

@@ -0,0 +1,57 @@
+/** Named compute kernel identifier. */
+export type KernelName = 'matrix-multiply' | 'verlet-constraints' | 'n-body' | 'particle-system';
+/** Buffer of numeric data for GPU transfer. */
+export interface ComputeBuffer {
+    /** Identifier for this buffer within a kernel invocation. */
+    name: string;
+    /** Typed array holding the numeric payload. */
+    data: Float64Array | Float32Array;
+    /** 'read' = input only, 'write' = output only, 'readwrite' = both. */
+    usage: 'read' | 'write' | 'readwrite';
+}
+/** Parameters for a kernel execution. */
+export interface KernelParams {
+    /** Data buffers consumed and/or produced by the kernel. */
+    buffers: ComputeBuffer[];
+    /** Scalar uniform values keyed by name. */
+    uniforms?: Record<string, number>;
+    /** Optional workgroup size hint (GPU backends). */
+    workgroupSize?: number;
+}
+/** Result of a kernel execution. */
+export interface KernelResult {
+    /** Output buffers keyed by buffer name. */
+    buffers: Map<string, Float64Array | Float32Array>;
+}
+/** Backend capabilities descriptor. */
+export interface BackendInfo {
+    /** Backend identifier. */
+    name: 'webgpu' | 'webgl' | 'cpu';
+    /** Whether this backend uses a hardware GPU. */
+    isGPU: boolean;
+    /** Maximum buffer size in bytes. */
+    maxBufferSize: number;
+}
+/** Compute backend interface — implemented by each backend. */
+export interface ComputeBackend {
+    /** Descriptor for this backend's capabilities. */
+    readonly info: BackendInfo;
+    /** Returns true when this backend can be used in the current environment. */
+    isAvailable(): boolean;
+    /** Perform any async initialisation (e.g. request GPU device). */
+    init(): Promise<void>;
+    /** Execute the named kernel with the given parameters. */
+    execute(kernel: KernelName, params: KernelParams): Promise<KernelResult>;
+    /** Release GPU resources held by this backend. */
+    dispose(): void;
+}
+/** Public compute context — the developer-facing API. */
+export interface ComputeContext {
+    /** Execute a named compute kernel. */
+    execute(kernel: KernelName, params: KernelParams): Promise<KernelResult>;
+    /** Return information about the active backend. */
+    getBackendInfo(): BackendInfo;
+    /** Release all resources. */
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/compute/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/compute/types.ts"],"names":[],"mappings":"AAGA,uCAAuC;AACvC,MAAM,MAAM,UAAU,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,QAAQ,GAAG,iBAAiB,CAAC;AAEjG,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;IAClC,sEAAsE;IACtE,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,WAAW,CAAC;CACvC;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC3B,2CAA2C;IAC3C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC,CAAC;CACnD;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IACjC,gDAAgD;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,6EAA6E;IAC7E,WAAW,IAAI,OAAO,CAAC;IACvB,kEAAkE;IAClE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,0DAA0D;IAC1D,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzE,kDAAkD;IAClD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACzE,mDAAmD;IACnD,cAAc,IAAI,WAAW,CAAC;IAC9B,6BAA6B;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types/compute/webgl-backend.d.ts

@@ -0,0 +1,33 @@
+import type { BackendInfo, ComputeBackend, KernelName, KernelParams, KernelResult } from './types';
+/**
+ * WebGL compute backend.
+ *
+ * Currently delegates all computation to the CPU backend. The texture-based
+ * compute pipeline described above will be implemented in a future release
+ * once the kernel registry stabilises.
+ */
+export declare class WebGlBackend implements ComputeBackend {
+    /** @inheritdoc */
+    readonly info: BackendInfo;
+    /** CPU fallback used for all kernel execution at this stage. */
+    private readonly _cpu;
+    /**
+     * Returns true when a WebGL rendering context can be created.
+     *
+     * Checks for WebGL2 first (required for float texture support without
+     * extensions), then falls back to WebGL1.
+     */
+    isAvailable(): boolean;
+    /** No async initialisation needed while delegating to CPU. */
+    init(): Promise<void>;
+    /**
+     * Execute the kernel.
+     *
+     * Delegates to the CPU backend until the texture-based compute pipeline
+     * is implemented.
+     */
+    execute(kernel: KernelName, params: KernelParams): Promise<KernelResult>;
+    /** Release any GL resources (none held at this stage). */
+    dispose(): void;
+}
+//# sourceMappingURL=webgl-backend.d.ts.map