- Included a new entry in the JSX documentation for `@inspect` variables, detailing their role as annotated constants that serve as live inspector controls.
- This addition enhances the clarity and usability of the documentation for developers working with variable annotations.
- Updated the VariableControl component to use the committed value instead of the live value for font family selection, improving consistency in variable previews.
- Modified the DocumentEditor to commit changes against the last committed value, ensuring accurate tracking of variable edits.
- Enhanced the InspectEntry interface to include committed values and a commit method, allowing for better management of variable states.
- Added support for boolean and select types in the @inspect annotation, allowing for more diverse variable configurations.
- Implemented UI controls for boolean toggles and select dropdowns in the inspector, improving user interaction.
- Updated the inspect plugin to validate options for select types and ensure proper initialization.
- Enhanced documentation to reflect the new variable types and their usage in the inspector.
- Introduced the `@inspect` annotation for top-level constants, allowing live editing through the inspector.
- Implemented the `VariablesSettings` component to manage and display `@inspect` variables in the sidebar.
- Enhanced the editor to handle variable edits, ensuring changes are reflected in the source code.
- Updated the history management to track variable changes, allowing for undo functionality.
- Added utility functions to manage `@inspect` entries within the project, ensuring consistent access across components.
- Updated the JSX version assignment in `projects.ts` to dynamically retrieve the app version, enhancing maintainability.
- Deleted the `use-running.ts` hook as it was no longer needed, streamlining the codebase.
- Bumped version numbers for the editor, CLI, desktop, web applications, and JSX package to 0.200.0 in package.json and package-lock.json.
- Ensured consistency in versioning across all related packages to reflect the latest updates and improvements.
- Bumped version numbers for the editor, CLI, desktop, and web applications to 0.132.2 in package.json and package-lock.json.
- Updated the dashboard feature labels in the web application to better reflect current offerings, enhancing clarity for users.
- Removed outdated features and added new ones to align with the latest capabilities of the platform.
- Modified the `capture` command to render single frames of a scene instead of a node, ensuring the output matches the export's encoding.
- Updated command descriptions and argument details to reflect the new functionality, including changes to the time reference and scene handling.
- Enhanced documentation for the `capture` command and related references to clarify usage and expected behavior.
- Improved error messages for invalid scene captures, guiding users to capture the correct scene id.
- Added a new channel `PROJECTS_FS_REAL_PATH` to resolve the real path of a given source, accommodating symbolic links.
- Updated the `listEntries` function to include a `link` property for entries that are symbolic links, improving asset management.
- Introduced the `realPathEntry` function to handle symlink resolution, ensuring accurate path retrieval.
- Enhanced the `removeEntry` function to prevent deletion of files outside the project directory, maintaining project integrity.
- Updated documentation to clarify symlink handling and the implications of linked assets in the project.
- Added console error logging for compile, render, and load failures in the EditorPage component to enhance debugging capabilities.
- Refactored the loadProject function call into a separate load function to handle errors more gracefully during project loading.
- Updated the motion system to use getLocalWindow instead of getSourceWindow for improved accuracy in local frame calculations.
- Updated the `listEntries` function in `projects.ts` to include support for symbolic links, ensuring they are treated as valid entries.
- Revised the `media.md` documentation to clarify the handling of symlinks in the asset library, emphasizing the benefits of linking over copying files.
- Improved the description of the `assets/` directory in `module.md` to reflect the inclusion of symlinks and their role in the asset management process.
- Introduced a new command `dapi check` to analyze a node's subtree for structural issues, including black frames, never-visible nodes, and source errors.
- Implemented types for check requests and results, detailing the structure of issues found during analysis.
- Added a new `check.ts` file to handle the logic for checking nodes, including coverage calculations and issue reporting.
- Updated the `README.md` and reference documentation to include usage instructions and details about the new command.
- Enhanced the CLI with a new command option for checking node integrity without rendering, providing instant feedback on potential issues in the project.
- Revised the description of the `assets/` directory in `projects.ts` to clarify its role in the library and the handling of media files.
- Expanded the `media.md` documentation to include instructions on adding assets to the library, detailing the process for importing files and managing image sequences.
- Updated the `README.md` to reflect changes in the `media.md` section, ensuring consistency in documentation across the project.
- Removed the `sceneSpan` function from the `useAutoCaptions` hook to simplify caption insertion logic.
- Updated the `insertFresh` function to streamline caption creation by removing unnecessary parameters.
- Introduced new functions in the `timing.ts` file to manage transcript duration and caption source handling, improving accuracy in timing calculations.
- Added caching for transcript lengths in `utils.ts`, allowing for synchronous access to transcript durations after initial reading.
- Enhanced the overall caption handling process to ensure better integration with the timing system and improve performance.
- Updated the `CaptionSettings` component to clarify the relationship between caption presets and authored styles, enhancing user understanding.
- Simplified the `Inspector` component by removing unnecessary checks for caption targets, streamlining the rendering logic.
- Wrapped the "Grow" control in the `TextPanel` with a conditional display to ensure it only appears when text is selected, improving UI responsiveness.
- Introduced new constants for caption preset styles and fills, centralizing style management and ensuring consistency across different caption types.
- Enhanced the `applyStyles` method in various caption decoders to utilize the new preset styles, improving the overall styling process and ensuring authored properties are correctly applied.
- Modified the `sceneSpan` function to calculate frames based on `computed.duration` for improved accuracy.
- Enhanced the `insertFresh` function to include a unique seed for each caption insertion, ensuring fresh transcriptions.
- Refactored the seed management logic to utilize `Date.now()` for generating new seeds, streamlining the re-transcription process.
- Cleaned up the `CaptionSettings` component by removing unused alignment logic and context menu, simplifying the UI and improving maintainability.
- Adjusted the `EditorGenAi` class to ensure proper key management for generated assets, preventing unnecessary re-transcriptions.
- Updated the label assignment logic to use an else-if structure for better clarity and to prevent unnecessary evaluations when checking for text entities.
- Ensured that the label is correctly derived from captions or text entities, improving the overall readability and maintainability of the code.
- Updated the `attachAi` function to accept an optional `dir` parameter, allowing for better project folder management during AI attachment.
- Modified the `EditorGenAi` constructor to incorporate the `dir` parameter, facilitating improved asset transcription handling based on the project's directory.
- Adjusted the `createCapture` function call to utilize the new `dir` property, ensuring accurate source compilation during audio capture processes.
- Updated the `insertGenerated` function to accept an array of asset references, allowing for dynamic naming of generated entities based on their corresponding assets.
- Modified the `useGenerateAudio`, `useGenerateImage`, `useGenerateVideo`, and `useGenerateVoice` hooks to pass asset references during insertion, ensuring generated elements are appropriately named.
- Introduced a new `nameAfterGeneration` function to handle the naming process asynchronously, improving the clarity and organization of the codebase.
- Modified the `useGenerateImage` and `useGenerateVideo` hooks to include the `keepAspectRatio` property in the `Rect` components, ensuring consistent aspect ratio handling for generated assets.
- Updated the `insertAsset` function to apply the `keepAspectRatio` property for both video and image assets, enhancing layout integrity during asset insertion.
- Updated the `LayoutPanel` component to improve aspect ratio management by introducing a `lockedRatio` function, which determines the aspect ratio based on the current dimensions or authored values.
- Simplified the `resize` function to utilize the new `lockedRatio` for enforcing aspect ratios during resizing operations.
- Enhanced the `toggleAspectRatio` function to directly edit the `keepAspectRatio` property, streamlining the locking mechanism.
- Added documentation for the `keepAspectRatio` property in relevant types and reference materials, clarifying its purpose and usage in the editor.
- Introduced `resultExtension` function to determine the appropriate file extension for generated assets based on MIME type and URL, improving file identification accuracy.
- Updated the `store` method in `EditorGenAi` to utilize the new extension logic, ensuring generated files are named correctly based on their content.
- Enhanced `detectMimeType` function to include image type sniffing, allowing for better handling of files without explicit extensions, thus improving overall asset processing reliability.
- Added comprehensive documentation for new functions to clarify their purpose and usage in the asset management workflow.
- Replaced direct queries for `SourceError` and `Generating` with utility functions `getSourceFailure` and `isGenerating` to streamline error handling and improve code readability.
- Updated the `drawHeader`, `renderClip`, and `renderGenerating` functions to utilize the new utility functions, enhancing consistency across the rendering logic.
- Improved the `isGenerating` and `getSourceFailure` functions to check both the entity and its fills for generation status and source failure, ensuring comprehensive error reporting.
- Updated the canvas creation in `createCapture` to ensure it remains within the viewport and utilizes `will-change:opacity` for better performance.
- Modified the `AnimeTimeline` component to use `opacity` for text dimming while clarifying the limitations of using fractional opacity on painted boxes in captures.
- Enhanced documentation in `html.md` to provide clearer guidance on the effects of nested opacity on rendering and captures.
- Added `Source` import to `export.tsx` for better trait handling.
- Updated `settings` computation in `ExportPanel` to ensure it reacts to changes in the source.
- Clarified documentation in `project-config.ts` regarding the export settings retrieval process, improving understanding of reactive behavior.
- Updated the canvas creation in `createCapture` to ensure it remains within the viewport, preventing issues with cached paints and blank captures.
- Enhanced the `AnimeTimeline` component to use alpha colors instead of opacity for better rendering during animations, avoiding subtree blanking.
- Introduced a `WeakSet` in `render.ts` to track failed HTML roots, preventing console flooding by logging errors only once per root.
- Clarified documentation regarding nested opacity effects on captures to improve user understanding of rendering limitations.
- Introduced `getClipFallbackName` function to provide meaningful names for unnamed clips based on their type, improving clarity in the timeline.
- Updated the `NodeLayer` component to utilize the new fallback naming logic, ensuring clips display appropriate names when no explicit name is set.
- Adjusted the `renderClip` function to incorporate fallback names, enhancing user experience by reducing ambiguity in clip identification.
- Updated all example files and relevant documentation to incorporate the `camera` property in the `<stage>` component, ensuring proper framing for various scene dimensions.
- Marked one scene as `active` in each example to prevent projects from opening on an empty timeline, enhancing usability and clarity in project structure.
- Adjusted the `StageProps` and `SceneProps` types to reflect the new requirements for camera and active properties, improving type safety and documentation accuracy.
- Updated the CLI context command description to clarify the information reported, including the application root folder and project details.
- Modified the DAPI context handling to return both the projects root directory and the open project directory, improving the context information available when no project is open.
- Adjusted related documentation to reflect the new structure of the context report, ensuring consistency and clarity for users.
- Added a new script, `stage-docs.mjs`, to stage authoring documentation into the app's resources for packaging.
- Updated `forge.config.ts` to include the new `docs` directory in the `extraResource` configuration.
- Modified `package.json` scripts to incorporate `stage:docs` in the build, package, and publish processes.
- Updated `.gitignore` to exclude the newly created `.diffusion` directory, which contains app-owned documentation.
- Enhanced project documentation to clarify the purpose and structure of the staged docs.
- Updated the `AssetRef` type to only accept paths, simplifying asset reference management.
- Refactored media command descriptions to clarify that local files and URLs can be used without an open project, while library paths require one.
- Enhanced error handling in media commands to specify when paths cannot be resolved, improving user feedback.
- Removed the deprecated `ShellApi` component and integrated its functionality into the new `EditorApi` for better organization and clarity.
- Updated the `handlePlayInteraction` function to utilize the new `togglePlayback` utility for improved media control.
- Introduced `syncStagePlayback` to manage playback state based on entity hierarchy, ensuring proper media playback for nested entities.
- Enhanced the `togglePlayback` function to reset the playhead position for finished scenes, improving playback experience.
- Refactored imports in `interactions.ts` and `playback.ts` for better organization and clarity.
- Updated the focus handling for the rename input to ensure it claims focus correctly after context-menu interactions.
- Replaced the previous focus handler with a new reference function that utilizes `queueMicrotask` for improved focus management.
- Enhanced user experience by ensuring the input is selected upon gaining focus, streamlining the renaming process.
- Updated the canvas interaction logic to include checks for scenes that are covered by the marquee selection, ensuring that only visible and interactive entities are selected.
- Introduced a new utility function, `quadContainsQuad`, to determine if one quad fully contains another, improving selection accuracy.
- Refactored the selection process to filter out entities obscured by covered scenes, enhancing user experience during selection operations.
- Updated the Object Menu to use `isGroupLike` for better selection handling, allowing both groups and sequences to be recognized as containers.
- Enhanced the SourceSettings component to manage color picking states more effectively, allowing for distinct media and solid fill selections.
- Introduced a new `ColorOpacityPicker` for improved color selection, ensuring a more intuitive user experience when editing solid fills.
- Refactored the handling of fill properties to maintain consistent state management during user interactions.
- Updated the CLI command description for `dapi context` to include information about asset generations, improving clarity on the project's state.
- Modified the desktop application documentation to reflect the new context reporting, detailing the status of asset generations (generating, failed, or done) alongside project and playhead information.
- Refactored the context handling in the web application to collect and report generation states, enhancing the overall context management functionality.
- Added new options for grouping and ungrouping selections in the Object Menu, improving user interaction with selected elements.
- Introduced `wrapSelectionInScene` function to allow users to encapsulate selected elements within a scene, maintaining their positions.
- Updated keyboard shortcuts for grouping, ungrouping, and wrapping selections, streamlining workflow efficiency.
- Refactored related functions in the engine to support the new scene wrapping feature, ensuring consistent behavior across the editor.
- Replaced Start and End traits with Delay and Trim to better represent the node's timing on the timeline.
- Updated related functions and components to utilize the new timing structure, ensuring accurate handling of authored time.
- Enhanced the timing logic to reconcile authored time properties into the runtime's vocabulary, improving consistency across the editor and runtime.
- Refactored serialization and deserialization processes to accommodate the new timing traits, ensuring proper data handling during entity state changes.
- Introduced `wrapSelectionInSequence` and `unwrapSequenceSelection` functions to allow users to group selected elements into sequences, maintaining their positions and start times.
- Updated the `ungroupSelection` function to handle both groups and sequences, ensuring consistent behavior when dissolving selections.
- Enhanced keyboard shortcuts to trigger sequence wrapping and unwrapping, improving user interaction and workflow efficiency.
- Introduced a new `LayerContext` to manage drag-and-drop interactions for timeline layers, allowing users to reorder and reparent layers visually.
- Added `DropIndicator` component to provide visual feedback on potential drop targets during dragging.
- Enhanced `NodeLayer` to initiate dragging on pointer down events, integrating drag state management.
- Created utility functions in `drag.ts` for handling drop targets and layer positioning, improving the overall user experience in the timeline.
- Updated the timeline controller to support programmatic scrolling during drag operations, enhancing usability when dragging layers near the viewport edges.
- Introduced `groupSelection` and `ungroupSelection` functions to allow users to group and ungroup selected elements without altering their positions on the canvas.
- Updated keyboard shortcuts to trigger grouping with 'G' and ungrouping with 'G + Shift', enhancing user interaction.
- Refactored the `SceneTemplatePanel` to integrate `SolidPaint` for fill colors, improving rendering consistency.
- Updated the DrawOverlay and createScene functions to replace direct fill color attributes with SolidPaint components, enhancing rendering flexibility.
- Improved the structure of Scene and Rect elements to support the new SolidPaint integration, ensuring consistent fill handling across components.
- Integrated `getEditHistory` into the `EditMenu` component, enabling undo and redo actions based on edit history state.
- Updated the `Engine` class to improve modifier key handling, ensuring accurate key state management during input events.
- Refactored the `DocumentEditor` to support capturing previous values during edits, enhancing the undo/redo capabilities.
- Added new methods for undo and redo actions in the shortcuts system, streamlining keyboard shortcut functionality.
- Improved documentation and type definitions related to edit history and input handling for better clarity and maintainability.
- Updated `useGenerateImage` and `useGenerateVideo` to replace direct `<Image>` and `<Video>` elements with `<ImagePaint>` and `<VideoPaint>` wrapped in `<Rect>`, enhancing the rendering process.
- Modified `insertAsset` function to accommodate the new structure for inserting images and videos, ensuring consistency across asset types.
- Improved error handling in the timeline rendering by refining how generating and error states are determined, leading to better visual feedback during asset generation.