@arcgis/core 5.2.0-next.163 → 5.2.0-next.165

package/form/elements/inputs.d.ts

@@ -41,6 +41,7 @@
  * }
  * ```
  *
+ * @deprecated since 5.2. Import individual input modules directly instead.
  * @since 4.16
  * @see [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/)
  * @see [FieldElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/FieldElement/)
@@ -70,77 +71,177 @@ import type TextAreaInputClass from "./inputs/TextAreaInput.js";
 import type TextBoxInputClass from "./inputs/TextBoxInput.js";
 import type TimePickerInputClass from "./inputs/TimePickerInput.js";
 
-/** Form element input types. */
+/**
+ * Form element input types.
+ *
+ * @deprecated since 5.2. Import [Input](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/Input/) directly instead.
+ */
 export type Input = BarcodeScannerInputClass | ComboBoxInputClass | DatePickerInputClass | DateTimeOffsetPickerInputClass | DateTimePickerInputClass | DynamicChoiceInputClass | MultipleChoiceInputClass | RadioButtonsInputClass | SwitchInputClass | TextAreaInputClass | TextBoxInputClass | TimePickerInputClass;
 
-/** The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type. */
+/**
+ * The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type.
+ *
+ * @deprecated since 5.2. Import [BarcodeScannerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/BarcodeScannerInput/) directly instead.
+ */
 export const BarcodeScannerInput: typeof BarcodeScannerInputClass;
 
-/** The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type. */
+/**
+ * The `BarcodeScannerInput` class defines the desired user interface for a barcode or QR code scanner. If this type is used in an ArcGIS Maps SDK for JavaScript web application, it will default to the [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) type as the API does not support bar code scanning as an input type.
+ *
+ * @deprecated since 5.2. Import [BarcodeScannerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/BarcodeScannerInput/) directly instead.
+ */
 export type BarcodeScannerInput = BarcodeScannerInputClass;
 
-/** The `ComboBoxInput` class defines the desired user interface for a combo box group. */
+/**
+ * The `ComboBoxInput` class defines the desired user interface for a combo box group.
+ *
+ * @deprecated since 5.2. Import [ComboBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/ComboBoxInput/) directly instead.
+ */
 export const ComboBoxInput: typeof ComboBoxInputClass;
 
-/** The `ComboBoxInput` class defines the desired user interface for a combo box group. */
+/**
+ * The `ComboBoxInput` class defines the desired user interface for a combo box group.
+ *
+ * @deprecated since 5.2. Import [ComboBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/ComboBoxInput/) directly instead.
+ */
 export type ComboBoxInput = ComboBoxInputClass;
 
-/** The `DatePickerInput` class defines the desired user interface for working with date-only types. */
+/**
+ * The `DatePickerInput` class defines the desired user interface for working with date-only types.
+ *
+ * @deprecated since 5.2. Import [DatePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DatePickerInput/) directly instead.
+ */
 export const DatePickerInput: typeof DatePickerInputClass;
 
-/** The `DatePickerInput` class defines the desired user interface for working with date-only types. */
+/**
+ * The `DatePickerInput` class defines the desired user interface for working with date-only types.
+ *
+ * @deprecated since 5.2. Import [DatePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DatePickerInput/) directly instead.
+ */
 export type DatePickerInput = DatePickerInputClass;
 
-/** The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC). */
+/**
+ * The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC).
+ *
+ * @deprecated since 5.2. Import [DateTimeOffsetPickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimeOffsetPickerInput/) directly instead.
+ */
 export const DateTimeOffsetPickerInput: typeof DateTimeOffsetPickerInputClass;
 
-/** The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC). */
+/**
+ * The `DateTimeOffsetPickerInput` class defines the desired user interface for editing date and time fields in a form that also requires the option to include an offset from Coordinated Universal Time (UTC).
+ *
+ * @deprecated since 5.2. Import [DateTimeOffsetPickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimeOffsetPickerInput/) directly instead.
+ */
 export type DateTimeOffsetPickerInput = DateTimeOffsetPickerInputClass;
 
-/** The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form. */
+/**
+ * The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form.
+ *
+ * @deprecated since 5.2. Import [DateTimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimePickerInput/) directly instead.
+ */
 export const DateTimePickerInput: typeof DateTimePickerInputClass;
 
-/** The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form. */
+/**
+ * The `DateTimePickerInput` class defines the desired user interface for editing date (including time) fields in a form.
+ *
+ * @deprecated since 5.2. Import [DateTimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DateTimePickerInput/) directly instead.
+ */
 export type DateTimePickerInput = DateTimePickerInputClass;
 
-/** The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group. */
+/**
+ * The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group.
+ *
+ * @deprecated since 5.2. Import [DynamicChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DynamicChoiceInput/) directly instead.
+ */
 export const DynamicChoiceInput: typeof DynamicChoiceInputClass;
 
-/** The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group. */
+/**
+ * The `DynamicChoiceInput` class defines the desired user interface for a dynamically generated choice group.
+ *
+ * @deprecated since 5.2. Import [DynamicChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/DynamicChoiceInput/) directly instead.
+ */
 export type DynamicChoiceInput = DynamicChoiceInputClass;
 
-/** The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group. */
+/**
+ * The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group.
+ *
+ * @deprecated since 5.2. Import [MultipleChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/MultipleChoiceInput/) directly instead.
+ */
 export const MultipleChoiceInput: typeof MultipleChoiceInputClass;
 
-/** The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group. */
+/**
+ * The `MultipleChoiceInput` class defines the desired user interface for a multiple choice group.
+ *
+ * @deprecated since 5.2. Import [MultipleChoiceInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/MultipleChoiceInput/) directly instead.
+ */
 export type MultipleChoiceInput = MultipleChoiceInputClass;
 
-/** The `RadioButtonsInput` class defines the desired user interface for a radio button group. */
+/**
+ * The `RadioButtonsInput` class defines the desired user interface for a radio button group.
+ *
+ * @deprecated since 5.2. Import [RadioButtonsInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/RadioButtonsInput/) directly instead.
+ */
 export const RadioButtonsInput: typeof RadioButtonsInputClass;
 
-/** The `RadioButtonsInput` class defines the desired user interface for a radio button group. */
+/**
+ * The `RadioButtonsInput` class defines the desired user interface for a radio button group.
+ *
+ * @deprecated since 5.2. Import [RadioButtonsInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/RadioButtonsInput/) directly instead.
+ */
 export type RadioButtonsInput = RadioButtonsInputClass;
 
-/** The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form. */
+/**
+ * The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form.
+ *
+ * @deprecated since 5.2. Import [SwitchInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/SwitchInput/) directly instead.
+ */
 export const SwitchInput: typeof SwitchInputClass;
 
-/** The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form. */
+/**
+ * The `SwitchInput` class defines the desired user interface for a binary switch or toggle. This should be used when selecting between two options in a form.
+ *
+ * @deprecated since 5.2. Import [SwitchInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/SwitchInput/) directly instead.
+ */
 export type SwitchInput = SwitchInputClass;
 
-/** `TextAreaInput` defines the desired user interface for a multi-line text area. */
+/**
+ * `TextAreaInput` defines the desired user interface for a multi-line text area.
+ *
+ * @deprecated since 5.2. Import [TextAreaInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextAreaInput/) directly instead.
+ */
 export const TextAreaInput: typeof TextAreaInputClass;
 
-/** `TextAreaInput` defines the desired user interface for a multi-line text area. */
+/**
+ * `TextAreaInput` defines the desired user interface for a multi-line text area.
+ *
+ * @deprecated since 5.2. Import [TextAreaInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextAreaInput/) directly instead.
+ */
 export type TextAreaInput = TextAreaInputClass;
 
-/** `TextBoxInput` defines the desired user interface for a single-line text box. */
+/**
+ * `TextBoxInput` defines the desired user interface for a single-line text box.
+ *
+ * @deprecated since 5.2. Import [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) directly instead.
+ */
 export const TextBoxInput: typeof TextBoxInputClass;
 
-/** `TextBoxInput` defines the desired user interface for a single-line text box. */
+/**
+ * `TextBoxInput` defines the desired user interface for a single-line text box.
+ *
+ * @deprecated since 5.2. Import [TextBoxInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TextBoxInput/) directly instead.
+ */
 export type TextBoxInput = TextBoxInputClass;
 
-/** The `TimePickerInput` class defines the desired user interface for working with time-only types. */
+/**
+ * The `TimePickerInput` class defines the desired user interface for working with time-only types.
+ *
+ * @deprecated since 5.2. Import [TimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TimePickerInput/) directly instead.
+ */
 export const TimePickerInput: typeof TimePickerInputClass;
 
-/** The `TimePickerInput` class defines the desired user interface for working with time-only types. */
+/**
+ * The `TimePickerInput` class defines the desired user interface for working with time-only types.
+ *
+ * @deprecated since 5.2. Import [TimePickerInput](https://developers.arcgis.com/javascript/latest/references/core/form/elements/inputs/TimePickerInput/) directly instead.
+ */
 export type TimePickerInput = TimePickerInputClass;

package/form/elements/inputs.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import e from"./inputs/BarcodeScannerInput.js";import t from"./inputs/ComboBoxInput.js";import n from"./inputs/DatePickerInput.js";import r from"./inputs/DateTimeOffsetPickerInput.js";import i from"./inputs/DateTimePickerInput.js";import a from"./inputs/DynamicChoiceInput.js";import o from"./inputs/Input.js";import s from"./inputs/MultipleChoiceInput.js";import c from"./inputs/RadioButtonsInput.js";import l from"./inputs/SwitchInput.js";import u from"./inputs/TextAreaInput.js";import d from"./inputs/TextBoxInput.js";import f from"./inputs/TimePickerInput.js";const p=e,m=t,h=n,g=r,_=i,v=a,y=s,b=c,x=l,S=u,C=d,w=f,T={base:o,key:`type`,typeMap:{"barcode-scanner":p,"combo-box":m,"date-picker":h,"datetime-picker":_,"dynamic-choice":v,"multiple-choice":y,"timestampoffset-picker":g,"datetimeoffset-picker":g,"radio-buttons":b,switch:x,"text-area":S,"text-box":C,"time-picker":w}};export{p as BarcodeScannerInput,m as ComboBoxInput,h as DatePickerInput,g as DateTimeOffsetPickerInput,_ as DateTimePickerInput,v as DynamicChoiceInput,y as MultipleChoiceInput,b as RadioButtonsInput,x as SwitchInput,S as TextAreaInput,C as TextBoxInput,w as TimePickerInput,T as types};
+import{deprecatedModule as e}from"../../core/deprecate.js";import t from"../../core/Logger.js";import n from"./inputs/BarcodeScannerInput.js";import r from"./inputs/ComboBoxInput.js";import i from"./inputs/DatePickerInput.js";import a from"./inputs/DateTimeOffsetPickerInput.js";import o from"./inputs/DateTimePickerInput.js";import s from"./inputs/DynamicChoiceInput.js";import c from"./inputs/Input.js";import l from"./inputs/MultipleChoiceInput.js";import u from"./inputs/RadioButtonsInput.js";import d from"./inputs/SwitchInput.js";import f from"./inputs/TextAreaInput.js";import p from"./inputs/TextBoxInput.js";import m from"./inputs/TimePickerInput.js";e(t.getLogger(`esri.form.elements.inputs`),`esri.form.elements.inputs`,{replacement:`Individual input module imports`,version:`5.2`,warnOnce:!0});const h=n,g=r,_=i,v=a,y=o,b=s,x=l,S=u,C=d,w=f,T=p,E=m,D={base:c,key:`type`,typeMap:{"barcode-scanner":h,"combo-box":g,"date-picker":_,"datetime-picker":y,"dynamic-choice":b,"multiple-choice":x,"timestampoffset-picker":v,"datetimeoffset-picker":v,"radio-buttons":S,switch:C,"text-area":w,"text-box":T,"time-picker":E}};export{h as BarcodeScannerInput,g as ComboBoxInput,_ as DatePickerInput,v as DateTimeOffsetPickerInput,y as DateTimePickerInput,b as DynamicChoiceInput,x as MultipleChoiceInput,S as RadioButtonsInput,C as SwitchInput,w as TextAreaInput,T as TextBoxInput,E as TimePickerInput,D as types};

package/form/elements.d.ts

@@ -34,6 +34,7 @@
  * }
  * ```
  *
+ * @deprecated since 5.2. Import individual element modules directly instead.
  * @since 4.16
  * @see [FormTemplate](https://developers.arcgis.com/javascript/latest/references/core/form/FormTemplate/)
  * @see [AttachmentElement](https://developers.arcgis.com/javascript/latest/references/core/form/elements/AttachmentElement/)

package/geometry/support/clipRay.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{ObjectStack as e}from"../../core/ObjectStack.js";import{length as t,add as n,scale as r}from"../../core/libs/gl-matrix-2/math/vec3.js";import{copy as i,fromValues as a,create as o}from"./ray.js";function s(e){return e?{ray:o(e.ray),c0:e.c0,c1:e.c1}:{ray:o(),c0:0,c1:Number.MAX_VALUE}}function c(e,t,n){let r=g.get();return r.ray=e,r.c0=t,r.c1=n,r}function l(e,t=s()){return u(e.ray,e.c0,e.c1,t)}function u(e,t,n,r=s()){return i(e,r.ray),r.c0=t,r.c1=n,r}function d(e,t=s()){return i(e,t.ray),t.c0=0,t.c1=Number.MAX_VALUE,t}function f(e,n,r=s()){let i=t(e.vector);return a(e.origin,n,r.ray),r.c0=0,r.c1=i,r}function p(e,t){return h(e,e.c0,t)}function m(e,t){return h(e,e.c1,t)}function h(e,t,i){return n(i,e.ray.origin,r(i,e.ray.direction,t))}const g=new e(()=>s());export{l as copy,s as create,f as fromLineSegmentAndDirection,d as fromRay,u as fromValues,h as getAt,m as getEnd,p as getStart,c as wrap};
+import{ObjectStack as e}from"../../core/ObjectStack.js";import{length as t,add as n,scale as r}from"../../core/libs/gl-matrix-2/math/vec3.js";import{copy as i,fromValues as a,create as o}from"./ray.js";function s(e){return e?{ray:o(e.ray),c0:e.c0,c1:e.c1}:{ray:o(),c0:0,c1:Number.MAX_VALUE}}function c(e,t,n){let r=_.get();return r.ray=e,r.c0=t,r.c1=n,r}function l(e,t=s()){return u(e.ray,e.c0,e.c1,t)}function u(e,t,n,r=s()){return i(e,r.ray),r.c0=t,r.c1=n,r}function d(e,t=s()){return i(e,t.ray),t.c0=0,t.c1=Number.MAX_VALUE,t}function f(e,n,r=s()){let i=t(e.vector);return a(e.origin,n,r.ray),r.c0=0,r.c1=i,r}function p(e,t){return h(e,e.c0,t)}function m(e,t){return h(e,e.c1,t)}function h(e,t,i){return n(i,e.ray.origin,r(i,e.ray.direction,t))}function g(e,t,n,r){let i=r.ray.origin[e],a=r.ray.direction[e];if(Math.abs(a)<=2**-52)return r.c0<=r.c1&&i>=t&&i<=n;let o=(t-i)/a,s=(n-i)/a;return r.c0=Math.max(r.c0,Math.min(o,s)),r.c1=Math.min(r.c1,Math.max(o,s)),r.c0<=r.c1}const _=new e(()=>s());export{g as clipSlab,l as copy,s as create,f as fromLineSegmentAndDirection,d as fromRay,u as fromValues,h as getAt,m as getEnd,p as getStart,c as wrap};

package/geometry/support/plane.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{clamp as e}from"../../core/mathUtils.js";import{exactEquals as t,subtract as n,normalize as r,dot as i,lerp as a,copy as o,add as s,scale as c,cross as l,set as u,scaleAndAdd as d}from"../../core/libs/gl-matrix-2/math/vec3.js";import{create as f}from"../../core/libs/gl-matrix-2/factories/vec3f64.js";import{equals as p,exactEquals as m}from"../../core/libs/gl-matrix-2/math/vec4.js";import{projectPointSignedLength as h}from"./vector.js";import{sv3d as g,sv4d as ee}from"./vectorStacks.js";import{tangentFrame as te}from"../../views/3d/support/mathUtils.js";function _(e=Z){return[e[0],e[1],e[2],e[3]]}const v=m,ne=p;function re(e=Z[0],t=Z[1],n=Z[2],r=Z[3]){return x(e,t,n,r,ee.get())}function y(e,t){return x(t[0],t[1],t[2],t[3],e)}function b(e){return e}function x(e,t,n,r,i=_()){return i[0]=e,i[1]=t,i[2]=n,i[3]=r,i}function S(e,t,n){return o(n,e),n[3]=t,n}function C(e,t,n){let r=t[0]*t[0]+t[1]*t[1]+t[2]*t[2],i=Math.abs(r-1)>1e-5&&r>1e-12?1/Math.sqrt(r):1;return n[0]=t[0]*i,n[1]=t[1]*i,n[2]=t[2]*i,n[3]=-(n[0]*e[0]+n[1]*e[1]+n[2]*e[2]),n}function w(e,t,n,r=_()){let i=n[0]-t[0],a=n[1]-t[1],o=n[2]-t[2],s=e[0]-t[0],c=e[1]-t[1],l=e[2]-t[2],u=a*l-o*c,d=o*s-i*l,f=i*c-a*s,p=u*u+d*d+f*f,m=Math.abs(p-1)>1e-5&&p>1e-12?1/Math.sqrt(p):1;return r[0]=u*m,r[1]=d*m,r[2]=f*m,r[3]=-(r[0]*e[0]+r[1]*e[1]+r[2]*e[2]),r}function T(e,a,o,s=0,c=Math.floor(1/3*o),l=Math.floor(2/3*o)){if(o<3)return!1;a(D,s);let u=c,d=!1;for(;u<o-1&&!d;)a(O,u),u++,d=!t(D,O);if(!d)return!1;for(u=Math.max(u,l),d=!1;u<o&&!d;)a(k,u),u++,n(A,D,O),r(A,A),n(j,O,k),r(j,j),d=!t(D,k)&&!t(O,k)&&Math.abs(i(A,j))<E;return d?(w(D,O,k,e),!0):s===0&&c===1&&l===2?!1:T(e,a,o,0,1,2)}function ie(e,t,n=!0){let r=t.length/3;return T(e,(e,n)=>u(e,t[n*3+0],t[n*3+1],t[n*3+2]),n?r-1:r)}const E=.99619469809,D=f(),O=f(),k=f(),A=f(),j=f();function ae(e,t,n){return t!==e&&y(e,t),e[3]=-i(b(e),n),e}function M(e,t){return t[0]=-e[0],t[1]=-e[1],t[2]=-e[2],t[3]=-e[3],t}function oe(e,t,n,r){return l(k,t,e),C(n,k,r)}function N(e,t,r,i){return Y(X(e,t,n(g.get(),r,t),le,i))}function P(e,t,n){return t!=null&&Y(X(e,t.origin,t.direction,ue,n))}function F(e,t,n){return Y(X(e,t.origin,t.vector,0,n))}function I(e,t,n){return Y(X(e,t.origin,t.vector,1,n))}function L(e,t){return J(e,t)<=0}function R(e,t){return J(e,t)>=0}function z(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!0)}function B(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!1)}function V(e,t,n,r,a,o,s){let c=i(b(e),n),l=J(e,t);if(c>-1e-6&&c<1e-6)return H(l,a,o);let u=-l/c,d=H(c,a,!1);return s&&!d&&!H(l,a,o)?!1:(d?u>r.c0&&(r.c0=u):u<r.c1&&(r.c1=u),r.c0<=r.c1)}function H(e,t,n){return n?t?e>=0:e<=0:t?e>0:e<0}function U(e,t,n,r=!1){let i=t.at(-1),s=J(e,i),c=r?s>0:s<=0;for(let l=0;l<t.length;l++){let u=t.at(l),d=J(e,u),f=r?d>0:d<=0;c!==f&&a(n(),i,u,s/(s-d)),f&&o(n(),u),i=u,s=d,c=f}}function W(e,t,r,i,a,o=!1){return n(Q,r,t),$.c0=0,$.c1=1,V(e,t,Q,$,o,!o,!1)?(d(i,t,Q,$.c0),d(a,t,Q,$.c1),!0):!1}function G(e,t,r){let i=c(g.get(),b(e),-e[3]),a=q(e,n(g.get(),t,i),g.get());return s(r,a,i),r}function K(e,t,r,i){let a=b(e),o=g.get(),s=g.get();te(a,o,s);let c=n(g.get(),r,t),l=h(o,c),d=h(s,c),f=h(a,c);return u(i,l,d,f)}function q(e,t,r){let a=c(g.get(),b(e),i(b(e),t));return n(r,t,a),r}function se(e,t){return Math.abs(J(e,t))}function J(e,t){return i(b(e),t)+e[3]}function ce(e,t,n){for(let r=0;r<n;++r)if(L(e,t[r]))return!1;return!0}function Y(e){return e===0||e===1}function X(t,n,r,a,o){let l=i(b(t),r),u=J(t,n);if(l===0)return u>=0?2:3;let d=-u/l;return a&1&&(d=e(d,0,1)),!(a&4)&&d<0||!(a&8)&&d>1?u>=0?2:3:(s(o,n,c(o,r,d)),u>=0?0:1)}const Z=[0,0,1,0],le=12,ue=8,Q=f(),$={c0:0,c1:1};export{ce as areAllPointsOutside,z as clip,B as clipInfinite,W as clipLineSegment,U as clipPolygon,y as copy,_ as create,se as distance,ne as equals,v as exactEquals,ie as fromArray,T as fromManyPoints,S as fromNormalAndOffset,w as fromPoints,C as fromPositionAndNormal,x as fromValues,oe as fromVectorsAndPoint,b as getNormal,N as intersectLine,X as intersectLineOrRay,F as intersectLineSegment,I as intersectLineSegmentClamp,P as intersectRay,R as isPointInClosedPositiveHalfspace,L as isPointInside,M as negate,G as projectPoint,K as projectPointLocal,q as projectVector,ae as setOffsetFromPoint,J as signedDistance,Z as up,re as wrap};
+import{clamp as e}from"../../core/mathUtils.js";import{exactEquals as t,subtract as n,normalize as r,dot as i,lerp as a,copy as o,add as s,scale as c,cross as l,set as u,scaleAndAdd as d}from"../../core/libs/gl-matrix-2/math/vec3.js";import{create as f}from"../../core/libs/gl-matrix-2/factories/vec3f64.js";import{equals as p,exactEquals as m}from"../../core/libs/gl-matrix-2/math/vec4.js";import{projectPointSignedLength as h}from"./vector.js";import{sv3d as g,sv4d as _}from"./vectorStacks.js";import{tangentFrame as ee}from"../../views/3d/support/mathUtils.js";function v(e=Z){return[e[0],e[1],e[2],e[3]]}const te=m,ne=p;function re(e=Z[0],t=Z[1],n=Z[2],r=Z[3]){return x(e,t,n,r,_.get())}function y(e,t){return x(t[0],t[1],t[2],t[3],e)}function b(e){return e}function x(e,t,n,r,i=v()){return i[0]=e,i[1]=t,i[2]=n,i[3]=r,i}function S(e,t,n){return o(n,e),n[3]=t,n}function C(e,t,n){let r=t[0]*t[0]+t[1]*t[1]+t[2]*t[2],i=Math.abs(r-1)>1e-5&&r>1e-12?1/Math.sqrt(r):1;return n[0]=t[0]*i,n[1]=t[1]*i,n[2]=t[2]*i,n[3]=-(n[0]*e[0]+n[1]*e[1]+n[2]*e[2]),n}function w(e,t,n,r=v()){let i=n[0]-t[0],a=n[1]-t[1],o=n[2]-t[2],s=e[0]-t[0],c=e[1]-t[1],l=e[2]-t[2],u=a*l-o*c,d=o*s-i*l,f=i*c-a*s,p=u*u+d*d+f*f,m=Math.abs(p-1)>1e-5&&p>1e-12?1/Math.sqrt(p):1;return r[0]=u*m,r[1]=d*m,r[2]=f*m,r[3]=-(r[0]*e[0]+r[1]*e[1]+r[2]*e[2]),r}function T(e,a,o,s=0,c=Math.floor(1/3*o),l=Math.floor(2/3*o)){if(o<3)return!1;a(D,s);let u=c,d=!1;for(;u<o-1&&!d;)a(O,u),u++,d=!t(D,O);if(!d)return!1;for(u=Math.max(u,l),d=!1;u<o&&!d;)a(k,u),u++,n(A,D,O),r(A,A),n(j,O,k),r(j,j),d=!t(D,k)&&!t(O,k)&&Math.abs(i(A,j))<ie;return d?(w(D,O,k,e),!0):s===0&&c===1&&l===2?!1:T(e,a,o,0,1,2)}function E(e,t,n=!0){let r=t.length/3;return T(e,(e,n)=>u(e,t[n*3+0],t[n*3+1],t[n*3+2]),n?r-1:r)}const ie=.99619469809,D=f(),O=f(),k=f(),A=f(),j=f();function ae(e,t,n){return t!==e&&y(e,t),e[3]=-i(b(e),n),e}function oe(e,t){return t[0]=-e[0],t[1]=-e[1],t[2]=-e[2],t[3]=-e[3],t}function se(e,t,n,r){return l(k,t,e),C(n,k,r)}function M(e,t,r,i){return Y(X(e,t,n(g.get(),r,t),ue,i))}function N(e,t,n){return t!=null&&Y(X(e,t.origin,t.direction,de,n))}function P(e,t,n){return Y(X(e,t.origin,t.vector,0,n))}function F(e,t,n){return Y(X(e,t.origin,t.vector,1,n))}function I(e,t){return q(e,t)<=0}function L(e,t){return q(e,t)>=0}function R(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!0,1e-6)}function z(e,t){return V(e,t.ray.origin,t.ray.direction,t,!1,!1,!1,1e-6)}function B(e,t){return t.c0<=t.c1&&V(e,t.ray.origin,t.ray.direction,t,!1,!0,!1,0)}function V(e,t,n,r,a,o,s,c){let l=i(b(e),n),u=q(e,t);if(l>=-c&&l<=c)return H(u,a,o);let d=-u/l,f=H(l,a,!1);return s&&!f&&!H(u,a,o)?!1:(f?d>r.c0&&(r.c0=d):d<r.c1&&(r.c1=d),r.c0<=r.c1)}function H(e,t,n){return n?t?e>=0:e<=0:t?e>0:e<0}function U(e,t,n,r=!1){let i=t.at(-1),s=q(e,i),c=r?s>0:s<=0;for(let l=0;l<t.length;l++){let u=t.at(l),d=q(e,u),f=r?d>0:d<=0;c!==f&&a(n(),i,u,s/(s-d)),f&&o(n(),u),i=u,s=d,c=f}}function W(e,t,r,i,a,o=!1){return n(Q,r,t),$.c0=0,$.c1=1,V(e,t,Q,$,o,!o,!1,1e-6)?(d(i,t,Q,$.c0),d(a,t,Q,$.c1),!0):!1}function G(e,t,r){let i=c(g.get(),b(e),-e[3]),a=K(e,n(g.get(),t,i),g.get());return s(r,a,i),r}function ce(e,t,r,i){let a=b(e),o=g.get(),s=g.get();ee(a,o,s);let c=n(g.get(),r,t),l=h(o,c),d=h(s,c),f=h(a,c);return u(i,l,d,f)}function K(e,t,r){let a=c(g.get(),b(e),i(b(e),t));return n(r,t,a),r}function le(e,t){return Math.abs(q(e,t))}function q(e,t){return i(b(e),t)+e[3]}function J(e,t,n){for(let r=0;r<n;++r)if(I(e,t[r]))return!1;return!0}function Y(e){return e===0||e===1}function X(t,n,r,a,o){let l=i(b(t),r),u=q(t,n);if(l===0)return u>=0?2:3;let d=-u/l;return a&1&&(d=e(d,0,1)),!(a&4)&&d<0||!(a&8)&&d>1?u>=0?2:3:(s(o,n,c(o,r,d)),u>=0?0:1)}const Z=[0,0,1,0],ue=12,de=8,Q=f(),$={c0:0,c1:1};export{J as areAllPointsOutside,R as clip,B as clipClosedNegativeHalfspace,z as clipInfinite,W as clipLineSegment,U as clipPolygon,y as copy,v as create,le as distance,ne as equals,te as exactEquals,E as fromArray,T as fromManyPoints,S as fromNormalAndOffset,w as fromPoints,C as fromPositionAndNormal,x as fromValues,se as fromVectorsAndPoint,b as getNormal,M as intersectLine,X as intersectLineOrRay,P as intersectLineSegment,F as intersectLineSegmentClamp,N as intersectRay,L as isPointInClosedPositiveHalfspace,I as isPointInside,oe as negate,G as projectPoint,ce as projectPointLocal,K as projectVector,ae as setOffsetFromPoint,q as signedDistance,Z as up,re as wrap};

package/graphic/AnnotationFeatureGraphicOrigin.d.ts

@@ -4,23 +4,63 @@ import type AnnotationFeatureSublayer from "../layers/support/AnnotationFeatureS
 
 /**
  * Provides information about the [AnnotationFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/) from which a graphic originates.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/AnnotationFeatureGraphicOrigin/#layer) property references the AnnotationFeatureLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/AnnotationFeatureGraphicOrigin/#sublayer) property references the [AnnotationFeatureSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/AnnotationFeatureSublayer/) that contains the graphic, when available.
+ * The sublayer is `null` when no annotation sublayer information is available.
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isAnnotationFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isAnnotationFeatureGraphicOrigin/) to check
+ * whether the graphic's origin is an AnnotationFeatureGraphicOrigin.
+ *
+ * Use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/) to get the sublayer's title, or the layer's title when the sublayer is `null`.
+ * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic
+ * instead of accessing the AnnotationFeatureLayer's template directly.
+ *
  * @since 5.1
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [AnnotationFeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/AnnotationFeatureLayer/#queryFeatures)
  * @example
- * // get a point from view's click event
- *  view.on("click", async (event) => {
- *    // Search for all features only on included layer at the clicked location
- *    const response = await view.hitTest(event, {include: layer});
- *    // if graphics are returned from layer, get the layer id from graphic origin
- *    if (response.results.length > 0) {
- *      const originId = response.results[0].graphic?.origin?.layer?.id;
- *    }
- *  });
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class AnnotationFeatureGraphicOrigin extends GraphicOrigin {
   constructor(layer: AnnotationFeatureLayer, sublayer: AnnotationFeatureSublayer | null);

package/graphic/BuildingGraphicOrigin.d.ts

@@ -4,12 +4,61 @@ import type BuildingComponentSublayer from "../layers/buildingSublayers/Building
 
 /**
  * Provides information about the [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/BuildingSceneLayer/) from which a graphic originates.
+ * The [layer](https://developers.arcgis.com/javascript/latest/references/core/graphic/BuildingGraphicOrigin/#layer) property references the BuildingSceneLayer, and the
+ * [sublayer](https://developers.arcgis.com/javascript/latest/references/core/graphic/BuildingGraphicOrigin/#sublayer) property references the [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/) that contains the graphic.
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest).
  *
+ * Before accessing the layer properties, use [isBuildingGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isBuildingGraphicOrigin/) to check
+ * whether the graphic's origin is a BuildingGraphicOrigin.
+ *
+ * If you only need the title of the originating component sublayer, use [getGraphicOriginTitle](https://developers.arcgis.com/javascript/latest/references/core/graphic/getGraphicOriginTitle/).
+ * To get the popup template applicable to the graphic, call [Graphic.getEffectivePopupTemplate()](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#getEffectivePopupTemplate) on the graphic
+ * instead of accessing the component sublayer's template directly.
+ *
  * @since 5.0
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [Scene component hitTest()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#hitTest)
+ * @example
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class BuildingGraphicOrigin extends GraphicOrigin {
   constructor(sublayer: BuildingComponentSublayer);

package/graphic/CSVGraphicOrigin.d.ts

@@ -6,6 +6,9 @@ import type CSVLayer from "../layers/CSVLayer.js";
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isCSVGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isCSVGraphicOrigin/) to check
+ * whether the graphic's origin is a CSVGraphicOrigin.
+ *
  * @since 5.0
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
@@ -14,15 +17,45 @@ import type CSVLayer from "../layers/CSVLayer.js";
  * @see [CSVLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/#queryFeatures)
  * @see [CSVLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/CSVLayerView/#queryFeatures)
  * @example
- * // get a point from view's click event
- *  view.on("click", async (event) => {
- *    // Search for all features only on included layer at the clicked location
- *    const response = await view.hitTest(event, {include: layer});
- *    // if graphics are returned from layer, get the layer id from graphic origin
- *    if (response.results.length > 0) {
- *      const originId = response.results[0].graphic?.origin?.layer?.id;
- *    }
- *  });
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class CSVGraphicOrigin extends GraphicOrigin {
   constructor(layer: CSVLayer);

package/graphic/CatalogGraphicOrigin.d.ts

@@ -7,6 +7,9 @@ import type CatalogFootprintLayer from "../layers/catalog/CatalogFootprintLayer.
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isCatalogGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isCatalogGraphicOrigin/) to check
+ * whether the graphic's origin is a CatalogGraphicOrigin.
+ *
  * @since 5.0
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
@@ -15,15 +18,45 @@ import type CatalogFootprintLayer from "../layers/catalog/CatalogFootprintLayer.
  * @see [CatalogFootprintLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/#queryFeatures)
  * @see [CatalogFootprintLayerView.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/CatalogFootprintLayerView/#queryFeatures)
  * @example
- * // get a point from view's click event
- *  view.on("click", async (event) => {
- *    // Search for all features only on included layer at the clicked location
- *    const response = await view.hitTest(event, {include: layer});
- *    // if graphics are returned from layer, get the layer id from graphic origin
- *    if (response.results.length > 0) {
- *      const originId = response.results[0].graphic?.origin?.layer?.id;
- *    }
- *  });
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class CatalogGraphicOrigin extends GraphicOrigin {
   constructor(layer: CatalogFootprintLayer);

package/graphic/DimensionFeatureGraphicOrigin.d.ts

@@ -6,20 +6,53 @@ import type DimensionFeatureLayer from "../layers/DimensionFeatureLayer.js";
  * The [origin](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#origin) information may be available when a graphic is returned from methods such as
  * [hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest) or [queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/#queryFeatures).
  *
+ * Before accessing the layer properties, use [isDimensionFeatureGraphicOrigin](https://developers.arcgis.com/javascript/latest/references/core/graphic/isDimensionFeatureGraphicOrigin/) to check
+ * whether the graphic's origin is a DimensionFeatureGraphicOrigin.
+ *
  * @since 5.1
  * @see [MapView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#hitTest)
  * @see [SceneView.hitTest()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#hitTest)
  * @see [DimensionFeatureLayer.queryFeatures()](https://developers.arcgis.com/javascript/latest/references/core/layers/DimensionFeatureLayer/#queryFeatures)
  * @example
- * // get a point from view's click event
- *  view.on("click", async (event) => {
- *    // Search for all features only on included layer at the clicked location
- *    const response = await view.hitTest(event, {include: layer});
- *    // if graphics are returned from layer, get the layer id from graphic origin
- *    if (response.results.length > 0) {
- *      const originId = response.results[0].graphic?.origin?.layer?.id;
- *    }
- *  });
+ * Access the layer and sublayer of a graphic that originated from a MapImageLayer.
+ * ```js
+ * import { isMapImageGraphicOrigin } from "@arcgis/core/graphic/isMapImageGraphicOrigin.js";
+ *
+ * const origin = graphic.origin;
+ *
+ * // Check whether the graphic came from a MapImageLayer
+ * if (isMapImageGraphicOrigin(origin)) {
+ *   console.log(origin.layer.title);
+ *   console.log(origin.sublayer.title);
+ * }
+ * ```
+ * @example
+ * Access the vector tile style layer associated with a graphic returned by hitTest().
+ * ```js
+ * import { isVectorTileGraphicOrigin } from "@arcgis/core/graphic/isVectorTileGraphicOrigin.js";
+ *
+ * viewElement.addEventListener("arcgisViewClick", async (event) => {
+ *   // Get hit-test results from the VectorTileLayer at the clicked location
+ *   const response = await view.hitTest(event.detail, { include: vectorTileLayer });
+ *
+ *   for (const result of response.results) {
+ *     // Only graphic results contain a graphic with origin information
+ *     if (result.type !== "graphic") {
+ *       continue;
+ *     }
+ *
+ *     const graphic = result.graphic;
+ *     const origin = graphic.origin;
+ *
+ *     // Check whether the graphic came from a VectorTileLayer
+ *     if (isVectorTileGraphicOrigin(origin)) {
+ *       // layerId identifies a style layer within the VectorTileLayer
+ *       const styleLayer = origin.layer.getStyleLayer(origin.layerId);
+ *       console.log(styleLayer);
+ *     }
+ *   }
+ * });
+ * ```
  */
 export default class DimensionFeatureGraphicOrigin extends GraphicOrigin {
   constructor(layer: DimensionFeatureLayer);