babylon.quarks-editor 0.26.0 → 0.28.0

package/dist/core/projectStore.d.ts

@@ -1,9 +1,14 @@
 /** One editor project: a library of effect assets plus the scene built from them. */
 export interface ProjectMeta {
+    /** The project's key in its store. */
     id: string;
+    /** The project's display name. */
     name: string;
+    /** When the project was created, in milliseconds since the epoch. */
     createdAt: number;
+    /** When the project last changed, in milliseconds since the epoch. */
     updatedAt: number;
+    /** How many effect assets the project holds. */
     assetCount: number;
     /** Approximate bytes the project takes in storage (JSON + texture files). */
     sizeBytes: number;
@@ -12,23 +17,32 @@ export interface ProjectMeta {
 export interface StoredAsset {
     /** Relative path inside the project (`Fire/Explosion.json`) — the asset's key. */
     path: string;
+    /** The asset's display name, its file name without `.json`. */
     name: string;
+    /** The effect, as quarks JSON with its textures inlined. */
     json: unknown;
+    /** Files the effect referenced that were not imported with it. */
     missingFiles: string[];
 }
 /** One effect instance in a saved scene. */
 export interface StoredSceneEntry {
+    /** The instance's name in the Scene list. */
     name: string;
     /** Path of the asset it was made from, if any. */
     assetPath: string | null;
     /** The instance's own (possibly edited) effect, root transform included. */
     json: unknown;
+    /** Whether the instance was shown. */
     visible: boolean;
 }
+/** A project's saved scene: the effects placed in it, in Scene list order. */
 export interface StoredScene {
+    /** The scene's effect instances. */
     entries: StoredSceneEntry[];
+    /** When it was saved, in milliseconds since the epoch. */
     savedAt: number;
 }
+/** How much storage projects use, as far as the browser tells. */
 export interface StorageEstimate {
     /** Bytes the whole site uses (all projects), when the browser reports it. */
     usage: number | null;
@@ -42,20 +56,32 @@ export interface StorageEstimate {
  * everything in the browser, and an embedding host can supply its own (e.g. on disk).
  */
 export interface ProjectStore {
+    /** Every project, most recently changed first. */
     listProjects(): Promise<ProjectMeta[]>;
+    /** One project, or null when there is none with that id. */
     getProject(id: string): Promise<ProjectMeta | null>;
+    /** Creates an empty project. */
     createProject(name: string): Promise<ProjectMeta>;
+    /** Renames a project. */
     renameProject(id: string, name: string): Promise<void>;
+    /** Copies a project, its assets and its scene, under a new name. */
     duplicateProject(id: string, name: string): Promise<ProjectMeta>;
+    /** Deletes a project, its assets and its scene. */
     deleteProject(id: string): Promise<void>;
+    /** A project's assets. */
     loadAssets(projectId: string): Promise<StoredAsset[]>;
     /** Adds or replaces assets by path. */
     putAssets(projectId: string, assets: StoredAsset[]): Promise<void>;
+    /** Deletes assets by path; paths it does not have are ignored. */
     deleteAssets(projectId: string, paths: string[]): Promise<void>;
+    /** A project's saved scene, or null when it was never saved. */
     loadScene(projectId: string): Promise<StoredScene | null>;
+    /** Replaces a project's saved scene. */
     saveScene(projectId: string, scene: StoredScene): Promise<void>;
+    /** How much storage projects use. */
     estimate(): Promise<StorageEstimate>;
     /** Asks the browser to keep the data even under storage pressure; resolves to the result. */
     requestPersistence(): Promise<boolean>;
 }
+/** A byte count for people: `512 B`, `1.5 KB`, `20 MB`; `—` when unknown. */
 export declare function formatBytes(bytes: number | null | undefined): string;

package/dist/core/projectStore.js

@@ -1,3 +1,4 @@
+/** A byte count for people: `512 B`, `1.5 KB`, `20 MB`; `—` when unknown. */
 export function formatBytes(bytes) {
     if (bytes == null)
         return '—';

package/dist/core/sceneEntries.d.ts

@@ -1,20 +1,23 @@
-import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
-import type { Scene } from '@babylonjs/core/scene';
+import type { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
+import type { Scene } from '@babylonjs/core/scene.js';
 import type { BatchedRenderer, ParticleSystem } from 'babylon.quarks';
-import type { EffectAsset } from './assets';
-import { EffectBinding } from './binding';
+import type { EffectAsset } from './assets.js';
+import { EffectBinding } from './binding.js';
 /**
  * One effect instance placed in the scene. Every instance is live (its systems are registered
  * with the renderer) and independent: dropping the same asset three times gives three entries
  * that are edited separately.
  */
 export interface SceneEntry {
+    /** The instance's name in the Scene list, unique in the scene. */
     name: string;
     /** Path of the asset it came from, or a synthetic `_created/…` path for new effects. */
     path: string;
     /** Asset this instance was made from, if any. */
     assetId: number | null;
+    /** The instance's root node. */
     root: TransformNode;
+    /** Every particle system of the instance. */
     systems: ParticleSystem[];
 }
 /** `name`, or `name (2)`, `name (3)`… when an entry already uses it. */

package/dist/core/sceneEntries.js

@@ -1,6 +1,6 @@
 import { QuarksUtil } from 'babylon.quarks';
-import { EffectBinding } from './binding';
-import { disposeLoadedEffect, parseEffectFromJson } from './loadEffect';
+import { EffectBinding } from './binding.js';
+import { disposeLoadedEffect, parseEffectFromJson } from './loadEffect.js';
 /** `name`, or `name (2)`, `name (3)`… when an entry already uses it. */
 export function uniqueEntryName(name, existing) {
     const taken = new Set(existing.map((entry) => entry.name));

package/dist/core/scrub.d.ts

@@ -1,6 +1,6 @@
 import type { BatchedRenderer } from 'babylon.quarks';
-import type { EffectBinding } from './binding';
-/** Unpauses every system in the focused effect. */
+import type { EffectBinding } from './binding.js';
+/** Unpauses every system in the focused effect; one that has finished stays finished. */
 export declare function playFocus(binding: EffectBinding): void;
 /** Freezes the focused effect at its current simulation state. */
 export declare function pauseFocus(binding: EffectBinding): void;

package/dist/core/scrub.js

@@ -2,10 +2,10 @@ const WIDE_STEP_THRESHOLD = 8;
 function bindingSystems(binding) {
     return [binding.system, ...binding.subSystems];
 }
-/** Unpauses every system in the focused effect. */
+/** Unpauses every system in the focused effect; one that has finished stays finished. */
 export function playFocus(binding) {
     for (const system of bindingSystems(binding)) {
-        system.play();
+        system.resume();
     }
 }
 /** Freezes the focused effect at its current simulation state. */

package/dist/core/shapes.d.ts

@@ -1,22 +1,41 @@
-import type { Mesh } from '@babylonjs/core/Meshes/mesh';
+import type { Mesh } from '@babylonjs/core/Meshes/mesh.js';
 import type { EmitterShape } from 'babylon.quarks';
 import { BoxEmitFrom, EmitterMode } from 'babylon.quarks';
+/** The emitter shapes the Shape module offers, by the `type` they serialise with. */
 export type ShapeType = 'point' | 'sphere' | 'hemisphere' | 'cone' | 'circle' | 'donut' | 'rectangle' | 'grid' | 'box' | 'edge' | 'mesh_surface';
+/** The Shape module's shape list, in menu order, with the label each shows. */
 export declare const SHAPE_TYPES: Array<{
+    /** The shape's type. */
     value: ShapeType;
+    /** Its label in the menu. */
     label: string;
 }>;
+/**
+ * Every shape's settings in one flat record, so switching shapes keeps what the shapes share
+ * (a cone's radius becomes the sphere's). Each shape reads the fields it has.
+ */
 export interface ShapeParams {
+    /** Radius of a sphere, hemisphere, cone, circle or donut. */
     radius: number;
+    /** The part of the circle emitted from, in radians (2π: all of it). */
     arc: number;
+    /** 0 emits from the surface only, 1 from the whole volume. */
     thickness: number;
+    /** A cone's half angle, in radians. */
     angle: number;
+    /** The radius of a donut's tube. */
     donutRadius: number;
+    /** Width of a rectangle, grid or box (X). */
     width: number;
+    /** Height of a rectangle, grid or box (Y). */
     height: number;
+    /** How points around the arc are picked: at random, in a loop, back and forth or in bursts. */
     mode: EmitterMode;
+    /** Snaps the arc position to steps of this fraction; 0 for none. */
     spread: number;
+    /** A grid's column count. */
     column: number;
+    /** A grid's row count. */
     row: number;
     /** Box depth (Z). */
     depth: number;
@@ -24,14 +43,19 @@ export interface ShapeParams {
     emitFrom: BoxEmitFrom;
     /** How fast an edge emitter's loop / ping-pong point travels, in lengths per second. */
     speed: number;
+    /** The mesh a mesh surface emitter emits from. */
     mesh?: Mesh;
 }
+/** The settings a new shape starts from. */
 export declare const DEFAULT_SHAPE_PARAMS: ShapeParams;
+/** The type of a shape, as the Shape module lists it. */
 export declare function getShapeType(shape: EmitterShape): ShapeType;
+/** A shape's settings, the fields it does not have taken from {@link DEFAULT_SHAPE_PARAMS}. */
 export declare function readShapeParams(shape: EmitterShape): ShapeParams;
 /** Which parameters are relevant per shape type (drives the UI). `mesh_surface`'s mesh
  * reference isn't a NumberField, so it's handled separately by the Shape module. */
 export declare const SHAPE_PARAM_KEYS: {
     [K in ShapeType]: Array<keyof ShapeParams>;
 };
+/** A new shape of `type`, built from the fields of `params` it has. */
 export declare function createShape(type: ShapeType, params: ShapeParams): EmitterShape;

package/dist/core/shapes.js

@@ -1,4 +1,5 @@
 import { BoxEmitFrom, BoxEmitter, CircleEmitter, ConeEmitter, ConstantValue, DonutEmitter, EdgeEmitter, EmitterMode, GridEmitter, HemisphereEmitter, MeshSurfaceEmitter, PointEmitter, RectangleEmitter, SphereEmitter, } from 'babylon.quarks';
+/** The Shape module's shape list, in menu order, with the label each shows. */
 export const SHAPE_TYPES = [
     { value: 'cone', label: 'Cone' },
     { value: 'sphere', label: 'Sphere' },
@@ -12,6 +13,7 @@ export const SHAPE_TYPES = [
     { value: 'mesh_surface', label: 'Mesh surface' },
     { value: 'point', label: 'Point' },
 ];
+/** The settings a new shape starts from. */
 export const DEFAULT_SHAPE_PARAMS = {
     radius: 0.3,
     arc: Math.PI * 2,
@@ -29,10 +31,12 @@ export const DEFAULT_SHAPE_PARAMS = {
     speed: 1,
     mesh: undefined,
 };
+/** The type of a shape, as the Shape module lists it. */
 export function getShapeType(shape) {
     const type = shape.type ?? 'point';
     return (SHAPE_TYPES.some((s) => s.value === type) ? type : 'point');
 }
+/** A shape's settings, the fields it does not have taken from {@link DEFAULT_SHAPE_PARAMS}. */
 export function readShapeParams(shape) {
     const anyShape = shape;
     const num = (key, fallback) => typeof anyShape[key] === 'number' ? anyShape[key] : fallback;
@@ -69,6 +73,7 @@ export const SHAPE_PARAM_KEYS = {
     edge: ['radius', 'speed'],
     mesh_surface: [],
 };
+/** A new shape of `type`, built from the fields of `params` it has. */
 export function createShape(type, params) {
     switch (type) {
         case 'point':

package/dist/core/systems.d.ts

@@ -1,7 +1,9 @@
-import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
+import type { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
 import { ParticleSystem } from 'babylon.quarks';
-import type { EffectBinding } from './binding';
+import type { EffectBinding } from './binding.js';
+/** How {@link createChildSystem} builds a new system. */
 export interface ChildSystemOptions {
+    /** The new emitter's name. */
     name?: string;
     /** One-shot burst (sub-emitter target) instead of a looping stream. */
     oneShot?: boolean;

package/dist/core/systems.js

@@ -43,7 +43,9 @@ export function unlinkSubEmitterReferences(systems, removed) {
         const behaviors = system.behaviors;
         for (let i = behaviors.length - 1; i >= 0; i--) {
             const behavior = behaviors[i];
-            if (behavior.type === 'EmitSubParticleSystem' && removedEmitters.has(behavior.subParticleSystem)) {
+            if (behavior.type === 'EmitSubParticleSystem' &&
+                behavior.subParticleSystem &&
+                removedEmitters.has(behavior.subParticleSystem)) {
                 behaviors.splice(i, 1);
             }
         }

package/dist/core/textureExport.d.ts

@@ -1,4 +1,4 @@
-import type { Texture } from '@babylonjs/core/Materials/Textures/texture';
+import type { Texture } from '@babylonjs/core/Materials/Textures/texture.js';
 /**
  * Ensures a texture's `.url` can be reloaded in a different Scene/Engine, baking its live
  * GPU pixels into a real base64 PNG data URI when it currently only carries Babylon's

package/dist/core/timeline.d.ts

@@ -1,24 +1,44 @@
-import type { TransformNode } from '@babylonjs/core/Meshes/transformNode';
+import type { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
 import type { FunctionValueGenerator, ParticleSystem, ValueGenerator } from 'babylon.quarks';
-import type { EffectBinding } from './binding';
-export type TimelineRow = {
+import type { EffectBinding } from './binding.js';
+/** A timeline row for a group node: a heading over the tracks of the systems under it. */
+export interface TimelineGroupRow {
+    /** Tells group rows from track rows. */
     kind: 'group';
+    /** The group's node. */
     node: TransformNode;
+    /** The group's name. */
     name: string;
+    /** How deep the group sits in the effect tree; the root's children are 0. */
     depth: number;
-} | {
+}
+/** A timeline row for one particle system: a bar from its start delay over its duration. */
+export interface TimelineSystemRow {
+    /** Tells group rows from track rows. */
     kind: 'track';
+    /** The system's emitter node. */
     node: TransformNode;
+    /** The system. */
     system: ParticleSystem;
+    /** The emitter's name. */
     name: string;
+    /** How deep the emitter sits in the effect tree. */
     depth: number;
+    /** True for the effect's main system. */
     isRoot: boolean;
+    /** False for the one system an effect cannot lose. */
     removable: boolean;
+    /** Where the bar starts: the start delay, its lower end when random, in seconds. */
     startOffset: number;
+    /** True when the start delay is a curve and the bar's start is only indicative. */
     startOffsetVariable: boolean;
+    /** The bar's length, the system's duration in seconds. */
     duration: number;
+    /** True when the system loops; its bar runs to the end of the ruler. */
     looping: boolean;
-};
+}
+/** One row of the focused effect's timeline. */
+export type TimelineRow = TimelineGroupRow | TimelineSystemRow;
 /**
  * Reads a representative start-delay value for display without invoking the generator's
  * stateful `genValue` (IntervalValue caches its sampled slot on first call and returns NaN

package/dist/core/transport.d.ts

@@ -1,7 +1,7 @@
-import type { Scene } from '@babylonjs/core/scene';
+import type { Scene } from '@babylonjs/core/scene.js';
 import type { BatchedRenderer } from 'babylon.quarks';
-import type { EffectBinding } from './binding';
-import { type PlaybackState } from './playback';
+import type { EffectBinding } from './binding.js';
+import { type PlaybackState } from './playback.js';
 /**
  * Stage Play/Pause shared by the viewport transport bar and the timeline. Pressing Play on a
  * one-shot focus that already parked at its end replays it from the start.

package/dist/core/transport.js

@@ -1,5 +1,5 @@
-import { clearFocusFinished, isFocusFinished, setFocusElapsed } from './playback';
-import { playFocus, scrubFocusTo } from './scrub';
+import { clearFocusFinished, isFocusFinished, setFocusElapsed } from './playback.js';
+import { playFocus, scrubFocusTo } from './scrub.js';
 /**
  * Stage Play/Pause shared by the viewport transport bar and the timeline. Pressing Play on a
  * one-shot focus that already parked at its end replays it from the start.

package/dist/core/values.d.ts

@@ -1,27 +1,44 @@
-import type { FunctionValueGenerator, ValueGenerator } from 'babylon.quarks';
+import type { FunctionValueGenerator, RotationGenerator, ValueGenerator, Vector3Generator } from 'babylon.quarks';
 import { PiecewiseBezier } from 'babylon.quarks';
+/** A generator of one number: a constant or random value, or a curve over the particle's life. */
 export type ScalarGenerator = ValueGenerator | FunctionValueGenerator;
+/** Any generator a value field can be pointed at; ones that are not scalar read as the default. */
+export type AnyGenerator = ScalarGenerator | Vector3Generator | RotationGenerator;
+/** How a value field produces its number: Unity's Constant, Random Between Two Constants or Curve. */
 export type ScalarMode = 'constant' | 'random' | 'curve';
 /** Editable snapshot of a scalar value generator. */
 export interface ScalarValueState {
+    /** Which of the fields below is the value. */
     mode: ScalarMode;
     /** Constant value (mode: constant). */
     value: number;
-    /** Random range (mode: random). */
+    /** Lower end of the random range (mode: random). */
     min: number;
+    /** Upper end of the random range (mode: random). */
     max: number;
     /** Cubic bezier control values over normalized lifetime (mode: curve). */
     curve: [number, number, number, number];
 }
-export declare function readScalar(generator: ScalarGenerator | undefined): ScalarValueState;
+/**
+ * What a value field shows for `generator`: its constant, its range or its first curve segment.
+ * Anything else, including a missing generator, reads as the constant 1.
+ */
+export declare function readScalar(generator: AnyGenerator | undefined): ScalarValueState;
+/** The generator a value field's state describes; a curve state builds a one-segment curve. */
+export declare function buildScalar(state: ScalarValueState & {
+    mode: 'curve';
+}): PiecewiseBezier;
 export declare function buildScalar(state: ScalarValueState): ScalarGenerator;
 /** One segment of a piecewise bezier curve: start x (0..1) + four control values. */
 export interface CurvePiece {
+    /** Where the segment starts, 0..1 over the particle's life. */
     start: number;
+    /** The segment's four bezier control values. */
     p: [number, number, number, number];
 }
 /** Reads pieces from a PiecewiseBezier (or synthesizes one segment for other generators). */
-export declare function readPieces(generator: ScalarGenerator | undefined): CurvePiece[];
+export declare function readPieces(generator: AnyGenerator | undefined): CurvePiece[];
+/** A piecewise bezier from segments, sorted by their start. */
 export declare function buildCurve(pieces: CurvePiece[]): PiecewiseBezier;
 /** Splits the piece containing x into two exact halves using Bezier.split. */
 export declare function splitPieces(pieces: CurvePiece[], x: number): CurvePiece[];

package/dist/core/values.js

@@ -1,4 +1,8 @@
 import { Bezier, ConstantValue, IntervalValue, PiecewiseBezier } from 'babylon.quarks';
+/**
+ * What a value field shows for `generator`: its constant, its range or its first curve segment.
+ * Anything else, including a missing generator, reads as the constant 1.
+ */
 export function readScalar(generator) {
     const state = { mode: 'constant', value: 1, min: 0.5, max: 1.5, curve: [0, 1, 1, 0] };
     if (generator instanceof ConstantValue) {
@@ -44,6 +48,7 @@ export function readPieces(generator) {
     const fallback = readScalar(generator);
     return [{ start: 0, p: fallback.curve }];
 }
+/** A piecewise bezier from segments, sorted by their start. */
 export function buildCurve(pieces) {
     const sorted = [...pieces].sort((a, b) => a.start - b.start);
     return new PiecewiseBezier(sorted.map((piece) => [new Bezier(...piece.p), piece.start]));

package/dist/core/viewportPicker.d.ts

@@ -1,7 +1,7 @@
-import '@babylonjs/core/Culling/ray';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode';
-import type { Scene } from '@babylonjs/core/scene';
-import type { SceneEntry } from './sceneEntries';
+import '@babylonjs/core/Culling/ray.js';
+import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
+import type { Scene } from '@babylonjs/core/scene.js';
+import type { SceneEntry } from './sceneEntries.js';
 /**
  * Viewport pick/hover for visible scene effect roots only (not child emitters).
  * Hover uses the same ground ring as focus selection, in yellow.

package/dist/core/viewportPicker.js

@@ -1,7 +1,7 @@
-import '@babylonjs/core/Culling/ray';
-import { MeshBuilder } from '@babylonjs/core/Meshes/meshBuilder';
-import { EDITOR_SCENE_NODE_METADATA } from './editorScene';
-import { GROUND_RING_RADIUS, GalleryHoverMarker } from './gallerySelectionMarker';
+import '@babylonjs/core/Culling/ray.js';
+import { MeshBuilder } from '@babylonjs/core/Meshes/meshBuilder.js';
+import { EDITOR_SCENE_NODE_METADATA } from './editorScene.js';
+import { GROUND_RING_RADIUS, GalleryHoverMarker } from './gallerySelectionMarker.js';
 /** Invisible pick proxy size — matches the ground ring footprint. */
 const PICK_DIAMETER = GROUND_RING_RADIUS * 2;
 /**
@@ -34,9 +34,10 @@ export class GalleryViewportPicker {
         else if (soloRoot && !soloRoot.isDisposed()) {
             this.createHandle(soloRoot);
         }
-        const hovered = this.hoveredRoot;
-        this.hoveredRoot = null;
-        this.setHover(hovered && !hovered.isDisposed() ? hovered : null);
+        if (this.hoveredRoot?.isDisposed()) {
+            this.hoveredRoot = null;
+            this.hoverMarker.hide();
+        }
     }
     /** Yellow focus-style ring under the hovered effect root. */
     setHover(effectRoot) {

package/dist/index.d.ts

@@ -1,21 +1,25 @@
-export { EffectBinding } from './core/binding';
-export type { EditorListener } from './core/binding';
-export { GroundPlaneResolver, ensureGroundResolver } from './core/collision';
-export { DEFAULT_GRADIENT_STOPS, buildColorOverLife, buildGradient, findBehavior, hexToRgb, rgbToHex, rgbaToVector4, stopToCss, stopsToCssGradient, } from './core/colors';
-export type { GradientStop } from './core/colors';
-export { buildEffectTree, collectSystems, serializeEffectForest, serializeEffectTree } from './core/effectTree';
-export type { EffectTreeNode } from './core/effectTree';
-export { EffectHistory } from './core/history';
-export type { HistoryStacks } from './core/history';
-export { IndexedDbProjectStore } from './core/indexedDbProjectStore';
-export { applyRendererMaterial, getMaterialLabel } from './core/material';
-export type { RendererMaterialPatch } from './core/material';
-export { formatBytes } from './core/projectStore';
-export type { ProjectMeta, ProjectStore, StorageEstimate, StoredAsset, StoredScene, StoredSceneEntry, } from './core/projectStore';
-export { DEFAULT_SHAPE_PARAMS, SHAPE_PARAM_KEYS, SHAPE_TYPES, createShape, getShapeType, readShapeParams, } from './core/shapes';
-export type { ShapeParams, ShapeType } from './core/shapes';
-export { createChildSystem } from './core/systems';
-export type { ChildSystemOptions } from './core/systems';
-export { ensurePortableTextureUrl } from './core/textureExport';
-export { buildCurve, buildScalar, mergePieces, readPieces, readScalar, sampleCurve, splitPieces } from './core/values';
-export type { CurvePiece, ScalarGenerator, ScalarMode, ScalarValueState } from './core/values';
+export type { AssetLoadProgress, EffectAsset } from './core/assets.js';
+export type { AssetDragPayload } from './core/assetTree.js';
+export { EffectBinding } from './core/binding.js';
+export type { EditorListener } from './core/binding.js';
+export { GroundPlaneResolver, ensureGroundResolver } from './core/collision.js';
+export { DEFAULT_GRADIENT_STOPS, buildColorOverLife, buildGradient, findBehavior, hexToRgb, rgbToHex, rgbaToVector4, stopToCss, stopsToCssGradient, } from './core/colors.js';
+export type { GradientStop } from './core/colors.js';
+export { buildEffectTree, collectSystems, serializeEffectForest, serializeEffectTree } from './core/effectTree.js';
+export type { EffectTreeNode } from './core/effectTree.js';
+export { EffectHistory } from './core/history.js';
+export type { HistoryStacks } from './core/history.js';
+export { IndexedDbProjectStore } from './core/indexedDbProjectStore.js';
+export { applyRendererMaterial, getMaterialLabel } from './core/material.js';
+export type { RendererMaterialPatch } from './core/material.js';
+export { formatBytes } from './core/projectStore.js';
+export type { ProjectMeta, ProjectStore, StorageEstimate, StoredAsset, StoredScene, StoredSceneEntry, } from './core/projectStore.js';
+export type { SceneEntry } from './core/sceneEntries.js';
+export { DEFAULT_SHAPE_PARAMS, SHAPE_PARAM_KEYS, SHAPE_TYPES, createShape, getShapeType, readShapeParams, } from './core/shapes.js';
+export type { ShapeParams, ShapeType } from './core/shapes.js';
+export { createChildSystem } from './core/systems.js';
+export type { ChildSystemOptions } from './core/systems.js';
+export { ensurePortableTextureUrl } from './core/textureExport.js';
+export type { TimelineGroupRow, TimelineRow, TimelineSystemRow } from './core/timeline.js';
+export { buildCurve, buildScalar, mergePieces, readPieces, readScalar, sampleCurve, splitPieces } from './core/values.js';
+export type { AnyGenerator, CurvePiece, ScalarGenerator, ScalarMode, ScalarValueState } from './core/values.js';

package/dist/index.js

@@ -1,12 +1,12 @@
-export { EffectBinding } from './core/binding';
-export { GroundPlaneResolver, ensureGroundResolver } from './core/collision';
-export { DEFAULT_GRADIENT_STOPS, buildColorOverLife, buildGradient, findBehavior, hexToRgb, rgbToHex, rgbaToVector4, stopToCss, stopsToCssGradient, } from './core/colors';
-export { buildEffectTree, collectSystems, serializeEffectForest, serializeEffectTree } from './core/effectTree';
-export { EffectHistory } from './core/history';
-export { IndexedDbProjectStore } from './core/indexedDbProjectStore';
-export { applyRendererMaterial, getMaterialLabel } from './core/material';
-export { formatBytes } from './core/projectStore';
-export { DEFAULT_SHAPE_PARAMS, SHAPE_PARAM_KEYS, SHAPE_TYPES, createShape, getShapeType, readShapeParams, } from './core/shapes';
-export { createChildSystem } from './core/systems';
-export { ensurePortableTextureUrl } from './core/textureExport';
-export { buildCurve, buildScalar, mergePieces, readPieces, readScalar, sampleCurve, splitPieces } from './core/values';
+export { EffectBinding } from './core/binding.js';
+export { GroundPlaneResolver, ensureGroundResolver } from './core/collision.js';
+export { DEFAULT_GRADIENT_STOPS, buildColorOverLife, buildGradient, findBehavior, hexToRgb, rgbToHex, rgbaToVector4, stopToCss, stopsToCssGradient, } from './core/colors.js';
+export { buildEffectTree, collectSystems, serializeEffectForest, serializeEffectTree } from './core/effectTree.js';
+export { EffectHistory } from './core/history.js';
+export { IndexedDbProjectStore } from './core/indexedDbProjectStore.js';
+export { applyRendererMaterial, getMaterialLabel } from './core/material.js';
+export { formatBytes } from './core/projectStore.js';
+export { DEFAULT_SHAPE_PARAMS, SHAPE_PARAM_KEYS, SHAPE_TYPES, createShape, getShapeType, readShapeParams, } from './core/shapes.js';
+export { createChildSystem } from './core/systems.js';
+export { ensurePortableTextureUrl } from './core/textureExport.js';
+export { buildCurve, buildScalar, mergePieces, readPieces, readScalar, sampleCurve, splitPieces } from './core/values.js';

package/dist/react/AssetsPanel.d.ts

@@ -1,16 +1,23 @@
 import React from 'react';
-import { type AssetDragPayload } from '../core/assetTree';
-import { type AssetLoadProgress, type EffectAsset } from '../core/assets';
+import { type AssetDragPayload } from '../core/assetTree.js';
+import { type AssetLoadProgress, type EffectAsset } from '../core/assets.js';
+/** Props of {@link AssetsPanel}. */
 export interface AssetsPanelProps {
+    /** The assets, shown as a folder tree by their paths. */
     assets: EffectAsset[];
     /** Scene instance count per asset id. */
     instanceCounts: ReadonlyMap<number, number>;
+    /** Import progress while importing; the import buttons are disabled meanwhile. */
     loading: AssetLoadProgress | null;
+    /** The hidden folder input, clicked by hosts whose browser has no directory picker. */
     folderInputRef: React.RefObject<HTMLInputElement | null>;
+    /** Imports picked files. */
     onImportFiles: (files: FileList | File[]) => void;
+    /** Opens a folder to import. */
     onImportFolder: () => void;
     /** Adds a new instance of each asset in the payload to the scene. */
     onAddToScene: (payload: AssetDragPayload) => void;
+    /** Deletes the assets in the payload. */
     onDelete: (payload: AssetDragPayload) => void;
     /** Opens the asset on its own to edit it (double-click). Without it, double-click adds to the scene. */
     onOpenPrefab?: (asset: EffectAsset) => void;

package/dist/react/AssetsPanel.js

@@ -1,12 +1,12 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { ChevronDownIcon, ChevronRightIcon, ExclamationTriangleIcon, FolderIcon, FolderOpenIcon, SparklesIcon, } from '@heroicons/react/24/solid';
 import React, { useCallback, useMemo, useRef, useState } from 'react';
-import { setAssetDragSession } from '../core/assetDragSession';
-import { buildAssetTree, collectFolderAssets, folderChildren, searchAssets, writeAssetDrag, } from '../core/assetTree';
-import { assetIconUrl } from '../core/assets';
-import { ContextMenu } from './ContextMenu';
-import { iconStyle } from './icons';
-import { buttonStyle, hiddenFileInputStyle, inputStyle, theme } from './theme';
+import { setAssetDragSession } from '../core/assetDragSession.js';
+import { buildAssetTree, collectFolderAssets, folderChildren, searchAssets, writeAssetDrag, } from '../core/assetTree.js';
+import { assetIconUrl } from '../core/assets.js';
+import { ContextMenu } from './ContextMenu.js';
+import { iconStyle } from './icons.js';
+import { buttonStyle, hiddenFileInputStyle, inputStyle, theme } from './theme.js';
 const TREE_WIDTH = 200;
 const TILE_WIDTH = 92;
 function beginAssetDrag(e, payload) {

package/dist/react/ChoiceDialog.d.ts

@@ -1,13 +1,20 @@
 import React from 'react';
+/** One button of a {@link ChoiceDialog}. */
 export interface ChoiceDialogAction {
+    /** The button's text. */
     label: string;
+    /** Runs when the button is pressed. */
     onSelect: () => void;
     /** Accent button — also what Enter picks. */
     primary?: boolean;
+    /** Shows the button in red, for a destructive choice. */
     danger?: boolean;
 }
+/** Props of {@link ChoiceDialog}. */
 export interface ChoiceDialogProps {
+    /** The question. */
     title: string;
+    /** What the choice means. */
     message: React.ReactNode;
     /** Shown left to right; put the cancel action first. */
     actions: ChoiceDialogAction[];

package/dist/react/ChoiceDialog.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect } from 'react';
-import { buttonStyle, theme } from './theme';
+import { buttonStyle, theme } from './theme.js';
 /** Confirmation modal with several outcomes (e.g. Save / Don't save / Cancel). */
 export function ChoiceDialog(props) {
     const { title, message, actions, onCancel } = props;