@3driseai/3drise-core 1.0.19 → 1.0.20

package/dist/environment/terrainConfigs.js

@@ -0,0 +1,292 @@
+/**
+ * Config shapes for the procedural terrain system that lives in this package.
+ *
+ * Declared locally rather than in `@3driseai/3drise-core`, alongside
+ * `cloudConfigs.ts` and `gridConfigs.ts`, because the material and the renderer
+ * are here and nothing outside the viewer needs to construct these by hand.
+ *
+ * Core's `TerrainSettings` is the retired flat shape (`visible` +
+ * `displacementScale`) and is deliberately left alone: a saved project still
+ * carries it, and `normalizeTerrain` below is what turns one into nothing rather
+ * than into a mountain range the scene was never authored with.
+ *
+ * A terrain is ONE landform model with per-type shaping, not four renderers —
+ * the same way three of the four cloud types share one marcher. What separates
+ * mountains from dunes is the operator applied to the fBm and the numbers around
+ * it, so the type is a config field the shader branches on.
+ */
+// -----------------------------------------------------------------------------
+// Defaults
+// -----------------------------------------------------------------------------
+const surfaceBase = {
+    elevation: 1200,
+    seaLevel: 0,
+    featureSize: 2600,
+    octaves: 9,
+    lacunarity: 2.06,
+    gain: 0.52,
+    ridgeSharpness: 0.62,
+    warpStrength: 0.28,
+    warpSize: 0.6,
+    erosion: 0.7,
+    terraces: 0,
+    terraceSharpness: 0.6,
+    bearing: 78,
+    duneWavelength: 320,
+    duneAsymmetry: 0.6,
+    plateau: 0,
+    valleyDepth: 0,
+    valleyWidth: 0.25,
+    lowColor: '#4a4636',
+    midColor: '#6b6248',
+    rockColor: '#6a6259',
+    peakColor: '#eef1f6',
+    slopeRockStart: 0.35,
+    slopeRockEnd: 0.62,
+    peakLevel: 0.62,
+    peakBlend: 0.12,
+    peakSlopeFalloff: 1.4,
+    macroVariation: 0.22,
+    macroSize: 2400,
+    detailStrength: 0.45,
+    detailSize: 9,
+    roughness: 0.82,
+    specular: 0.06,
+    ambient: 1,
+    bounce: 0.35,
+    sunShadow: 1,
+    shadowSoftness: 12,
+    aerialPerspective: 0.00007,
+};
+export const defaultMountainsConfig = {
+    ...surfaceBase,
+    type: 'terrain',
+    terrainType: 'mountains',
+    preset: '',
+    enabled: true,
+};
+export const defaultHillsConfig = {
+    ...surfaceBase,
+    type: 'terrain',
+    terrainType: 'hills',
+    preset: '',
+    enabled: true,
+    elevation: 300,
+    featureSize: 2200,
+    octaves: 8,
+    gain: 0.46,
+    ridgeSharpness: 0.05,
+    warpStrength: 0.35,
+    erosion: 0.45,
+    lowColor: '#3f5326',
+    midColor: '#55663a',
+    rockColor: '#7a7266',
+    peakColor: '#8d9a6a',
+    slopeRockStart: 0.5,
+    slopeRockEnd: 0.78,
+    peakLevel: 0.78,
+    peakBlend: 0.2,
+    macroVariation: 0.3,
+    macroSize: 1400,
+    detailStrength: 0.5,
+    detailSize: 6,
+    roughness: 0.9,
+    specular: 0.03,
+    aerialPerspective: 0.00009,
+};
+export const defaultDunesConfig = {
+    ...surfaceBase,
+    type: 'terrain',
+    terrainType: 'dunes',
+    preset: '',
+    enabled: true,
+    elevation: 150,
+    featureSize: 3000,
+    octaves: 6,
+    gain: 0.42,
+    ridgeSharpness: 0.15,
+    warpStrength: 0.2,
+    warpSize: 0.8,
+    erosion: 0.2,
+    duneWavelength: 340,
+    duneAsymmetry: 0.62,
+    lowColor: '#b08a53',
+    midColor: '#d6b077',
+    rockColor: '#9c7a4c',
+    peakColor: '#f0dcb4',
+    slopeRockStart: 0.62,
+    slopeRockEnd: 0.9,
+    peakLevel: 0.7,
+    peakBlend: 0.24,
+    peakSlopeFalloff: 0.6,
+    macroVariation: 0.14,
+    macroSize: 3600,
+    detailStrength: 0.3,
+    detailSize: 3.5,
+    roughness: 0.55,
+    specular: 0.16,
+    ambient: 1.1,
+    bounce: 0.55,
+    shadowSoftness: 22,
+    aerialPerspective: 0.00008,
+};
+export const defaultCanyonConfig = {
+    ...surfaceBase,
+    type: 'terrain',
+    terrainType: 'canyon',
+    preset: '',
+    enabled: true,
+    elevation: 700,
+    featureSize: 2600,
+    octaves: 8,
+    gain: 0.48,
+    ridgeSharpness: 0.3,
+    warpStrength: 0.18,
+    erosion: 0.85,
+    terraces: 14,
+    terraceSharpness: 0.72,
+    plateau: 0.55,
+    valleyDepth: 0.8,
+    valleyWidth: 0.22,
+    lowColor: '#7a4a30',
+    midColor: '#a4643c',
+    rockColor: '#c07a4a',
+    peakColor: '#d9a877',
+    slopeRockStart: 0.28,
+    slopeRockEnd: 0.5,
+    peakLevel: 0.72,
+    peakBlend: 0.08,
+    peakSlopeFalloff: 0.9,
+    macroVariation: 0.26,
+    macroSize: 1800,
+    detailStrength: 0.4,
+    detailSize: 7,
+    roughness: 0.86,
+    specular: 0.05,
+    shadowSoftness: 8,
+    aerialPerspective: 0.000075,
+};
+export const defaultTerrainQuality = {
+    levels: 9,
+    segments: 128,
+    cellSize: 2,
+    curvature: 1 / (2 * 6371000),
+    shadowSteps: 12,
+    shadowDistance: 5000,
+    detailFadeDistance: 1200,
+    receiveShadows: true,
+    exposure: 1,
+    wireframe: false,
+};
+/** Per-type defaults, for the controller's type switcher. */
+export const TERRAIN_DEFAULTS = {
+    mountains: defaultMountainsConfig,
+    dunes: defaultDunesConfig,
+    hills: defaultHillsConfig,
+    canyon: defaultCanyonConfig,
+};
+export const TERRAIN_SCHEMA = [
+    { key: 'elevation', animatable: false, label: 'Elevation', group: 'form', min: 5, max: 6000, step: 5, unit: 'm', description: 'Peak height above sea level. Every height-keyed splat threshold is a fraction of this, so raising it does not move the snow line.' },
+    { key: 'seaLevel', animatable: false, label: 'Sea level', group: 'form', min: -2000, max: 2000, step: 5, unit: 'm', description: 'World Y the terrain is built around — where flat ground sits, and where a placed object meets it.' },
+    { key: 'featureSize', animatable: false, label: 'Feature size', group: 'form', min: 200, max: 40000, step: 50, unit: 'm', description: 'Horizontal size of the primary landform. The one knob that decides whether this reads as a mountain range or a gravel pile.' },
+    { key: 'octaves', animatable: false, label: 'Octaves', group: 'form', min: 3, max: 12, step: 1, description: 'fBm detail levels. Past ~10 the extra octaves are finer than the closest clipmap cell and only cost; distant rings drop them automatically.' },
+    { key: 'lacunarity', animatable: false, label: 'Lacunarity', group: 'form', min: 1.7, max: 2.6, step: 0.01, advanced: true, description: 'Frequency step per octave. Slightly off 2.0 breaks the grid alignment that otherwise shows as a faint square lattice.' },
+    { key: 'gain', animatable: false, label: 'Gain', group: 'form', min: 0.25, max: 0.72, step: 0.005, description: 'Amplitude step per octave. Below 0.5 smooth and rolling, above it jagged and fractal.' },
+    { key: 'ridgeSharpness', animatable: false, label: 'Ridge sharpness', group: 'form', min: 0, max: 1, step: 0.005, description: '0 gives rounded billow hills, 1 knife ridges. The strongest single cue between a mountain and a dune field.' },
+    { key: 'warpStrength', animatable: false, label: 'Domain warp', group: 'form', min: 0, max: 1, step: 0.005, description: 'Bends ridge lines into curved, branching shapes. At 0 the silhouette reads as noise rather than landscape.' },
+    { key: 'warpSize', animatable: false, label: 'Warp size', group: 'form', min: 0.1, max: 2, step: 0.01, advanced: true, description: 'Scale of the warp field relative to feature size. Above ~1 it drifts the terrain instead of bending it.' },
+    { key: 'erosion', animatable: false, label: 'Erosion', group: 'form', min: 0, max: 1, step: 0.005, description: 'Damps octaves where slope is already steep — flattens valley floors, sharpens flanks. The cheapest approximation of erosion there is.' },
+    { key: 'terraces', animatable: false, label: 'Strata', group: 'form', min: 0, max: 40, step: 1, types: ['canyon', 'mountains'], description: 'Sedimentary banding step count. 0 is off. Most of what makes a mesa read as a mesa.' },
+    { key: 'terraceSharpness', animatable: false, label: 'Strata hardness', group: 'form', min: 0, max: 1, step: 0.01, types: ['canyon', 'mountains'], description: '0 is a smooth ramp between bands, 1 a near-vertical riser.' },
+    { key: 'plateau', animatable: false, label: 'Plateau', group: 'form', min: 0, max: 1, step: 0.005, types: ['canyon'], description: 'Fraction of the height range flattened into mesa tops.' },
+    { key: 'valleyDepth', animatable: false, label: 'Incision depth', group: 'form', min: 0, max: 1.5, step: 0.005, types: ['canyon'], description: 'Depth of the carved channel network as a fraction of elevation. At 0 the mesas have nothing between them.' },
+    { key: 'valleyWidth', animatable: false, label: 'Incision width', group: 'form', min: 0.03, max: 1, step: 0.005, types: ['canyon'], description: 'Narrow cuts slot canyons; wide ones cut broad washes.' },
+    { key: 'bearing', animatable: false, label: 'Wind bearing', group: 'form', min: 0, max: 360, step: 1, unit: 'deg', types: ['dunes'], description: 'Dunes are transverse to the wind, so this rotates the whole crest train.' },
+    { key: 'duneWavelength', animatable: false, label: 'Dune wavelength', group: 'form', min: 40, max: 2000, step: 5, unit: 'm', types: ['dunes'], description: 'Crest-to-crest distance of the dune train.' },
+    { key: 'duneAsymmetry', animatable: false, label: 'Slip face', group: 'form', min: 0, max: 1, step: 0.005, types: ['dunes'], description: 'Lee-slope steepening. At 0 the dunes are sine waves; real ones have a long windward ramp and a short face at the angle of repose.' },
+    { key: 'slopeRockStart', animatable: false, label: 'Rock from slope', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Slope at which rock starts showing through. Splatting rock by slope rather than height is what makes a cliff read as a cliff at any altitude.' },
+    { key: 'slopeRockEnd', animatable: false, label: 'Bare rock at slope', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Slope at which the surface is fully bare rock.' },
+    { key: 'peakLevel', animatable: false, label: 'Peak line', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Height fraction where the peak layer (snow, salt, bleached stone) begins.' },
+    { key: 'peakBlend', animatable: false, label: 'Peak blend', group: 'surface', min: 0.01, max: 0.5, step: 0.005, description: 'Width of that transition. A hard line is physically right for temperature but reads as a decal.' },
+    { key: 'peakSlopeFalloff', animatable: false, label: 'Peak slope falloff', group: 'surface', min: 0, max: 3, step: 0.01, description: 'Peak coverage lost per unit slope. Snow does not sit on a vertical face; without this a summit looks dipped in paint.' },
+    { key: 'macroVariation', animatable: false, label: 'Macro variation', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Large-scale albedo break-up. Without it a splat layer is one flat colour across kilometres and reads as untextured.' },
+    { key: 'macroSize', animatable: false, label: 'Macro size', group: 'surface', min: 200, max: 12000, step: 50, unit: 'm', description: 'Size of that variation.' },
+    { key: 'detailStrength', animatable: false, label: 'Detail bump', group: 'surface', min: 0, max: 1.5, step: 0.005, description: 'High-frequency normal detail added per fragment — bumps far below the mesh resolution.' },
+    { key: 'detailSize', animatable: false, label: 'Detail size', group: 'surface', min: 0.5, max: 60, step: 0.25, unit: 'm', description: 'Size of that detail. Below about a metre it aliases before it fades.' },
+    { key: 'roughness', label: 'Roughness', group: 'surface', min: 0.05, max: 1, step: 0.005, description: 'Widens the specular lobe. Rock is nearly matte; wet sand and snow are not.' },
+    { key: 'specular', label: 'Specular', group: 'surface', min: 0, max: 1, step: 0.005, description: 'Specular strength. The grazing sheen on sand at low sun comes from here.' },
+    { key: 'ambient', label: 'Ambient', group: 'lighting', min: 0, max: 3, step: 0.01, description: 'Sky-dome fill, taken from the same atmosphere the sky and clouds use, so it darkens and warms as the sun sets instead of freezing.' },
+    { key: 'bounce', label: 'Ground bounce', group: 'lighting', min: 0, max: 2, step: 0.01, description: 'Fill on downward-facing surfaces, tinted by the low colour. Keeps overhangs and north faces off pure black.' },
+    { key: 'sunShadow', label: 'Self shadow', group: 'lighting', min: 0, max: 1, step: 0.01, description: 'Strength of the analytic shadow marched down the sun vector. This is what puts a mountain shadow in its own valley, with no shadow-map resolution to run out of.' },
+    { key: 'shadowSoftness', animatable: false, label: 'Shadow softness', group: 'lighting', min: 1, max: 60, step: 0.5, description: 'Penumbra width of that shadow. Larger reads as a hazier day.' },
+    { key: 'aerialPerspective', label: 'Aerial perspective', group: 'lighting', min: 0, max: 0.0004, step: 0.000002, unit: '1/m', description: 'Rate distant terrain fades into the sky behind it. The main cue for how large the landscape reads, and what makes the horizon a horizon rather than a cut-out.' },
+];
+export const TERRAIN_QUALITY_SCHEMA = [
+    { key: 'levels', label: 'Clipmap levels', group: 'quality', min: 2, max: 12, step: 1, description: 'Each ring doubles its cell size, so visible radius is roughly cellSize x segments x 2^(levels-1). 9 levels of 192 at 2 m reaches ~98 km, which is past where haze has dissolved the ground.' },
+    { key: 'segments', label: 'Ring resolution', group: 'quality', min: 32, max: 320, step: 8, description: 'Grid resolution per ring side, and the one knob that sets how polygonal the terrain looks: a clipmap triangle subtends about 2/segments radians whatever the distance, so 192 is roughly 12 px at 1080p. Vertex cost is levels x segments^2 x 0.75, since every ring above the first is hollow.' },
+    { key: 'cellSize', label: 'Cell size', group: 'quality', min: 0.25, max: 32, step: 0.25, unit: 'm', description: 'Finest cell, at the camera. Lower it for a walkable scene, raise it for a flyover.' },
+    { key: 'shadowSteps', label: 'Shadow steps', group: 'quality', min: 0, max: 48, step: 1, description: 'Steps in the analytic sun-shadow march, nearest the camera. 0 disables terrain self-shadowing entirely, which is the single biggest thing you can turn off; below ~12 long shadows at low sun start to leak.' },
+    { key: 'shadowDistance', label: 'Shadow distance', group: 'quality', min: 0, max: 40000, step: 100, unit: 'm', description: 'Range over which the self-shadow fades out. The march runs per vertex, so lowering this drops whole clipmap rings out of it — the cheapest quality dial there is after turning shadows off.' },
+    { key: 'detailFadeDistance', label: 'Detail fade distance', group: 'quality', min: 50, max: 8000, step: 25, unit: 'm', description: 'Distance over which fragment-stage bump fades out. Removes far-field shimmer and buys back most of its own cost.' },
+    { key: 'curvature', label: 'Planetary curvature', group: 'quality', min: 0, max: 0.0000012, step: 0.00000001, advanced: true, description: '1/(2R). Drops the surface with the square of distance so it meets a real horizon. Zero gives a flat world, which at these extents looks wrong long before it looks flat.' },
+    { key: 'exposure', label: 'Exposure', group: 'quality', min: 0.2, max: 4, step: 0.01, description: 'Radiance scale, so terrain matches the sky and clouds whether or not the cloud composite is what tonemaps the frame.' },
+];
+export const defaultProceduralTerrainSettings = {
+    id: '3drise-terrain',
+    type: 'terrain',
+    config: { ...defaultHillsConfig, enabled: false },
+    quality: { ...defaultTerrainQuality },
+};
+// =============================================================================
+// Normalisation
+// =============================================================================
+//
+// A published scene loads whatever was in the database the day it was saved, and
+// a scene saved before this system existed carries core's flat TerrainSettings
+// (`visible` + `displacementScale`) under the same key. Reading that straight
+// into the renderer is how an embed dies: the clipmap sizes its rings from
+// `quality.segments` on its first frame.
+//
+// Each block merges over its own defaults SEPARATELY, not through one merge over
+// the settings object, so a quality edit does not hand the surface a new config
+// object and rebuild the clipmap geometry.
+const TERRAIN_TYPES = ['mountains', 'dunes', 'hills', 'canyon'];
+const isRecord = (v) => typeof v === 'object' && v !== null;
+/**
+ * Surface block merged over its type's defaults, or null when there is nothing to
+ * render — including the retired flat shape, which has no `config` and must draw
+ * nothing rather than a landscape the project was never authored with.
+ *
+ * An unknown or missing `terrainType` falls back to hills rather than rendering
+ * nothing: a scene that says `enabled: true` should show ground.
+ */
+export function normalizeTerrain(raw) {
+    if (!isRecord(raw))
+        return null;
+    const terrainType = TERRAIN_TYPES.includes(raw.terrainType)
+        ? raw.terrainType
+        : 'hills';
+    return {
+        ...TERRAIN_DEFAULTS[terrainType],
+        ...raw,
+        type: 'terrain',
+        terrainType,
+    };
+}
+export function normalizeTerrainQuality(raw) {
+    return { ...defaultTerrainQuality, ...(isRecord(raw) ? raw : {}) };
+}
+/**
+ * A whole settings blob, from a project of any age. The flat legacy shape has no
+ * `config`, so it normalises to a disabled terrain rather than to a default one.
+ */
+export function normalizeTerrainSettings(raw) {
+    const source = isRecord(raw) ? raw : {};
+    const config = normalizeTerrain(source.config);
+    return {
+        id: typeof source.id === 'string' ? source.id : defaultProceduralTerrainSettings.id,
+        type: 'terrain',
+        config: config ?? { ...defaultHillsConfig, enabled: false },
+        quality: normalizeTerrainQuality(source.quality),
+    };
+}

package/dist/index.d.ts

@@ -28,6 +28,10 @@ export * from './services/index';
 export * from './data/index';
 export * from './constants/index';
 export * from './shaders/index';
+export * from './autoAnimate/index';
+export * from './animations/index';
+export * from './environment/index';
+export * from './properties/index';
 export { LightsManagerV } from './three/LightsManagerV';
 export { FrameV } from './three/FrameV';
 export { ImageGeometryV } from './three/ImageGeometryV';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -7,6 +7,10 @@ export * from './services/index.js';
 export * from './data/index.js';
 export * from './constants/index.js';
 export * from './shaders/index.js';
+export * from './autoAnimate/index.js';
+export * from './animations/index.js';
+export * from './environment/index.js';
+export * from './properties/index.js';
 // Three.js vanilla classes
 export { LightsManagerV } from './three/LightsManagerV.js';
 export { FrameV } from './three/FrameV.js';

package/dist/properties/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './registry';
+export * from './tables/index';
+//# sourceMappingURL=index.d.ts.map

package/dist/properties/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/properties/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC"}

package/dist/properties/index.js

@@ -0,0 +1,3 @@
+export * from './types.js';
+export * from './registry.js';
+export * from './tables/index.js';

package/dist/properties/registry.d.ts

@@ -0,0 +1,44 @@
+import { type OptionalProperty } from './tables/optionalProperties';
+import type { DescribedProperty, PropertyDomain, PropertyElement, PropertyKind, PropertySpec } from './types';
+/** Rain object knobs driven per frame. */
+export declare const RAIN_ANIMATABLE_KEYS: readonly ["color", "size", "opacity", "speed", "windStrength", "windDirection", "turbulence"];
+/**
+ * Objects that own their shader: their materialSettings (if any) never reach the
+ * renderer, so they have no material properties. They animate through config.
+ */
+export declare const SELF_MANAGED_MATERIAL_TYPES: Set<string>;
+/** camelCase → "Title Case" (same as toAnimatableLabel). */
+export declare const propertyLabel: (key: string) => string;
+export declare function getSettingAtPath(obj: unknown, path: string): unknown;
+/** Kind of a value found on settings (material keys and table-only knobs have no spec to say). */
+export declare function kindOfValue(key: string, v: unknown): PropertyKind | null;
+/**
+ * Controller rows → specs, for panels whose element is not in the registry's
+ * element list (stars, fog, rain environment, gallery…). Numbers / colours count
+ * as animatable unless the row says otherwise; panels ignore the flag.
+ */
+export declare function toPropertySpecs(list: OptionalProperty[], prefix?: string, domain?: PropertyDomain): PropertySpec[];
+/** Every property that applies to this element (structural and animatable). */
+export declare function getPropertySpecs(element: PropertyElement, settings: any): PropertySpec[];
+/**
+ * The property's layer is on: a hidden layer's knobs change nothing, so nothing
+ * offers them for animation (edges switched off, cloud deck / cirrus disabled).
+ */
+export declare function isPropertyLive(element: PropertyElement, spec: PropertySpec, settings: any): boolean;
+/** Properties that can be driven per frame on this element right now. */
+export declare function getAnimatableSpecs(element: PropertyElement, settings: any): PropertySpec[];
+/**
+ * Object config families the animation timeline keys. The V2 applier drives
+ * `config.*` through the object's live config handle, which these four register;
+ * rain and the legacy cloud object have per-frame knobs for the keyframe /
+ * mouse-move systems only.
+ */
+export declare const TRACK_CONFIG_DOMAINS: ReadonlySet<PropertyDomain>;
+/** What an animation clip can key on this element (timeline track picker, AI clips). */
+export declare function getTrackSpecs(element: PropertyElement, settings: any): PropertySpec[];
+export declare function getPropertySpec(element: PropertyElement, settings: any, key: string): PropertySpec | undefined;
+/** Specs with the element's current values. */
+export declare function describeProperties(element: PropertyElement, settings: any): DescribedProperty[];
+/** The registry element for an animation / timeline state: env keys and camera as-is, anything else is an object id. */
+export declare const elementOfState: (state: string) => PropertyElement;
+//# sourceMappingURL=registry.d.ts.map

package/dist/properties/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/properties/registry.ts"],"names":[],"mappings":"AA8CA,OAAO,EACH,KAAK,gBAAgB,EAMxB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,KAAK,EACR,iBAAiB,EAAE,cAAc,EAAE,eAAe,EAAE,YAAY,EAAkB,YAAY,EACjG,MAAM,SAAS,CAAC;AAMjB,0CAA0C;AAC1C,eAAO,MAAM,oBAAoB,+FAAgG,CAAC;AAUlI;;;GAGG;AACH,eAAO,MAAM,2BAA2B,aAAoD,CAAC;AAmB7F,4DAA4D;AAC5D,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,KAAG,MACiC,CAAC;AAE9E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpE;AAID,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAaxE;AAgCD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,MAAM,SAAK,EAAE,MAAM,GAAE,cAAyB,GAAG,YAAY,EAAE,CAExH;AAuLD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAIxF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,GAAG,OAAO,CAInG;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAE1F;AAED;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,cAAc,CAAqE,CAAC;AAEnI,wFAAwF;AACxF,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,YAAY,EAAE,CAIrF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE9G;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,GAAG,iBAAiB,EAAE,CAE/F;AAED,wHAAwH;AACxH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,eAC+E,CAAC"}