@loaders.gl/scene 5.0.0-alpha.8 → 5.0.0-beta.1

package/src/gltf/lib/types/gltf-additional-extension-schemas.ts

@@ -0,0 +1,127 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
+import {z} from 'zod';
+
+const indexSchema = z.number().int().nonnegative();
+const propertyShape = {
+  /** Nested extension declarations, including extensions unknown to this library. */
+  extensions: z.record(z.string(), z.unknown()).optional(),
+  /** Application-specific metadata. */
+  extras: z.unknown().optional()
+};
+
+/** Permissive schema for one named material variant. */
+export const GLTFKHRMaterialVariantSchema = z.looseObject({
+  ...propertyShape,
+  /** User-facing variant name. */
+  name: z.string()
+});
+
+/** Permissive schema for document-level KHR_materials_variants. */
+export const GLTFKHRMaterialsVariantsSchema = z.looseObject({
+  ...propertyShape,
+  /** Available variants, referenced by primitive mappings. */
+  variants: z.array(GLTFKHRMaterialVariantSchema).min(1)
+});
+
+/** Permissive schema for a primitive's material-to-variant mapping. */
+export const GLTFKHRMaterialVariantMappingSchema = z.looseObject({
+  ...propertyShape,
+  /** Optional application-facing mapping name. */
+  name: z.string().optional(),
+  /** Index into the document's materials array. */
+  material: indexSchema,
+  /** Indices into the document-level variant array. */
+  variants: z.array(indexSchema).min(1)
+});
+
+/** Permissive schema for primitive-level KHR_materials_variants. */
+export const GLTFKHRMaterialsVariantsPrimitiveSchema = z.looseObject({
+  ...propertyShape,
+  /** Material choices associated with this primitive. */
+  mappings: z.array(GLTFKHRMaterialVariantMappingSchema).min(1)
+});
+
+/** Permissive schema for EXT_mesh_gpu_instancing, retaining custom instance attributes. */
+export const GLTFEXTMeshGPUInstancingSchema = z.looseObject({
+  ...propertyShape,
+  /** Accessor indices for TRANSLATION, ROTATION, SCALE and custom instance attributes. */
+  attributes: z.record(z.string(), indexSchema)
+});
+
+/** Permissive schema for KHR_animation_pointer on an animation channel target. */
+export const GLTFKHRAnimationPointerSchema = z.looseObject({
+  ...propertyShape,
+  /** JSON Pointer identifying an animatable property in the original glTF document. */
+  pointer: z.string()
+});
+
+/** Permissive schema for KHR_node_visibility; omitted visibility means true. */
+export const GLTFKHRNodeVisibilitySchema = z.looseObject({
+  ...propertyShape,
+  /** Whether this node and its descendants are visible. */
+  visible: z.boolean().optional()
+});
+
+/** Permissive schema for KHR_node_selectability; omitted selectability means true. */
+export const GLTFKHRNodeSelectabilitySchema = z.looseObject({
+  ...propertyShape,
+  /** Whether this node and its descendants participate in selection. */
+  selectable: z.boolean().optional()
+});
+
+/** Permissive schema for KHR_node_hoverability; omitted hoverability means true. */
+export const GLTFKHRNodeHoverabilitySchema = z.looseObject({
+  ...propertyShape,
+  /** Whether this node and its descendants participate in hover interactions. */
+  hoverable: z.boolean().optional()
+});
+
+/** Permissive XMP packet schema, retaining arbitrary JSON-LD namespaces and properties. */
+export const GLTFKHRXMPPacketSchema = z.looseObject({
+  /** Namespace declarations used by this packet. */
+  '@context': z.record(z.string(), z.unknown())
+});
+
+/** Permissive schema for document-level KHR_xmp_json_ld. */
+export const GLTFKHRXMPJSONLDSchema = z.looseObject({
+  ...propertyShape,
+  /** Shared metadata packets referenced by asset, scene, node and other objects. */
+  packets: z.array(GLTFKHRXMPPacketSchema).min(1)
+});
+
+/** Permissive schema for an object's KHR_xmp_json_ld packet reference. */
+export const GLTFKHRXMPJSONLDReferenceSchema = z.looseObject({
+  ...propertyShape,
+  /** Index into the document-level packets array. */
+  packet: indexSchema
+});
+
+/** Document-level material variants with unknown extension properties preserved. */
+export type GLTF_KHR_materials_variants = z.infer<typeof GLTFKHRMaterialsVariantsSchema>;
+/** One named material variant. */
+export type GLTFMaterialVariant = z.infer<typeof GLTFKHRMaterialVariantSchema>;
+/** Primitive-level variant mappings. */
+export type GLTF_KHR_materials_variants_primitive = z.infer<
+  typeof GLTFKHRMaterialsVariantsPrimitiveSchema
+>;
+/** One mapping from a material to variant indices. */
+export type GLTFMaterialVariantMapping = z.infer<typeof GLTFKHRMaterialVariantMappingSchema>;
+/** GPU instance accessor references, including custom attributes. */
+export type GLTF_EXT_mesh_gpu_instancing = z.infer<typeof GLTFEXTMeshGPUInstancingSchema>;
+/** Animation channel target expressed as a JSON Pointer. */
+export type GLTF_KHR_animation_pointer = z.infer<typeof GLTFKHRAnimationPointerSchema>;
+/** Local node visibility declaration. */
+export type GLTF_KHR_node_visibility = z.infer<typeof GLTFKHRNodeVisibilitySchema>;
+/** Local node selectability declaration. */
+export type GLTF_KHR_node_selectability = z.infer<typeof GLTFKHRNodeSelectabilitySchema>;
+/** Local node hoverability declaration. */
+export type GLTF_KHR_node_hoverability = z.infer<typeof GLTFKHRNodeHoverabilitySchema>;
+/** Document-level XMP packet collection. */
+export type GLTF_KHR_xmp_json_ld = z.infer<typeof GLTFKHRXMPJSONLDSchema>;
+/** One JSON-LD XMP metadata packet. */
+export type GLTFXMPPacket = z.infer<typeof GLTFKHRXMPPacketSchema>;
+/** Reference to a shared XMP metadata packet. */
+export type GLTF_KHR_xmp_json_ld_reference = z.infer<typeof GLTFKHRXMPJSONLDReferenceSchema>;

package/src/gltf/lib/types/gltf-audio-extension-schemas.ts

@@ -0,0 +1,167 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+
+import {z} from 'zod';
+
+const indexSchema = z.number().int().nonnegative();
+const propertyShape = {
+  /** Optional object name. */
+  name: z.string().optional(),
+  /** Nested extension declarations. */
+  extensions: z.record(z.string(), z.unknown()).optional(),
+  /** Application-specific data. */
+  extras: z.unknown().optional()
+};
+
+/** Permissive schema for encoded draft KHR audio data. */
+export const GLTFKHRAudioDataSchema = z.looseObject({
+  ...propertyShape,
+  /** External or data URI. */
+  uri: z.string().optional(),
+  /** Embedded buffer-view index, taking precedence over uri. */
+  bufferView: indexSchema.optional(),
+  /** Declared encoded media type. */
+  mimeType: z.string().optional()
+});
+
+/** Permissive schema for a draft KHR audio source, including placeholder sources. */
+export const GLTFKHRAudioSourceSchema = z.looseObject({
+  ...propertyShape,
+  /** Optional audio resource index. */
+  audio: indexSchema.optional(),
+  /** Linear source gain. */
+  gain: z.number().optional(),
+  /** Pitch and speed multiplier. */
+  playbackRate: z.number().optional(),
+  /** Whether playback repeats. */
+  loop: z.boolean().optional(),
+  /** Application playback intent. */
+  autoplay: z.boolean().optional()
+});
+
+/** Permissive schema for draft KHR positional audio settings, using radians. */
+export const GLTFKHRAudioPositionalSchema = z.looseObject({
+  ...propertyShape,
+  /** Emitter shape, including extension-defined shapes. */
+  shapeType: z.string().optional(),
+  /** Inner cone diameter in radians. */
+  coneInnerAngle: z.number().optional(),
+  /** Outer cone diameter in radians. */
+  coneOuterAngle: z.number().optional(),
+  /** Gain outside the outer cone. */
+  coneOuterGain: z.number().optional(),
+  /** Distance attenuation model, including future model names. */
+  distanceModel: z.string().optional(),
+  /** Maximum attenuation distance. */
+  maxDistance: z.number().optional(),
+  /** Reference distance in meters. */
+  refDistance: z.number().optional(),
+  /** Attenuation rate. */
+  rolloffFactor: z.number().optional()
+});
+
+/** Permissive schema for a draft KHR audio emitter. */
+export const GLTFKHRAudioEmitterSchema = z.looseObject({
+  ...propertyShape,
+  /** Emitter kind, retaining future extension-defined kinds. */
+  type: z.string(),
+  /** Linear emitter gain. */
+  gain: z.number().optional(),
+  /** Source indices; omitted or empty for placeholder emitters. */
+  sources: z.array(indexSchema).optional(),
+  /** Spatialization settings. */
+  positional: GLTFKHRAudioPositionalSchema.optional()
+});
+
+/** Permissive document-level schema for the KHR_audio_emitter draft. */
+export const GLTFKHRAudioEmitterExtensionSchema = z.looseObject({
+  ...propertyShape,
+  /** Encoded resource declarations. */
+  audio: z.array(GLTFKHRAudioDataSchema).optional(),
+  /** Playback source declarations. */
+  sources: z.array(GLTFKHRAudioSourceSchema).optional(),
+  /** Shared emitter declarations. */
+  emitters: z.array(GLTFKHRAudioEmitterSchema).optional()
+});
+
+/** Permissive node or scene attachment schema for the KHR_audio_emitter draft. */
+export const GLTFKHRAudioAttachmentSchema = z.looseObject({
+  ...propertyShape,
+  /** Attached emitter indices. */
+  emitters: z.array(indexSchema).min(1)
+});
+
+const mpegPropertyShape = {
+  /** Nested extension declarations. */
+  extensions: propertyShape.extensions,
+  /** Application-specific data. */
+  extras: propertyShape.extras
+};
+
+/** Permissive schema for an MPEG spatial audio source and timed accessor references. */
+export const GLTFSpatialAudioSourceSchema = z.looseObject({
+  ...mpegPropertyShape,
+  /** Scene-wide source identifier. */
+  id: z.number().int(),
+  /** Source kind, retaining future extension-defined kinds. */
+  type: z.string(),
+  /** Source level adjustment in decibels. */
+  pregain: z.number().optional(),
+  /** Playback speed multiplier. */
+  playbackSpeed: z.number().optional(),
+  /** Attenuation function, including custom functions. */
+  attenuation: z.string().optional(),
+  /** Parameters for the attenuation function. */
+  attenuationParameters: z.array(z.number()).optional(),
+  /** Reference distance in meters. */
+  referenceDistance: z.number().optional(),
+  /** Accessors describing decoded audio data. */
+  accessors: z.array(indexSchema).min(1),
+  /** Reverb units receiving this source's signal. */
+  reverbFeed: z.array(z.number().int()).optional(),
+  /** Per-feed gain in decibels. */
+  reverbFeedGain: z.array(z.number()).optional()
+});
+
+/** Permissive schema for frequency-dependent MPEG reverberation parameters. */
+export const GLTFSpatialAudioReverbPropertySchema = z.looseObject({
+  ...mpegPropertyShape,
+  /** Frequency in hertz. */
+  frequency: z.number(),
+  /** Reverberation decay time in seconds. */
+  RT60: z.number(),
+  /** Diffuse-to-source ratio in decibels. */
+  DSR: z.number()
+});
+
+/** Permissive schema for an MPEG reverberation unit. */
+export const GLTFSpatialAudioReverbSchema = z.looseObject({
+  ...mpegPropertyShape,
+  /** Scene-wide reverb identifier. */
+  id: z.number().int(),
+  /** Whether the renderer may bypass this unit. */
+  bypass: z.boolean().optional(),
+  /** Frequency-dependent reverberation parameters. */
+  properties: z.array(GLTFSpatialAudioReverbPropertySchema).min(1),
+  /** Delay before late reverberation in seconds. */
+  predelay: z.number().optional()
+});
+
+/** Permissive schema for an MPEG spatial audio listener. */
+export const GLTFSpatialAudioListenerSchema = z.looseObject({
+  ...mpegPropertyShape,
+  /** Scene-wide listener identifier. */
+  id: z.number().int()
+});
+
+/** Permissive root or node schema for MPEG_audio_spatial. */
+export const GLTFMPEGAudioSpatialSchema = z.looseObject({
+  ...mpegPropertyShape,
+  /** Audio sources at this attachment. */
+  sources: z.array(GLTFSpatialAudioSourceSchema).optional(),
+  /** Audio output listener. */
+  listener: GLTFSpatialAudioListenerSchema.optional(),
+  /** Reverb units at this attachment. */
+  reverbs: z.array(GLTFSpatialAudioReverbSchema).optional()
+});