28183428603

Committed 25 Jun 2026 04:01PM UTC coverage: 70.395%. First build

Build # 28183428603

Build Type

Pull #2695

github

Committed by

web-flow

Commit Message

Merge 35d924ad1 into 53f8e0f7b

Pull Request Pull Request #2695: feat(tables): add GPU constant columns

Coverage Stats

9740 of 15682 branches covered (62.11%)

Branch coverage included in aggregate %.

245 of 321 new or added lines in 6 files covered. (76.32%)

19474 of 25818 relevant lines covered (75.43%)

4230.7 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

78.57

/modules/tables/src/engine/gpu-input-schema.ts

// luma.gl
// SPDX-License-Identifier: MIT
// Copyright (c) vis.gl contributors

import type {GPUVector} from '../table/gpu-vector';
import type {GPUConstant} from '../table/gpu-constant';
import type {GPUVectorFormat} from '../table/gpu-vector-format';

/** Semantic role consumed by one GPU input. */
export type GPUInputKind = 'positions' | 'colors' | 'scalars' | 'text' | 'time';

/** Runtime declaration for one prepared GPUVector consumed by a model or renderer. */
export type GPUInputDeclaration<
  ColumnName extends string = string,
  Format extends GPUVectorFormat = GPUVectorFormat
> = {
  /** Prepared GPUTable column and GPUVector map key. */
  columnName: ColumnName;
  /** Optional shader attribute supplied by this column. */
  attributeName?: string;
  /** Optional shader storage binding supplied by this column. */
  bindingName?: string;
  /** Semantic role consumed by the model or renderer. */
  kind: GPUInputKind;
  /** Whether callers must provide this prepared GPU input. */
  required: boolean;
  /** Accepted canonical GPUVector memory formats. */
  formats: readonly Format[];
  /**
   * Whether this input is generated during conversion or model preparation.
   * Omit for inputs that source mapping may resolve directly.
   */
  internal?: boolean;
};

/** Runtime prepared GPU input contract declared by one model or renderer. */
export type GPUInputSchema = readonly GPUInputDeclaration[];

/** Prepared varying GPU vectors keyed by declared GPU input column name. */
export type GPUInputVectors = Record<string, GPUVector | undefined>;

/** Prepared logical GPU columns keyed by declared GPU input column name. */
export type GPUInputColumns = Record<string, GPUVector | GPUConstant | undefined>;

/** Validates prepared GPU vectors against one runtime GPU input schema. */
export function validateGPUInputVectors(
  ownerName: string,
  schema: GPUInputSchema,
  vectors: GPUInputColumns
): void {
  for (const input of schema) {
    const column = vectors[input.columnName];
    if (!column) {
      if (input.required) {
        throw new Error(`${ownerName} requires GPU input "${input.columnName}"`);
      }
      continue;
    }

    if ('isConstant' in column && input.required) {
      throw new Error(
        `${ownerName} requires varying GPU input "${input.columnName}"; required inputs cannot be constant`
      );
    }

    const format = column.format;
    if (!format || !(input.formats as readonly GPUVectorFormat[]).includes(format)) {
      const columnType = 'isConstant' in column ? 'GPUConstant' : 'GPUVector';
      throw new Error(
        `${ownerName} ${input.columnName} ${columnType}.format "${format ?? 'undefined'}" must be one of ${input.formats.join(', ')}`
      );
    }
  }
}

1	// luma.gl
2	// SPDX-License-Identifier: MIT
3	// Copyright (c) vis.gl contributors
4
5	import type {GPUVector} from '../table/gpu-vector';
6	import type {GPUConstant} from '../table/gpu-constant';
7	import type {GPUVectorFormat} from '../table/gpu-vector-format';
8
9	/** Semantic role consumed by one GPU input. */
10	export type GPUInputKind = 'positions' \| 'colors' \| 'scalars' \| 'text' \| 'time';
11
12	/** Runtime declaration for one prepared GPUVector consumed by a model or renderer. */
13	export type GPUInputDeclaration<
14	ColumnName extends string = string,
15	Format extends GPUVectorFormat = GPUVectorFormat
16	> = {
17	/** Prepared GPUTable column and GPUVector map key. */
18	columnName: ColumnName;
19	/** Optional shader attribute supplied by this column. */
20	attributeName?: string;
21	/** Optional shader storage binding supplied by this column. */
22	bindingName?: string;
23	/** Semantic role consumed by the model or renderer. */
24	kind: GPUInputKind;
25	/** Whether callers must provide this prepared GPU input. */
26	required: boolean;
27	/** Accepted canonical GPUVector memory formats. */
28	formats: readonly Format[];
29	/**
30	* Whether this input is generated during conversion or model preparation.
31	* Omit for inputs that source mapping may resolve directly.
32	*/
33	internal?: boolean;
34	};
35
36	/** Runtime prepared GPU input contract declared by one model or renderer. */
37	export type GPUInputSchema = readonly GPUInputDeclaration[];
38
39	/** Prepared varying GPU vectors keyed by declared GPU input column name. */
40	export type GPUInputVectors = Record<string, GPUVector \| undefined>;
41
42	/** Prepared logical GPU columns keyed by declared GPU input column name. */
43	export type GPUInputColumns = Record<string, GPUVector \| GPUConstant \| undefined>;
44
45	/** Validates prepared GPU vectors against one runtime GPU input schema. */
46	export function validateGPUInputVectors(
47	ownerName: string,
48	schema: GPUInputSchema,
49	vectors: GPUInputColumns
50	): void {
51	for (const input of schema) {	71✔
52	const column = vectors[input.columnName];	453✔
53	if (!column) {	453✔
54	if (input.required) {	277!
55	throw new Error(`${ownerName} requires GPU input "${input.columnName}"`);	×
56	}
57	continue;	277✔
58	}
59
60	if ('isConstant' in column && input.required) {	176!
NEW 61	throw new Error(	×
62	`${ownerName} requires varying GPU input "${input.columnName}"; required inputs cannot be constant`
63	);
64	}
65
66	const format = column.format;	176✔
67	if (!format \|\| !(input.formats as readonly GPUVectorFormat[]).includes(format)) {	176✔
68	const columnType = 'isConstant' in column ? 'GPUConstant' : 'GPUVector';	3!
69	throw new Error(	3✔
70	`${ownerName} ${input.columnName} ${columnType}.format "${format ?? 'undefined'}" must be one of ${input.formats.join(', ')}`	3!
71	);
72	}
73	}
74	}

visgl / luma.gl / 28183428603

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous