@math.gl/geometry 5.0.0-beta.4 → 5.0.0-beta.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (106) hide show
  1. package/README.md +61 -0
  2. package/THIRD-PARTY-NOTICES.md +1 -1
  3. package/dist/color/color-lut-types.d.ts +16 -0
  4. package/dist/color/color-lut-types.d.ts.map +1 -0
  5. package/dist/color/color-lut-types.js +5 -0
  6. package/dist/color/color-lut-types.js.map +1 -0
  7. package/dist/color/index.cjs +132 -0
  8. package/dist/color/index.cjs.map +6 -0
  9. package/dist/color/index.d.ts +4 -0
  10. package/dist/color/index.d.ts.map +1 -0
  11. package/dist/color/index.js +5 -0
  12. package/dist/color/index.js.map +1 -0
  13. package/dist/color/sample-lut.d.ts +13 -0
  14. package/dist/color/sample-lut.d.ts.map +1 -0
  15. package/dist/color/sample-lut.js +132 -0
  16. package/dist/color/sample-lut.js.map +1 -0
  17. package/dist/culling/bounds.d.ts +20 -0
  18. package/dist/culling/bounds.d.ts.map +1 -0
  19. package/dist/culling/bounds.js +121 -0
  20. package/dist/culling/bounds.js.map +1 -0
  21. package/dist/culling/frustum-planes.d.ts +5 -0
  22. package/dist/culling/frustum-planes.d.ts.map +1 -0
  23. package/dist/culling/frustum-planes.js +37 -0
  24. package/dist/culling/frustum-planes.js.map +1 -0
  25. package/dist/culling/geometric-queries.d.ts +34 -0
  26. package/dist/culling/geometric-queries.d.ts.map +1 -0
  27. package/dist/culling/geometric-queries.js +208 -0
  28. package/dist/culling/geometric-queries.js.map +1 -0
  29. package/dist/culling/index.cjs +917 -514
  30. package/dist/culling/index.cjs.map +3 -3
  31. package/dist/culling/index.d.ts +5 -1
  32. package/dist/culling/index.d.ts.map +1 -1
  33. package/dist/culling/index.js +3 -0
  34. package/dist/culling/index.js.map +1 -1
  35. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.d.ts +3 -3
  36. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.d.ts.map +1 -1
  37. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.js +25 -8
  38. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.js.map +1 -1
  39. package/dist/culling/lib/culling-volume.d.ts +3 -0
  40. package/dist/culling/lib/culling-volume.d.ts.map +1 -1
  41. package/dist/culling/lib/culling-volume.js +7 -0
  42. package/dist/culling/lib/culling-volume.js.map +1 -1
  43. package/dist/culling/lib/ray.d.ts +5 -0
  44. package/dist/culling/lib/ray.d.ts.map +1 -1
  45. package/dist/culling/lib/ray.js +21 -0
  46. package/dist/culling/lib/ray.js.map +1 -1
  47. package/dist/curves/adaptive-sampling.d.ts +16 -0
  48. package/dist/curves/adaptive-sampling.d.ts.map +1 -0
  49. package/dist/curves/adaptive-sampling.js +59 -0
  50. package/dist/curves/adaptive-sampling.js.map +1 -0
  51. package/dist/curves/index.d.ts +4 -0
  52. package/dist/curves/index.d.ts.map +1 -1
  53. package/dist/curves/index.js +2 -0
  54. package/dist/curves/index.js.map +1 -1
  55. package/dist/curves/parallel-transport.d.ts +12 -0
  56. package/dist/curves/parallel-transport.d.ts.map +1 -0
  57. package/dist/curves/parallel-transport.js +83 -0
  58. package/dist/curves/parallel-transport.js.map +1 -0
  59. package/dist/index.cjs +1336 -699
  60. package/dist/index.cjs.map +3 -3
  61. package/dist/index.d.ts +10 -1
  62. package/dist/index.d.ts.map +1 -1
  63. package/dist/index.js +5 -0
  64. package/dist/index.js.map +1 -1
  65. package/dist/lighting/index.cjs +175 -0
  66. package/dist/lighting/index.cjs.map +6 -0
  67. package/dist/lighting/index.d.ts +4 -0
  68. package/dist/lighting/index.d.ts.map +1 -0
  69. package/dist/lighting/index.js +5 -0
  70. package/dist/lighting/index.js.map +1 -0
  71. package/dist/lighting/lighting-types.d.ts +16 -0
  72. package/dist/lighting/lighting-types.d.ts.map +1 -0
  73. package/dist/lighting/lighting-types.js +5 -0
  74. package/dist/lighting/lighting-types.js.map +1 -0
  75. package/dist/lighting/photometry.d.ts +36 -0
  76. package/dist/lighting/photometry.d.ts.map +1 -0
  77. package/dist/lighting/photometry.js +181 -0
  78. package/dist/lighting/photometry.js.map +1 -0
  79. package/dist/utils/project-bounds.d.ts +44 -0
  80. package/dist/utils/project-bounds.d.ts.map +1 -0
  81. package/dist/utils/project-bounds.js +93 -0
  82. package/dist/utils/project-bounds.js.map +1 -0
  83. package/dist/utils/project-texture-coordinates.d.ts +19 -0
  84. package/dist/utils/project-texture-coordinates.d.ts.map +1 -0
  85. package/dist/utils/project-texture-coordinates.js +49 -0
  86. package/dist/utils/project-texture-coordinates.js.map +1 -0
  87. package/package.json +15 -3
  88. package/src/color/color-lut-types.ts +19 -0
  89. package/src/color/index.ts +6 -0
  90. package/src/color/sample-lut.ts +175 -0
  91. package/src/culling/bounds.ts +152 -0
  92. package/src/culling/frustum-planes.ts +41 -0
  93. package/src/culling/geometric-queries.ts +299 -0
  94. package/src/culling/index.ts +37 -1
  95. package/src/culling/lib/bounding-volumes/axis-aligned-bounding-box.ts +26 -8
  96. package/src/culling/lib/culling-volume.ts +9 -1
  97. package/src/culling/lib/ray.ts +21 -0
  98. package/src/curves/adaptive-sampling.ts +85 -0
  99. package/src/curves/index.ts +4 -0
  100. package/src/curves/parallel-transport.ts +104 -0
  101. package/src/index.ts +44 -0
  102. package/src/lighting/index.ts +10 -0
  103. package/src/lighting/lighting-types.ts +20 -0
  104. package/src/lighting/photometry.ts +264 -0
  105. package/src/utils/project-bounds.ts +154 -0
  106. package/src/utils/project-texture-coordinates.ts +67 -0
package/dist/index.d.ts CHANGED
@@ -30,7 +30,7 @@ export type { CurvePoint, CatmullRomCurveOptions } from "./curves/index.js";
30
30
  export { Polygon, getPolygonSignedArea, getPolygonWindingDirection, forEachSegmentInPolygon, modifyPolygonWindingDirection, earcut, clipPolygon, clipPolyline, cutPolygonByGrid, cutPolylineByGrid, cutPolylineByMercatorBounds, cutPolygonByMercatorBounds, subdividePolyline, subdivideTriangleMesh } from "./polygon/index.js";
31
31
  export type { PolygonWinding, WindingDirection, SubdividePolylineOptions, SubdividedPolyline, PolylineEdgeSampler, TriangleMesh, SubdivideTriangleMeshOptions, SubdividedTriangleMesh } from "./polygon/index.js";
32
32
  export { AxisAlignedBoundingBox, BoundingSphere, OrientedBoundingBox, CullingVolume, Plane, Ray, BoxShape, CapsuleShape, CylinderShape, PlaneShape, SphereShape, _PerspectiveOffCenterFrustum, _PerspectiveFrustum, makeBoundingSphereFromPoints, makeAxisAlignedBoundingBoxFromPoints, makeOrientedBoundingBoxFromPoints, computeEigenDecomposition, intersectRayBounds, intersectRayTriangle, getClosestPointOnTriangle, intersectOrientedBoxes2D, getOrientedBoundingBoxQuaternion, makeOrientedBoundingBoxFromQuaternion } from "./culling/index.js";
33
- export type { CullingResult, ImplicitShape, RayIntersection, BoxShapeProps, CapsuleShapeProps, CylinderShapeProps, PlaneShapeProps, SphereShapeProps, QueryPoint, TriangleRayHit, OrientedBox2D } from "./culling/index.js";
33
+ export type { CullingResult, ImplicitShape, Shape, RayIntersection, BoxShapeProps, CapsuleShapeProps, CylinderShapeProps, PlaneShapeProps, SphereShapeProps, QueryPoint, TriangleRayHit, OrientedBox2D } from "./culling/index.js";
34
34
  export { validateQueryPoint, validateQueryDistance, normalizeQueryDirection, getClosestPointsOnSegments, getClosestPointsSegmentTriangle } from "./culling/queries.js";
35
35
  export type { SegmentClosestPoints, SegmentTriangleClosestPoints } from "./culling/queries.js";
36
36
  export { BoxIndex, PointIndex, TriangleBVH } from "./spatial-index/index.js";
@@ -41,4 +41,13 @@ export type { MeshClipRegion, ClipTriangleMeshOptions, ClippedTriangleMesh } fro
41
41
  export { composeAttributeProvenance } from "./utils/compose-attribute-provenance.js";
42
42
  export { qualifySurfaceTransition } from "./utils/qualify-surface-transition.js";
43
43
  export type { SurfaceTransitionQualification } from "./utils/qualify-surface-transition.js";
44
+ export { extractFrustumPlanes, createEmptyBounds, isEmptyBounds, boundsContainsPoint, boundsContainsBounds, boundsIntersect, unionBounds, intersectBounds, expandBoundsByPoint, expandBounds, clampPointToBounds, spheresIntersect, boundsIntersectSphere } from "./culling/index.js";
45
+ export { getRayPoint, getClosestPointOnRay, distanceToRay, getClosestPointsRaySegment, transformRay, getTriangleBarycentric, getTriangleArea, getTriangleNormal, isTriangleFrontFacing, triangleContainsPoint, interpolateTriangleAttribute, intersectPlaneSegment, triangleIntersectsBounds } from "./culling/geometric-queries.js";
46
+ export type { RaySegmentClosestPoints } from "./culling/geometric-queries.js";
47
+ export { sampleCurveAdaptive, computeParallelTransportFrames } from "./curves/index.js";
48
+ export type { AdaptiveCurveOptions, AdaptiveCurveSamples, CurveFrames } from "./curves/index.js";
49
+ export { projectBounds } from "./utils/project-bounds.js";
50
+ export type { ProjectionSourceBounds, ProjectBoundsOptions, ProjectedBoundsResult } from "./utils/project-bounds.js";
51
+ export { projectTextureCoordinates } from "./utils/project-texture-coordinates.js";
52
+ export type { ProjectTextureCoordinatesOptions } from "./utils/project-texture-coordinates.js";
44
53
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -24,4 +24,9 @@ export { BoxIndex, PointIndex, TriangleBVH } from "./spatial-index/index.js";
24
24
  export { clipTriangleMesh } from "./polygon/clip-triangle-mesh.js";
25
25
  export { composeAttributeProvenance } from "./utils/compose-attribute-provenance.js";
26
26
  export { qualifySurfaceTransition } from "./utils/qualify-surface-transition.js";
27
+ export { extractFrustumPlanes, createEmptyBounds, isEmptyBounds, boundsContainsPoint, boundsContainsBounds, boundsIntersect, unionBounds, intersectBounds, expandBoundsByPoint, expandBounds, clampPointToBounds, spheresIntersect, boundsIntersectSphere } from "./culling/index.js";
28
+ export { getRayPoint, getClosestPointOnRay, distanceToRay, getClosestPointsRaySegment, transformRay, getTriangleBarycentric, getTriangleArea, getTriangleNormal, isTriangleFrontFacing, triangleContainsPoint, interpolateTriangleAttribute, intersectPlaneSegment, triangleIntersectsBounds } from "./culling/geometric-queries.js";
29
+ export { sampleCurveAdaptive, computeParallelTransportFrames } from "./curves/index.js";
30
+ export { projectBounds } from "./utils/project-bounds.js";
31
+ export { projectTextureCoordinates } from "./utils/project-texture-coordinates.js";
27
32
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,OAAO,EAAC,QAAQ,EAAC,0BAAuB;AAQxC,OAAO,EAAC,SAAS,EAAC,4BAAyB;AAG3C,OAAO,EAAC,qBAAqB,EAAC,gCAA6B;AAE3D,OAAO,EAAC,WAAW,EAAE,YAAY,EAAC,qCAAkC;AAEpE,OAAO,EAAC,eAAe,EAAC,yCAAsC;AAE9D,OAAO,EAAC,gBAAgB,EAAE,YAAY,EAAC,0CAAuC;AAE9E,OAAO,EAAC,aAAa,EAAC,uCAAoC;AAE1D,OAAO,EAAC,cAAc,EAAC,wCAAqC;AAE5D,OAAO,EAAC,qBAAqB,EAAC,gDAA6C;AAE3E,OAAO,EAAC,iBAAiB,EAAC,4CAAyC;AAGnE,OAAO,EAAC,aAAa,EAAC,uCAAoC;AAG1D,OAAO,EAAC,YAAY,EAAC,sCAAmC;AAGxD,qFAAqF;AACrF,OAAO,EAAC,kBAAkB,EAAE,aAAa,EAAE,aAAa,EAAC,wBAAqB;AAO9E,OAAO,EACL,EAAE,EACF,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,MAAM,EACN,UAAU,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,cAAc,EACd,cAAc,EACd,OAAO,EACP,SAAS,EACT,0BAA0B,EAC1B,4BAA4B,EAC5B,iBAAiB,EACjB,IAAI,EACJ,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC5B,yBAAsB;AAavB,OAAO,EACL,KAAK,EACL,SAAS,EACT,oBAAoB,EACpB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,cAAc,EACf,0BAAuB;AAExB,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,0BAA0B,EAC1B,uBAAuB,EACvB,6BAA6B,EAC7B,MAAM,EACN,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,2BAA2B,EAC3B,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACtB,2BAAwB;AAWzB,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,KAAK,EACL,GAAG,EACH,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,4BAA4B,EAC5B,mBAAmB,EACnB,4BAA4B,EAC5B,oCAAoC,EACpC,iCAAiC,EACjC,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,wBAAwB,EACxB,gCAAgC,EAChC,qCAAqC,EACtC,2BAAwB;AAczB,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,uBAAuB,EACvB,0BAA0B,EAC1B,+BAA+B,EAChC,6BAA0B;AAE3B,OAAO,EAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAC,iCAA8B;AAsBxE,OAAO,EAAC,gBAAgB,EAAC,wCAAqC;AAO9D,OAAO,EAAC,0BAA0B,EAAC,gDAA6C;AAChF,OAAO,EAAC,wBAAwB,EAAC,8CAA2C"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,175 @@
1
+ var __defProp = Object.defineProperty;
2
+ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
3
+ var __getOwnPropNames = Object.getOwnPropertyNames;
4
+ var __hasOwnProp = Object.prototype.hasOwnProperty;
5
+ var __export = (target, all) => {
6
+ for (var name in all)
7
+ __defProp(target, name, { get: all[name], enumerable: true });
8
+ };
9
+ var __copyProps = (to, from, except, desc) => {
10
+ if (from && typeof from === "object" || typeof from === "function") {
11
+ for (let key of __getOwnPropNames(from))
12
+ if (!__hasOwnProp.call(to, key) && key !== except)
13
+ __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
14
+ }
15
+ return to;
16
+ };
17
+ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
18
+
19
+ // dist/lighting/index.js
20
+ var index_exports = {};
21
+ __export(index_exports, {
22
+ createPhotometricSampler: () => createPhotometricSampler,
23
+ integrateLuminousFlux: () => integrateLuminousFlux,
24
+ resamplePhotometricProfile: () => resamplePhotometricProfile
25
+ });
26
+ module.exports = __toCommonJS(index_exports);
27
+
28
+ // dist/lighting/photometry.js
29
+ var DEGREES_TO_RADIANS = Math.PI / 180;
30
+ var MAX_GRID_SAMPLES = 4194304;
31
+ function createPhotometricSampler(profile) {
32
+ const prepared = preparePhotometricProfile(profile);
33
+ return (verticalAngle, horizontalAngle) => {
34
+ if (!Number.isFinite(verticalAngle) || verticalAngle < 0 || verticalAngle > 180 || !Number.isFinite(horizontalAngle)) {
35
+ throw new Error("Photometry: sampling requires a vertical angle in [0, 180] and finite horizontal angle");
36
+ }
37
+ return samplePreparedProfile(prepared, verticalAngle, horizontalAngle);
38
+ };
39
+ }
40
+ function integrateLuminousFlux(profile) {
41
+ const prepared = preparePhotometricProfile(profile);
42
+ const { verticalAngles, horizontalAngles, values, horizontalSpan } = prepared;
43
+ const rows = new Float64Array(horizontalAngles.length);
44
+ for (let horizontalIndex = 0; horizontalIndex < rows.length; horizontalIndex++) {
45
+ for (let verticalIndex = 0; verticalIndex < verticalAngles.length - 1; verticalIndex++) {
46
+ const lowerAngle = verticalAngles[verticalIndex];
47
+ const upperAngle = verticalAngles[verticalIndex + 1];
48
+ const reflected = lowerAngle + upperAngle > 180;
49
+ const lower = reflected ? 180 - upperAngle : lowerAngle;
50
+ const upper = reflected ? 180 - lowerAngle : upperAngle;
51
+ const midpoint = (lower + upper) / 2 * DEGREES_TO_RADIANS;
52
+ const halfWidth = (upper - lower) / 2 * DEGREES_TO_RADIANS;
53
+ const squaredWidth = halfWidth * halfWidth;
54
+ const difference = halfWidth < 1e-3 ? squaredWidth * (-1 / 3 + squaredWidth * (1 / 30 - squaredWidth / 840)) : Math.cos(halfWidth) - Math.sin(halfWidth) / halfWidth;
55
+ const sharedWeight = Math.sin(midpoint) * Math.sin(halfWidth);
56
+ const offsetWeight = Math.cos(midpoint) * difference;
57
+ const lowerWeight = Math.max(0, sharedWeight + offsetWeight);
58
+ const upperWeight = Math.max(0, sharedWeight - offsetWeight);
59
+ const offset = horizontalIndex * verticalAngles.length + verticalIndex;
60
+ rows[horizontalIndex] += values[offset] * (reflected ? upperWeight : lowerWeight) + values[offset + 1] * (reflected ? lowerWeight : upperWeight);
61
+ }
62
+ }
63
+ let flux = 0;
64
+ if (horizontalSpan === 0)
65
+ flux = rows[0] * 2 * Math.PI;
66
+ else {
67
+ for (let index = 0; index < rows.length - 1; index++) {
68
+ const angularWidth = (horizontalAngles[index + 1] - horizontalAngles[index]) * DEGREES_TO_RADIANS;
69
+ flux += (rows[index] / 2 + rows[index + 1] / 2) * angularWidth;
70
+ }
71
+ flux *= 360 / horizontalSpan;
72
+ }
73
+ if (!Number.isFinite(flux))
74
+ throw new Error("Photometry: luminous flux overflow");
75
+ return flux;
76
+ }
77
+ function resamplePhotometricProfile(profile, options = {}) {
78
+ const { verticalCount = 181, horizontalCount = 360, normalization = "none" } = options;
79
+ if (!Number.isSafeInteger(verticalCount) || verticalCount < 2 || !Number.isSafeInteger(horizontalCount) || horizontalCount < 1 || verticalCount * horizontalCount > MAX_GRID_SAMPLES || !["none", "peak"].includes(normalization)) {
80
+ throw new Error("Photometry: invalid resampling dimensions or normalization");
81
+ }
82
+ const prepared = preparePhotometricProfile(profile);
83
+ const verticalAngles = Float64Array.from({ length: verticalCount }, (_, index) => index * 180 / (verticalCount - 1));
84
+ const horizontalAngles = Float64Array.from({ length: horizontalCount }, (_, index) => index * 360 / horizontalCount);
85
+ const data = new Float64Array(verticalCount * horizontalCount);
86
+ for (let horizontalIndex = 0; horizontalIndex < horizontalCount; horizontalIndex++) {
87
+ for (let verticalIndex = 0; verticalIndex < verticalCount; verticalIndex++) {
88
+ const intensity = samplePreparedProfile(prepared, verticalAngles[verticalIndex], horizontalAngles[horizontalIndex]);
89
+ data[horizontalIndex * verticalCount + verticalIndex] = normalization === "peak" ? prepared.peak > 0 ? intensity / prepared.peak : 0 : intensity;
90
+ }
91
+ }
92
+ return {
93
+ width: verticalCount,
94
+ height: horizontalCount,
95
+ data,
96
+ verticalAngles,
97
+ horizontalAngles,
98
+ unit: normalization === "peak" ? "relative" : "candela",
99
+ peakCandela: prepared.peak
100
+ };
101
+ }
102
+ function preparePhotometricProfile(profile) {
103
+ const { verticalAngles, horizontalAngles, intensities, intensityScale = 1, symmetry } = profile;
104
+ if (verticalAngles.length < 2 || horizontalAngles.length < 1 || intensities.length !== verticalAngles.length * horizontalAngles.length || !Number.isFinite(intensityScale) || intensityScale < 0) {
105
+ throw new Error("Photometry: invalid calculation profile");
106
+ }
107
+ for (const [angles, maximum] of [
108
+ [verticalAngles, 180],
109
+ [horizontalAngles, 360]
110
+ ]) {
111
+ for (let index = 0; index < angles.length; index++) {
112
+ if (!Number.isFinite(angles[index]) || angles[index] < 0 || angles[index] > maximum || index > 0 && angles[index] <= angles[index - 1])
113
+ throw new Error("Photometry: invalid calculation angles");
114
+ }
115
+ }
116
+ const first = horizontalAngles[0];
117
+ const last = horizontalAngles[horizontalAngles.length - 1];
118
+ const horizontalSpan = last - first;
119
+ const validSymmetry = symmetry === "rotational" && horizontalAngles.length === 1 || symmetry === "quadrant" && horizontalAngles.length > 1 && first === 0 && last === 90 || symmetry === "bilateral" && horizontalAngles.length > 1 && horizontalSpan === 180 || symmetry === "none" && horizontalAngles.length > 1 && first === 0 && last === 360;
120
+ if (!validSymmetry)
121
+ throw new Error("Photometry: symmetry does not match horizontal coverage");
122
+ let peak = 0;
123
+ const values = new Float64Array(intensities.length);
124
+ for (let index = 0; index < values.length; index++) {
125
+ const value = intensities[index];
126
+ const scaled = value * intensityScale;
127
+ if (!Number.isFinite(value) || value < 0 || !Number.isFinite(scaled))
128
+ throw new Error("Photometry: invalid calculation intensity");
129
+ values[index] = scaled;
130
+ peak = Math.max(peak, scaled);
131
+ }
132
+ return {
133
+ verticalAngles: Float64Array.from(verticalAngles),
134
+ horizontalAngles: Float64Array.from(horizontalAngles),
135
+ values,
136
+ horizontalSpan,
137
+ peak
138
+ };
139
+ }
140
+ function samplePreparedProfile(profile, verticalAngle, horizontalAngle) {
141
+ const { verticalAngles, horizontalAngles, values, horizontalSpan } = profile;
142
+ if (verticalAngle < verticalAngles[0] || verticalAngle > verticalAngles[verticalAngles.length - 1])
143
+ return 0;
144
+ const verticalIndex = findLowerAngle(verticalAngles, verticalAngle);
145
+ const verticalWeight = (verticalAngle - verticalAngles[verticalIndex]) / (verticalAngles[verticalIndex + 1] - verticalAngles[verticalIndex]);
146
+ let horizontalIndex = 0;
147
+ let horizontalWeight = 0;
148
+ if (horizontalSpan > 0) {
149
+ const period = horizontalSpan === 360 ? 360 : horizontalSpan * 2;
150
+ let folded = ((horizontalAngle - horizontalAngles[0]) % period + period) % period;
151
+ if (folded > horizontalSpan)
152
+ folded = period - folded;
153
+ const measuredAngle = horizontalAngles[0] + folded;
154
+ horizontalIndex = findLowerAngle(horizontalAngles, measuredAngle);
155
+ horizontalWeight = (measuredAngle - horizontalAngles[horizontalIndex]) / (horizontalAngles[horizontalIndex + 1] - horizontalAngles[horizontalIndex]);
156
+ }
157
+ const lowerOffset = horizontalIndex * verticalAngles.length + verticalIndex;
158
+ const upperOffset = horizontalSpan === 0 ? lowerOffset : lowerOffset + verticalAngles.length;
159
+ const lowerValue = values[lowerOffset] + (values[lowerOffset + 1] - values[lowerOffset]) * verticalWeight;
160
+ const upperValue = values[upperOffset] + (values[upperOffset + 1] - values[upperOffset]) * verticalWeight;
161
+ return lowerValue + (upperValue - lowerValue) * horizontalWeight;
162
+ }
163
+ function findLowerAngle(angles, angle) {
164
+ let lower = 0;
165
+ let upper = angles.length - 1;
166
+ while (upper - lower > 1) {
167
+ const midpoint = Math.floor((lower + upper) / 2);
168
+ if (angle < angles[midpoint])
169
+ upper = midpoint;
170
+ else
171
+ lower = midpoint;
172
+ }
173
+ return Math.min(lower, angles.length - 2);
174
+ }
175
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1,6 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/lighting/index.ts", "../../src/lighting/photometry.ts"],
4
+ "mappings": "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",
5
+ "names": []
6
+ }
@@ -0,0 +1,4 @@
1
+ export { createPhotometricSampler, integrateLuminousFlux, resamplePhotometricProfile } from "./photometry.js";
2
+ export type { PhotometricSampler, PhotometricGrid, PhotometricResampleOptions } from "./photometry.js";
3
+ export type { PhotometricProfile, PhotometricSymmetry } from "./lighting-types.js";
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lighting/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC3B,wBAAqB;AACtB,YAAY,EAAC,kBAAkB,EAAE,eAAe,EAAE,0BAA0B,EAAC,wBAAqB;AAClG,YAAY,EAAC,kBAAkB,EAAE,mBAAmB,EAAC,4BAAyB"}
@@ -0,0 +1,5 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ export { createPhotometricSampler, integrateLuminousFlux, resamplePhotometricProfile } from "./photometry.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lighting/index.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAC5D,OAAO,EACL,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC3B,wBAAqB"}
@@ -0,0 +1,16 @@
1
+ /** Explicit azimuth extension rule; never inferred from a file or its metadata. */
2
+ export type PhotometricSymmetry = 'rotational' | 'quadrant' | 'bilateral' | 'none';
3
+ /** Format-independent polar/azimuth intensity measurements in degrees and candela. */
4
+ export type PhotometricProfile = {
5
+ /** Ordered polar angles in [0, 180], measured from an application-chosen pole. */
6
+ verticalAngles: ArrayLike<number>;
7
+ /** Ordered azimuth angles in [0, 360], relative to an application-chosen origin. */
8
+ horizontalAngles: ArrayLike<number>;
9
+ /** Candela samples, vertical angle varying fastest. */
10
+ intensities: ArrayLike<number>;
11
+ /** Uniform intensity multiplier; default 1. No lamp, ballast or file metadata is read. */
12
+ intensityScale?: number;
13
+ /** Explicit rotational, quadrant, bilateral or full-circle interpretation. */
14
+ symmetry: PhotometricSymmetry;
15
+ };
16
+ //# sourceMappingURL=lighting-types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lighting-types.d.ts","sourceRoot":"","sources":["../../src/lighting/lighting-types.ts"],"names":[],"mappings":"AAIA,mFAAmF;AACnF,MAAM,MAAM,mBAAmB,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,MAAM,CAAC;AAEnF,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,kFAAkF;IAClF,cAAc,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,oFAAoF;IACpF,gBAAgB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACpC,uDAAuD;IACvD,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,0FAA0F;IAC1F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,EAAE,mBAAmB,CAAC;CAC/B,CAAC"}
@@ -0,0 +1,5 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+ export {};
5
+ //# sourceMappingURL=lighting-types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lighting-types.js","sourceRoot":"","sources":["../../src/lighting/lighting-types.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D"}
@@ -0,0 +1,36 @@
1
+ import type { PhotometricProfile } from "./lighting-types.js";
2
+ /** Samples a snapshotted polar/azimuth distribution in candela, using angles in degrees. */
3
+ export type PhotometricSampler = (verticalAngle: number, horizontalAngle: number) => number;
4
+ /** Options for a regular, renderer-independent angular grid. */
5
+ export type PhotometricResampleOptions = {
6
+ /** Samples from vertical 0 through 180 degrees, including both endpoints; default 181. */
7
+ verticalCount?: number;
8
+ /** Horizontal samples around [0, 360), excluding the duplicate seam; default 360. */
9
+ horizontalCount?: number;
10
+ /** Preserve candela or divide by the measured peak; default none. */
11
+ normalization?: 'none' | 'peak';
12
+ };
13
+ /** Regular angular samples without texture objects or renderer coordinate transforms. */
14
+ export type PhotometricGrid = {
15
+ /** Vertical samples per row. */
16
+ readonly width: number;
17
+ /** Horizontal rows. */
18
+ readonly height: number;
19
+ /** Row-major intensity samples, vertical angle varying fastest. */
20
+ readonly data: Float64Array;
21
+ /** Vertical sample coordinates in degrees. */
22
+ readonly verticalAngles: Float64Array;
23
+ /** Horizontal sample coordinates in degrees. */
24
+ readonly horizontalAngles: Float64Array;
25
+ /** Physical candela or peak-relative values. */
26
+ readonly unit: 'candela' | 'relative';
27
+ /** Measured peak in candela, before optional normalization. */
28
+ readonly peakCandela: number;
29
+ };
30
+ /** Creates a reusable bilinear sampler; later mutations of the source profile have no effect. */
31
+ export declare function createPhotometricSampler(profile: PhotometricProfile): PhotometricSampler;
32
+ /** Integrates the piecewise bilinear angular distribution over solid angle, returning lumens. */
33
+ export declare function integrateLuminousFlux(profile: PhotometricProfile): number;
34
+ /** Resamples photometry; no image decoding, world-axis conversion or GPU allocation occurs. */
35
+ export declare function resamplePhotometricProfile(profile: PhotometricProfile, options?: PhotometricResampleOptions): PhotometricGrid;
36
+ //# sourceMappingURL=photometry.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"photometry.d.ts","sourceRoot":"","sources":["../../src/lighting/photometry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,kBAAkB,EAAC,4BAAyB;AAEzD,4FAA4F;AAC5F,MAAM,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;AAE5F,gEAAgE;AAChE,MAAM,MAAM,0BAA0B,GAAG;IACvC,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACjC,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,eAAe,GAAG;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC;IACtC,gDAAgD;IAChD,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC;IACxC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,CAAC;AAkBF,iGAAiG;AACjG,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAexF;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAyCzE;AAED,+FAA+F;AAC/F,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,0BAA+B,GACvC,eAAe,CA0CjB"}
@@ -0,0 +1,181 @@
1
+ const DEGREES_TO_RADIANS = Math.PI / 180;
2
+ const MAX_GRID_SAMPLES = 4194304;
3
+ /** Creates a reusable bilinear sampler; later mutations of the source profile have no effect. */
4
+ export function createPhotometricSampler(profile) {
5
+ const prepared = preparePhotometricProfile(profile);
6
+ return (verticalAngle, horizontalAngle) => {
7
+ if (!Number.isFinite(verticalAngle) ||
8
+ verticalAngle < 0 ||
9
+ verticalAngle > 180 ||
10
+ !Number.isFinite(horizontalAngle)) {
11
+ throw new Error('Photometry: sampling requires a vertical angle in [0, 180] and finite horizontal angle');
12
+ }
13
+ return samplePreparedProfile(prepared, verticalAngle, horizontalAngle);
14
+ };
15
+ }
16
+ /** Integrates the piecewise bilinear angular distribution over solid angle, returning lumens. */
17
+ export function integrateLuminousFlux(profile) {
18
+ const prepared = preparePhotometricProfile(profile);
19
+ const { verticalAngles, horizontalAngles, values, horizontalSpan } = prepared;
20
+ const rows = new Float64Array(horizontalAngles.length);
21
+ for (let horizontalIndex = 0; horizontalIndex < rows.length; horizontalIndex++) {
22
+ for (let verticalIndex = 0; verticalIndex < verticalAngles.length - 1; verticalIndex++) {
23
+ const lowerAngle = verticalAngles[verticalIndex];
24
+ const upperAngle = verticalAngles[verticalIndex + 1];
25
+ const reflected = lowerAngle + upperAngle > 180;
26
+ const lower = reflected ? 180 - upperAngle : lowerAngle;
27
+ const upper = reflected ? 180 - lowerAngle : upperAngle;
28
+ const midpoint = ((lower + upper) / 2) * DEGREES_TO_RADIANS;
29
+ const halfWidth = ((upper - lower) / 2) * DEGREES_TO_RADIANS;
30
+ // Stable cos(h) - sin(h)/h, including very narrow angular intervals.
31
+ const squaredWidth = halfWidth * halfWidth;
32
+ const difference = halfWidth < 0.001
33
+ ? squaredWidth * (-1 / 3 + squaredWidth * (1 / 30 - squaredWidth / 840))
34
+ : Math.cos(halfWidth) - Math.sin(halfWidth) / halfWidth;
35
+ const sharedWeight = Math.sin(midpoint) * Math.sin(halfWidth);
36
+ const offsetWeight = Math.cos(midpoint) * difference;
37
+ const lowerWeight = Math.max(0, sharedWeight + offsetWeight);
38
+ const upperWeight = Math.max(0, sharedWeight - offsetWeight);
39
+ const offset = horizontalIndex * verticalAngles.length + verticalIndex;
40
+ rows[horizontalIndex] +=
41
+ values[offset] * (reflected ? upperWeight : lowerWeight) +
42
+ values[offset + 1] * (reflected ? lowerWeight : upperWeight);
43
+ }
44
+ }
45
+ let flux = 0;
46
+ if (horizontalSpan === 0)
47
+ flux = rows[0] * 2 * Math.PI;
48
+ else {
49
+ for (let index = 0; index < rows.length - 1; index++) {
50
+ const angularWidth = (horizontalAngles[index + 1] - horizontalAngles[index]) * DEGREES_TO_RADIANS;
51
+ flux += (rows[index] / 2 + rows[index + 1] / 2) * angularWidth;
52
+ }
53
+ flux *= 360 / horizontalSpan;
54
+ }
55
+ if (!Number.isFinite(flux))
56
+ throw new Error('Photometry: luminous flux overflow');
57
+ return flux;
58
+ }
59
+ /** Resamples photometry; no image decoding, world-axis conversion or GPU allocation occurs. */
60
+ export function resamplePhotometricProfile(profile, options = {}) {
61
+ const { verticalCount = 181, horizontalCount = 360, normalization = 'none' } = options;
62
+ if (!Number.isSafeInteger(verticalCount) ||
63
+ verticalCount < 2 ||
64
+ !Number.isSafeInteger(horizontalCount) ||
65
+ horizontalCount < 1 ||
66
+ verticalCount * horizontalCount > MAX_GRID_SAMPLES ||
67
+ !['none', 'peak'].includes(normalization)) {
68
+ throw new Error('Photometry: invalid resampling dimensions or normalization');
69
+ }
70
+ const prepared = preparePhotometricProfile(profile);
71
+ const verticalAngles = Float64Array.from({ length: verticalCount }, (_, index) => (index * 180) / (verticalCount - 1));
72
+ const horizontalAngles = Float64Array.from({ length: horizontalCount }, (_, index) => (index * 360) / horizontalCount);
73
+ const data = new Float64Array(verticalCount * horizontalCount);
74
+ for (let horizontalIndex = 0; horizontalIndex < horizontalCount; horizontalIndex++) {
75
+ for (let verticalIndex = 0; verticalIndex < verticalCount; verticalIndex++) {
76
+ const intensity = samplePreparedProfile(prepared, verticalAngles[verticalIndex], horizontalAngles[horizontalIndex]);
77
+ data[horizontalIndex * verticalCount + verticalIndex] =
78
+ normalization === 'peak' ? (prepared.peak > 0 ? intensity / prepared.peak : 0) : intensity;
79
+ }
80
+ }
81
+ return {
82
+ width: verticalCount,
83
+ height: horizontalCount,
84
+ data,
85
+ verticalAngles,
86
+ horizontalAngles,
87
+ unit: normalization === 'peak' ? 'relative' : 'candela',
88
+ peakCandela: prepared.peak
89
+ };
90
+ }
91
+ /** Validates and snapshots only the angular and intensity fields used by the calculations. */
92
+ function preparePhotometricProfile(profile) {
93
+ const { verticalAngles, horizontalAngles, intensities, intensityScale = 1, symmetry } = profile;
94
+ if (verticalAngles.length < 2 ||
95
+ horizontalAngles.length < 1 ||
96
+ intensities.length !== verticalAngles.length * horizontalAngles.length ||
97
+ !Number.isFinite(intensityScale) ||
98
+ intensityScale < 0) {
99
+ throw new Error('Photometry: invalid calculation profile');
100
+ }
101
+ for (const [angles, maximum] of [
102
+ [verticalAngles, 180],
103
+ [horizontalAngles, 360]
104
+ ]) {
105
+ for (let index = 0; index < angles.length; index++) {
106
+ if (!Number.isFinite(angles[index]) ||
107
+ angles[index] < 0 ||
108
+ angles[index] > maximum ||
109
+ (index > 0 && angles[index] <= angles[index - 1]))
110
+ throw new Error('Photometry: invalid calculation angles');
111
+ }
112
+ }
113
+ const first = horizontalAngles[0];
114
+ const last = horizontalAngles[horizontalAngles.length - 1];
115
+ const horizontalSpan = last - first;
116
+ const validSymmetry = (symmetry === 'rotational' && horizontalAngles.length === 1) ||
117
+ (symmetry === 'quadrant' && horizontalAngles.length > 1 && first === 0 && last === 90) ||
118
+ (symmetry === 'bilateral' && horizontalAngles.length > 1 && horizontalSpan === 180) ||
119
+ (symmetry === 'none' && horizontalAngles.length > 1 && first === 0 && last === 360);
120
+ if (!validSymmetry)
121
+ throw new Error('Photometry: symmetry does not match horizontal coverage');
122
+ let peak = 0;
123
+ const values = new Float64Array(intensities.length);
124
+ for (let index = 0; index < values.length; index++) {
125
+ const value = intensities[index];
126
+ const scaled = value * intensityScale;
127
+ if (!Number.isFinite(value) || value < 0 || !Number.isFinite(scaled))
128
+ throw new Error('Photometry: invalid calculation intensity');
129
+ values[index] = scaled;
130
+ peak = Math.max(peak, scaled);
131
+ }
132
+ return {
133
+ verticalAngles: Float64Array.from(verticalAngles),
134
+ horizontalAngles: Float64Array.from(horizontalAngles),
135
+ values,
136
+ horizontalSpan,
137
+ peak
138
+ };
139
+ }
140
+ /** Samples a validated snapshot, returning zero outside its measured vertical extent. */
141
+ function samplePreparedProfile(profile, verticalAngle, horizontalAngle) {
142
+ const { verticalAngles, horizontalAngles, values, horizontalSpan } = profile;
143
+ if (verticalAngle < verticalAngles[0] ||
144
+ verticalAngle > verticalAngles[verticalAngles.length - 1])
145
+ return 0;
146
+ const verticalIndex = findLowerAngle(verticalAngles, verticalAngle);
147
+ const verticalWeight = (verticalAngle - verticalAngles[verticalIndex]) /
148
+ (verticalAngles[verticalIndex + 1] - verticalAngles[verticalIndex]);
149
+ let horizontalIndex = 0;
150
+ let horizontalWeight = 0;
151
+ if (horizontalSpan > 0) {
152
+ const period = horizontalSpan === 360 ? 360 : horizontalSpan * 2;
153
+ let folded = (((horizontalAngle - horizontalAngles[0]) % period) + period) % period;
154
+ if (folded > horizontalSpan)
155
+ folded = period - folded;
156
+ const measuredAngle = horizontalAngles[0] + folded;
157
+ horizontalIndex = findLowerAngle(horizontalAngles, measuredAngle);
158
+ horizontalWeight =
159
+ (measuredAngle - horizontalAngles[horizontalIndex]) /
160
+ (horizontalAngles[horizontalIndex + 1] - horizontalAngles[horizontalIndex]);
161
+ }
162
+ const lowerOffset = horizontalIndex * verticalAngles.length + verticalIndex;
163
+ const upperOffset = horizontalSpan === 0 ? lowerOffset : lowerOffset + verticalAngles.length;
164
+ const lowerValue = values[lowerOffset] + (values[lowerOffset + 1] - values[lowerOffset]) * verticalWeight;
165
+ const upperValue = values[upperOffset] + (values[upperOffset + 1] - values[upperOffset]) * verticalWeight;
166
+ return lowerValue + (upperValue - lowerValue) * horizontalWeight;
167
+ }
168
+ /** Finds the lower knot, keeping the final coordinate in the last interval. */
169
+ function findLowerAngle(angles, angle) {
170
+ let lower = 0;
171
+ let upper = angles.length - 1;
172
+ while (upper - lower > 1) {
173
+ const midpoint = Math.floor((lower + upper) / 2);
174
+ if (angle < angles[midpoint])
175
+ upper = midpoint;
176
+ else
177
+ lower = midpoint;
178
+ }
179
+ return Math.min(lower, angles.length - 2);
180
+ }
181
+ //# sourceMappingURL=photometry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"photometry.js","sourceRoot":"","sources":["../../src/lighting/photometry.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,44 @@
1
+ /** A finite, continuous source box with ordered minimum and maximum coordinates. */
2
+ export type ProjectionSourceBounds = readonly [ArrayLike<number>, ArrayLike<number>];
3
+ /** Controls bounded sampling of a prepared synchronous coordinate transform. */
4
+ export type ProjectBoundsOptions = {
5
+ /** Receives a fresh source array. Null/nonfinite output rejects the whole result.
6
+ * Exceptions propagate unchanged; no projection engine is imported by this helper.
7
+ */
8
+ transform: (position: readonly number[]) => ArrayLike<number> | null;
9
+ /** Output dimension, 2 or 3. Defaults to the source dimension. */
10
+ targetSize?: 2 | 3;
11
+ /** Equal subdivisions on each nonzero source axis. Positive integer; default 8. */
12
+ subdivisions?: number;
13
+ /** Maximum transform calls. Positive safe integer; default 262144. */
14
+ maxSamples?: number;
15
+ /** Optional caller-qualified global Lipschitz constant for EACH output component,
16
+ * measured against Euclidean source distance over the ENTIRE source box.
17
+ * Requires a finite continuous transform throughout the box, not merely at samples.
18
+ * This contract cannot be inferred or verified from point samples.
19
+ */
20
+ lipschitz?: readonly number[];
21
+ };
22
+ /** Detached bounds plus an explicit qualification; invalid results never expose partial bounds. */
23
+ export type ProjectedBoundsResult = {
24
+ /** 'sampled' is for approximate fitting only; 'conservative' requires the supplied contract. */
25
+ status: 'sampled' | 'conservative';
26
+ /** Output minimum and maximum vectors; safe for culling only in conservative mode. */
27
+ bounds: [number[], number[]];
28
+ /** Number of transform calls. */
29
+ sampleCount: number;
30
+ } | {
31
+ /** A null/nonfinite transform sample or unrepresentable enclosure was encountered. */
32
+ status: 'invalid';
33
+ /** No partial result is safe to use. */
34
+ bounds: null;
35
+ /** Number of transform calls, including an invalid sample if applicable. */
36
+ sampleCount: number;
37
+ };
38
+ /** Projects a lattice covering corners, edges, faces and the interior of a 2D/3D box.
39
+ * Sampling alone cannot establish an enclosure for a nonlinear transform. When qualified
40
+ * global Lipschitz constants are supplied, inflate by the lattice covering radius instead
41
+ * of claiming corner/sample extrema are conservative. Split seams and domains beforehand.
42
+ */
43
+ export declare function projectBounds(sourceBounds: ProjectionSourceBounds, options: ProjectBoundsOptions): ProjectedBoundsResult;
44
+ //# sourceMappingURL=project-bounds.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-bounds.d.ts","sourceRoot":"","sources":["../../src/utils/project-bounds.ts"],"names":[],"mappings":"AAIA,oFAAoF;AACpF,MAAM,MAAM,sBAAsB,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAErF,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,SAAS,EAAE,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,KAAK,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACrE,kEAAkE;IAClE,UAAU,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,mGAAmG;AACnG,MAAM,MAAM,qBAAqB,GAC7B;IACE,gGAAgG;IAChG,MAAM,EAAE,SAAS,GAAG,cAAc,CAAC;IACnC,sFAAsF;IACtF,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,sFAAsF;IACtF,MAAM,EAAE,SAAS,CAAC;IAClB,wCAAwC;IACxC,MAAM,EAAE,IAAI,CAAC;IACb,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,sBAAsB,EACpC,OAAO,EAAE,oBAAoB,GAC5B,qBAAqB,CAmGvB"}