@3driseai/3drise-core 1.0.28 → 1.0.30

package/dist/properties/tables/imageProperties.d.ts

@@ -0,0 +1,4 @@
+import type { OptionalProperty } from './optionalProperties';
+import type { ImageObjectType } from '../../types/imageObjects';
+export declare const IMAGE_PROPERTIES: Record<ImageObjectType, OptionalProperty[]>;
+//# sourceMappingURL=imageProperties.d.ts.map

package/dist/properties/tables/imageProperties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageProperties.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/imageProperties.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAOhE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,CAkOxE,CAAC"}

package/dist/properties/tables/imageProperties.js

@@ -0,0 +1,231 @@
+// =============================================================================
+// IMAGE OBJECTS OPTIONAL PROPERTIES
+// Order: structure (rebuild), the change, idle, look, pointer, colours.
+// =============================================================================
+export const IMAGE_PROPERTIES = {
+    shards: [
+        { name: 'order', label: 'Order', description: 'Which shards go first when the picture changes: a linear sweep, rings from the centre, or at random', type: 'select', options: ['sweep', 'radial', 'random'], optionLabels: ['Sweep', 'Radial', 'Random'] },
+        { name: 'pointerMode', label: 'Pointer mode', description: 'What the cursor does over the picture: off, tilts the shards to face it, lifts them under it, or sends ripples through the slab', type: 'select', options: ['none', 'tilt', 'lift', 'ripple'], optionLabels: ['Off', 'Tilt', 'Lift', 'Ripple'] },
+        { name: 'cols', label: 'Columns', description: 'Shards across the slab (rebuilds)', type: 'number', min: 4, max: 96, step: 1 },
+        { name: 'rows', label: 'Rows', description: 'Shards down the slab (rebuilds)', type: 'number', min: 1, max: 64, step: 1 },
+        { name: 'tiling', label: 'Tiling', description: 'Irregularity of the shard tiling: 0 a regular grid, 1 strongly jittered polygons (rebuilds)', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'aspect', label: 'Aspect', description: 'Slab width / height; 0 = the first picture\'s own aspect ratio (rebuilds)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'seed', label: 'Seed', description: 'Seed of the tiling (rebuilds)', type: 'number', min: 1, max: 999, step: 1 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 6, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'spread', label: 'Spread', description: 'Width of the travelling front: how much of the slab is in flight at once', type: 'number', min: 0.05, max: 1, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction of the sweep in degrees, 0 = left to right', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'delayJitter', label: 'Delay jitter', description: 'Per-shard randomness of the departure time', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'lift', label: 'Lift', description: 'How far shards rise off the slab (the slab is 2 units wide)', type: 'number', min: 0, max: 1.5, step: 0.01 },
+        { name: 'drift', label: 'Drift', description: 'Sideways scatter while in flight', type: 'number', min: 0, max: 0.8, step: 0.01 },
+        { name: 'spin', label: 'Spin', description: 'Tumble while in flight', type: 'number', min: 0, max: 2.5, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'Slow relief of the slab at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'kenBurns', label: 'Ken Burns', description: 'Slow zoom and drift of the picture inside the shards', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'seams', label: 'Seams', description: 'Visibility of the gaps between shards at rest', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'rim', label: 'Rim light', description: 'Light caught on tilted shards', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts on the shards', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor over the slab (the slab is 2 units wide)', type: 'number', min: 0.2, max: 3, step: 0.01 },
+        { name: 'edgeColor', label: 'Seam colour', description: 'Colour of the seams and bevels', type: 'color' },
+        { name: 'rimColor', label: 'Rim colour', description: 'Colour of the light caught on tilted shards', type: 'color' },
+        { name: 'backColor', label: 'Backing colour', description: 'Colour of the slab\'s backing, seen where shards have left', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of the shards the cursor touches', type: 'color' },
+    ],
+    projector: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'stir: the dust swirls where the cursor\'s ray crosses the beam · hotspot: the lamp\'s hotspot leans toward the cursor', type: 'select', options: ['none', 'stir', 'hotspot'], optionLabels: ['Off', 'Stir', 'Hotspot'] },
+        { name: 'dustCount', label: 'Dust', description: 'Dust motes in the beam (rebuilds)', type: 'number', min: 0, max: 4000, step: 50 },
+        { name: 'throw', label: 'Throw', description: 'How far in front of the screen the lens hangs', type: 'number', min: 0.6, max: 6, step: 0.05 },
+        { name: 'lensHeight', label: 'Lens height', description: 'How high above the screen\'s centre the lens hangs', type: 'number', min: -2, max: 3, step: 0.01 },
+        { name: 'haze', label: 'Haze', description: 'How much the beam shows in the air', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'dust', label: 'Dust', description: 'Brightness of the dust', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'dustDrift', label: 'Dust drift', description: 'How fast the dust drifts', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'defocus', label: 'Defocus', description: 'How far the lens racks out of focus during a change', type: 'number', min: 0, max: 1.5, step: 0.01 },
+        { name: 'hunt', label: 'Hunt', description: 'The small overshoot as focus comes back', type: 'number', min: 0, max: 1.5, step: 0.01 },
+        { name: 'vignette', label: 'Vignette', description: 'Fall-off of the lamp toward the screen\'s edges', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'flicker', label: 'Flicker', description: 'Lamp flicker', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'screenGain', label: 'Screen gain', description: 'Brightness of the screen', type: 'number', min: 0.2, max: 2, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'lampColor', label: 'Lamp colour', description: 'Colour of the lamp', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    relief: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'press: dents the paper under the cursor · rake: deepens the relief around it', type: 'select', options: ['none', 'press', 'rake'], optionLabels: ['Off', 'Press', 'Rake'] },
+        { name: 'detail', label: 'Detail', description: 'Subdivisions across the sheet (rebuilds). More = finer relief', type: 'number', min: 64, max: 400, step: 1 },
+        { name: 'depth', label: 'Depth', description: 'How deep the picture is pressed into the paper', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'crest', label: 'Crest', description: 'Height of the soft crest that travels across during a change', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'spread', label: 'Spread', description: 'Width of the travelling front: how much of the sheet changes at once', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction the press travels (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'roughness', label: 'Roughness', description: 'Paper finish: low = satin, high = matte', type: 'number', min: 0.2, max: 1, step: 0.01 },
+        { name: 'selfLight', label: 'Self light', description: 'A little of the picture\'s own colour on top of the scene light, so it reads in dim scenes', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'paperColor', label: 'Paper colour', description: 'The blank paper (seen in the entrance and under light inks)', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    pinscreen: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'press: pins sink under the cursor · lift: pins rise toward it', type: 'select', options: ['none', 'press', 'lift'], optionLabels: ['Off', 'Press', 'Lift'] },
+        { name: 'cols', label: 'Cols', description: 'Pins across (rebuilds). The rows follow the frame', type: 'number', min: 30, max: 200, step: 1 },
+        { name: 'depth', label: 'Depth', description: 'How far the brightest pins stand out of the plate', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'dip', label: 'Dip', description: 'How far the change wave sinks the pins before they rise to the new picture', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'spread', label: 'Spread', description: 'Width of the travelling wave', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction the wave travels (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'pinSize', label: 'Head size', description: 'Head diameter as a share of the pin spacing', type: 'number', min: 0.4, max: 1, step: 0.01 },
+        { name: 'metal', label: 'Metal', description: 'Metalness of the shafts', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'roughness', label: 'Roughness', description: 'Polish of the heads and shafts', type: 'number', min: 0.05, max: 1, step: 0.01 },
+        { name: 'selfLight', label: 'Self light', description: 'A little of the picture\'s own colour on the heads, so dark pictures still read', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'pinColor', label: 'Pin colour', description: 'Colour of the metal shafts', type: 'color' },
+        { name: 'plateColor', label: 'Plate colour', description: 'Colour of the plate the pins go through', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    prism: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'tilt: prisms turn toward the cursor · wave: a ripple of turns spreads from it', type: 'select', options: ['none', 'tilt', 'wave'], optionLabels: ['Off', 'Tilt', 'Wave'] },
+        { name: 'count', label: 'Count', description: 'Prisms across the picture (rebuilds)', type: 'number', min: 12, max: 140, step: 1 },
+        { name: 'vertical', label: 'Vertical', description: 'Prisms stand upright (off: they lie horizontally and turn top to bottom) (rebuilds)', type: 'boolean' },
+        { name: 'spread', label: 'Spread', description: 'Width of the travelling wave: how many prisms turn at once', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction of the wave (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'settle', label: 'Settle', description: 'How much each prism overshoots and settles at the end of its turn', type: 'number', min: 0, max: 1.5, step: 0.01 },
+        { name: 'gap', label: 'Gap', description: 'Gap between neighbouring prisms', type: 'number', min: 0, max: 0.4, step: 0.005 },
+        { name: 'roughness', label: 'Roughness', description: 'Finish of the faces: low = glossy print, high = matte', type: 'number', min: 0.05, max: 1, step: 0.01 },
+        { name: 'selfLight', label: 'Self light', description: 'A little of the picture\'s own colour on top of the scene light', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'slatColor', label: 'Slat colour', description: 'Colour of the third face (seen edge-on during a turn)', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    lenticular: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'peek: lenses near the cursor flip back to the previous picture · bend: the sheet bows toward the cursor', type: 'select', options: ['none', 'peek', 'bend'], optionLabels: ['Off', 'Peek', 'Bend'] },
+        { name: 'lenses', label: 'Lenses', description: 'Lenses across the print', type: 'number', min: 20, max: 300, step: 1 },
+        { name: 'thickness', label: 'Thickness', description: 'How much the viewing angle shifts what a lens shows (the lens depth)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'sharpness', label: 'Sharpness', description: 'How crisp the flip between the two pictures is', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'ghost', label: 'Ghost', description: 'Faint colour fringes at the flip line, as real lenticular prints have', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'ridge', label: 'Ridge', description: 'How much the lens ridges show in the highlights', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'spread', label: 'Spread', description: 'Width of the sweep across the sheet', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction of the sweep (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'roughness', label: 'Roughness', description: 'Finish of the print under the lenses', type: 'number', min: 0.1, max: 1, step: 0.01 },
+        { name: 'gloss', label: 'Gloss', description: 'Roughness of the lens surface: 0 = mirror-sharp highlights', type: 'number', min: 0, max: 0.6, step: 0.01 },
+        { name: 'selfLight', label: 'Self light', description: 'A little of the picture\'s own colour on top of the scene light', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    frost: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'wipe: a finger clears the glass along its path · fog: the cursor breathes frost onto it', type: 'select', options: ['none', 'wipe', 'fog'], optionLabels: ['Off', 'Wipe', 'Fog'] },
+        { name: 'gap', label: 'Gap', description: 'Distance between the print and the glass (parallax and refraction)', type: 'number', min: 0, max: 0.3, step: 0.005 },
+        { name: 'frost', label: 'Frost', description: 'How frosted the glass gets during a change', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'whiteness', label: 'Whiteness', description: 'How white the frost scatters (0 = clear blur only)', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'feather', label: 'Feather', description: 'How feathery the frost front is', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'rim', label: 'Rim', description: 'Frost that stays at the edges of the glass at rest', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'refrost', label: 'Refrost', description: 'Seconds a wiped trail takes to frost over again', type: 'number', min: 0.5, max: 10, step: 0.1, unit: 's' },
+        { name: 'selfLight', label: 'Self light', description: 'A little of the print\'s own colour on top of the scene light', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'frostColor', label: 'Frost colour', description: 'Colour of the frost', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    roll: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'lift: the paper rises toward the cursor · press: it dents under it', type: 'select', options: ['none', 'lift', 'press'], optionLabels: ['Off', 'Lift', 'Press'] },
+        { name: 'detail', label: 'Detail', description: 'Subdivisions of the sheet (rebuilds). More = a rounder roll', type: 'number', min: 60, max: 400, step: 1 },
+        { name: 'rollSize', label: 'Roll size', description: 'Radius of the roll at its widest', type: 'number', min: 0.2, max: 3, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction the roll travels (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'skew', label: 'Skew', description: 'One end of the roll leads the other', type: 'number', min: -0.5, max: 0.5, step: 0.01 },
+        { name: 'roughness', label: 'Roughness', description: 'Paper finish: low = satin, high = matte', type: 'number', min: 0.2, max: 1, step: 0.01 },
+        { name: 'selfLight', label: 'Self light', description: 'A little of the print\'s own colour on top of the scene light', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'paperColor', label: 'Paper colour', description: 'The back of the paper (the outside of the roll)', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    contour: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'open: the picture opens into contours around the cursor · ripple: the levels bend in a ring', type: 'select', options: ['none', 'open', 'ripple'], optionLabels: ['Off', 'Open', 'Ripple'] },
+        { name: 'levels', label: 'Levels', description: 'Contour levels over the full brightness range', type: 'number', min: 6, max: 60, step: 1 },
+        { name: 'lineWidth', label: 'Line width', description: 'Line width in pixels', type: 'number', min: 0.5, max: 3, step: 0.05, unit: 'px' },
+        { name: 'depth', label: 'Depth', description: 'How far the contour stack opens into depth during a change', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'open', label: 'Open', description: 'How far the picture darkens away under the front', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'smoothing', label: 'Smoothing', description: 'Calmer, longer contours (higher) or finer detail (lower)', type: 'number', min: 0, max: 6, step: 0.05 },
+        { name: 'idleLines', label: 'Idle lines', description: 'Contours left visible on the picture at rest', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'tint', label: 'Tint', description: 'Line colour: 0 = the picture\'s own colour under the line, 1 = the line colour', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'spread', label: 'Spread', description: 'Width of the travelling front', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction of the front (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'lineColor', label: 'Line colour', description: 'Colour the lines lean toward (see tint)', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+    engraving: [
+        { name: 'pointerMode', label: 'Pointer mode', description: 'comb: strokes align with the cursor\'s motion · swirl: they wind around it', type: 'select', options: ['none', 'comb', 'swirl'], optionLabels: ['Off', 'Comb', 'Swirl'] },
+        { name: 'cols', label: 'Cols', description: 'Strokes across the picture (rebuilds)', type: 'number', min: 40, max: 320, step: 1 },
+        { name: 'length', label: 'Length', description: 'Stroke length, in cells (overlap makes continuous lines)', type: 'number', min: 0.5, max: 3, step: 0.01 },
+        { name: 'weight', label: 'Weight', description: 'Stroke width at full brightness', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'relief', label: 'Relief', description: 'Brighter strokes stand closer: the plate\'s depth', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'hatch', label: 'Hatch', description: 'Direction of the hatching where the picture has no strong form to follow', type: 'number', min: -90, max: 90, step: 1, unit: '°' },
+        { name: 'lift', label: 'Lift', description: 'How far strokes lift off the plate while they turn', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'flow', label: 'Flow', description: 'How calm the stroke directions are (higher = longer, smoother flow)', type: 'number', min: 0.5, max: 5, step: 0.05 },
+        { name: 'fill', label: 'Fill', description: 'The picture\'s hue washed into the paper', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'tint', label: 'Tint', description: 'Ink colour: 0 = the ink colour, 1 = the picture\'s own hue', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'spread', label: 'Spread', description: 'Width of the travelling front', type: 'number', min: 0.1, max: 1.5, step: 0.01 },
+        { name: 'sweepAngle', label: 'Sweep angle', description: 'Direction of the front (degrees, 0 = left to right)', type: 'number', min: -180, max: 180, step: 1, unit: '°' },
+        { name: 'duration', label: 'Duration', description: 'Seconds a picture change takes', type: 'number', min: 0.3, max: 5, step: 0.05, unit: 's' },
+        { name: 'interval', label: 'Interval', description: 'Seconds each picture stays before the next change (several pictures); 0 = no automatic change', type: 'number', min: 0, max: 60, step: 0.5, unit: 's' },
+        { name: 'aspect', label: 'Aspect', description: 'Frame width / height; 0 = each picture\'s own (the frame eases between them)', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'breathe', label: 'Breathe', description: 'The idle life: a slow, barely-there movement at rest', type: 'number', min: 0, max: 2, step: 0.01 },
+        { name: 'intensity', label: 'Intensity', description: 'Overall brightness', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'opacity', label: 'Opacity', description: 'Overall opacity', type: 'number', min: 0, max: 1, step: 0.01 },
+        { name: 'pointerStrength', label: 'Pointer strength', description: 'How strongly the cursor acts', type: 'number', min: 0, max: 3, step: 0.01 },
+        { name: 'pointerRadius', label: 'Pointer radius', description: 'Reach of the cursor, in image units (the image is 2 wide)', type: 'number', min: 0.1, max: 2, step: 0.01 },
+        { name: 'plateColor', label: 'Plate colour', description: 'The paper', type: 'color' },
+        { name: 'inkColor', label: 'Ink colour', description: 'The ink', type: 'color' },
+        { name: 'pointerColor', label: 'Pointer colour', description: 'Tint of what the cursor touches', type: 'color' },
+    ],
+};

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

@@ -7,6 +7,8 @@ export * from './environmentProperties';
 export * from './spaceProperties';
 export * from './landProperties';
 export * from './textProperties';
+export * from './imageProperties';
+export * from './galleryProperties';
 export * from './materialBounds';
 export * from './geometryProperties';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/properties/tables/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/properties/tables/index.js

@@ -7,5 +7,7 @@ export * from './environmentProperties.js';
 export * from './spaceProperties.js';
 export * from './landProperties.js';
 export * from './textProperties.js';
+export * from './imageProperties.js';
+export * from './galleryProperties.js';
 export * from './materialBounds.js';
 export * from './geometryProperties.js';

package/dist/properties/tables/optionalProperties.d.ts

@@ -68,6 +68,7 @@ export declare const cirrusOptionalProperties: OptionalProperty[];
 export declare const thunderOptionalProperties: OptionalProperty[];
 export declare const cloudQualityOptionalProperties: OptionalProperty[];
 import type { GalleryLayout } from '../../types/gallery';
+export declare const GALLERY_FIELD_DEFS: Record<string, OptionalProperty>;
 /** Defaults mirror getInitialLayoutSettings, so a row left blank by a previous
  *  layout still shows a sane starting value instead of disappearing. */
 export declare const GALLERY_FIELD_DEFAULTS: Record<string, number>;

package/dist/properties/tables/optionalProperties.d.ts.map

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

package/dist/properties/tables/optionalProperties.js

@@ -655,7 +655,7 @@ export const cloudQualityOptionalProperties = [
 // GalleryLayouts.ts). A row for a field the active layout ignores does nothing,
 // so the whitelist is built per-layout from that same config.
 import { getLayoutSettingsFields } from '../../utils/GalleryLayouts.js';
-const GALLERY_FIELD_DEFS = {
+export const GALLERY_FIELD_DEFS = {
     columns: { name: 'columns', description: 'Number of columns in the grid', type: 'number', min: 1, max: 12, step: 1 },
     spacing: { name: 'spacing', description: 'Distance between adjacent frames', type: 'number', min: 0.5, max: 10, step: 0.1 },
     startX: { name: 'startX', description: 'Horizontal offset of the first frame', type: 'number', min: -20, max: 20, step: 0.5 },

package/dist/properties/types.d.ts

@@ -9,7 +9,7 @@ export type EnvironmentElement = (typeof ENVIRONMENT_ELEMENTS)[number];
  * (getAnimatableProperties), plus 'shadow' (a light's shadow block) and 'config'
  * (config knobs of objects with no animatable table: text, plain, mesh).
  */
-export type PropertyDomain = 'transform' | 'material' | 'edges' | 'light' | 'shadow' | 'particles' | 'effect' | 'grid' | 'environment' | 'space' | 'land' | 'text' | 'rain' | 'clouds' | 'config' | 'camera' | 'sky' | 'stars' | 'cirrus' | 'thunder' | 'ocean' | 'terrain';
+export type PropertyDomain = 'transform' | 'material' | 'edges' | 'light' | 'shadow' | 'particles' | 'effect' | 'grid' | 'environment' | 'space' | 'land' | 'text' | 'image' | 'gallery' | 'rain' | 'clouds' | 'config' | 'camera' | 'sky' | 'stars' | 'cirrus' | 'thunder' | 'ocean' | 'terrain';
 export interface PropertyOption {
     value: string;
     label?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/properties/types.ts"],"names":[],"mappings":"AAYA,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1H,0GAA0G;AAC1G,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3F,eAAO,MAAM,oBAAoB,gDAAiD,CAAC;AACnF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACpB,WAAW,GAAG,UAAU,GAAG,OAAO,GAClC,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAC/H,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IACzB;;yDAEqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACnD,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/properties/types.ts"],"names":[],"mappings":"AAYA,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1H,0GAA0G;AAC1G,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE3F,eAAO,MAAM,oBAAoB,gDAAiD,CAAC;AACnF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACpB,WAAW,GAAG,UAAU,GAAG,OAAO,GAClC,OAAO,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GACrJ,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IACzB;;yDAEqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACnD,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/commands.d.ts

@@ -57,6 +57,14 @@ export type SceneCommand =
     ref: string;
     command: ScenePlaybackCommand;
     options?: ScenePlayOptions;
+}
+/** `ref`: a gallery object's id, or '@all' (every gallery) / '@view' (the one in view). `goTo` takes `index`. An event: no on / off state. */
+ | {
+    id: string;
+    kind: 'gallery';
+    ref: string;
+    command: 'next' | 'prev' | 'goTo' | 'pause' | 'resume';
+    index?: number;
 };
 export type SceneCommandKind = SceneCommand['kind'];
 /** A stored list of commands (versioned, so an older viewer can tell it is newer than it knows). */
@@ -65,7 +73,8 @@ export interface SceneCommandList {
     commands: SceneCommand[];
 }
 /** What fired a command. */
-export type TriggerHost = 'interaction' | 'action' | 'sequence' | 'clip' | 'code' | 'agent' | 'studio';
+/** `key`: a keyboard key binding (sceneSettings.keyPadSettings.bindings). */
+export type TriggerHost = 'interaction' | 'action' | 'sequence' | 'clip' | 'code' | 'agent' | 'studio' | 'key';
 export interface TriggerSource {
     host: TriggerHost;
     /** The interaction (`<objectId>:<event>`), action, sequence, clip… id; for code, the caller's name. */

package/dist/types/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC9D,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC7B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,YAAY;AACpB,iGAAiG;AAC/F;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,SAAS,GAAG,iBAAiB,CAAA;CAAE,GAC/F;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE;AACpF,gCAAgC;GAC9B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE;AACzE;;;;GAIG;GACD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE;AACrG,+BAA+B;GAC7B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE;AAC/G,mCAAmC;GACjC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAExH,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpD,oGAAoG;AACpG,MAAM,WAAW,gBAAgB;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,4BAA4B;AAC5B,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvG,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,uGAAuG;IACvG,EAAE,EAAE,MAAM,CAAC;CACd"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC9D,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,gBAAgB;IAC7B,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,YAAY;AACpB,iGAAiG;AAC/F;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,SAAS,GAAG,iBAAiB,CAAA;CAAE,GAC/F;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE;AACpF,gCAAgC;GAC9B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE;AACzE;;;;GAIG;GACD;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,iBAAiB,CAAA;CAAE;AACrG,+BAA+B;GAC7B;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE;AAC/G,mCAAmC;GACjC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAAE;AACnH,8IAA8I;GAC5I;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3H,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpD,oGAAoG;AACpG,MAAM,WAAW,gBAAgB;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,4BAA4B;AAC5B,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE/G,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,uGAAuG;IACvG,EAAE,EAAE,MAAM,CAAC;CACd"}