- Added `horizontalConstraintName` and `verticalConstraintName` functions to map constraint types to their respective names.
- Updated `ConstraintsRow` component to utilize these functions for setting `constrainX` and `constrainY` properties.
- Introduced `HORIZONTAL_CONSTRAINTS` and `VERTICAL_CONSTRAINTS` constants in the runtime to define available constraints.
- Enhanced documentation to clarify the behavior of `constrainX` and `constrainY` properties in the JSX elements reference.
- Updated `11-redraw.tsx` to incorporate `useResolution`, ensuring sharp rendering at any export size by adapting the bitmap to the display's pixel ratio.
- Modified the `draw` function to accept a resolution parameter, allowing dynamic adjustments during rendering.
- Enhanced documentation in `README.md` to reflect the new resolution handling feature in the Redraw example.
- Introduced a new example file `10-typegpu.tsx` demonstrating an underwater caustics shader using TypeGPU and Solid.js.
- Implemented shader functionality with adjustable parameters for tile density, speed, fog color, and ambient light.
- Updated `README.md` to include the new example and installation instructions for required packages.
- Enhanced `module.md` with details on using TypeGPU's compile-time plugins in the project's Babel configuration.
- Updated the `EXCLUDED_PROPS` in `history.ts` to include 'timeline', ensuring proper state handling.
- Introduced `reportView` function in `controller.ts` to track timeline view changes, integrating it into the timeline update process.
- Modified `timeline.ts` to call `updateTimelineTransform` every draw pass, improving responsiveness to view changes.
- Added `timeline` property to `SceneProps` in `types.ts` to store the scene's timeline viewport state.
- Updated documentation to reflect the new `timeline` property and its implications for scene state management.
- Revised the `KeyframeProps` type definition to specify that `time` is source-local, meaning it refers to the source's first frame rather than the clip's start.
- Enhanced the `keyframes.md` documentation to reflect this change, providing clearer guidance on how keyframes relate to trimmed clips and playback rates.
- Added an example to illustrate the impact of `sourceIn` on keyframe timing, improving understanding for developers.
- 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.
- 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.
- Replaced references to GSAP with anime.js in the JSX documentation, ensuring consistency with the current animation framework.
- Updated code examples to reflect the new anime.js syntax and functionality, enhancing clarity for users transitioning from GSAP.
- Improved explanations regarding timeline creation and usage, emphasizing the benefits of using anime.js for frame-accurate animations.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Introduced the `hold` method in the `useTicker` hook to manage async operations, ensuring frames wait for necessary resources before sampling.
- Updated example files to utilize the `hold` method for loading models and setting up WebGPU devices, improving frame accuracy during exports and captures.
- Added documentation for the `hold` method, detailing its purpose and usage in managing async work within the rendering pipeline.
- Implemented a timeout mechanism for held promises to prevent indefinite waits during rendering.
- Added support for the `syncTo` trait, allowing elements to align their playback based on the timing of another element's recording.
- Introduced `PendingSync` to manage in-progress sync requests and ensure proper correlation between audio and video sources.
- Enhanced the asset system to handle sync requests, including error handling for cycles and missing sources.
- Updated documentation to reflect the new `syncTo` functionality and its implications for element placement and playback management.
- Updated all example files to replace <rect> with <stage> and <scene> for improved structure and consistency.
- Enhanced the README.md to reflect the new project entry format for examples.
- Added a new dependency on "koota" in package.json for better integration.
- Improved documentation and comments throughout the examples for clarity.
- Revised the documentation in `projects.ts` to clarify that npm packages are treated as standard packages, allowing for direct installation and bundling from `node_modules`.
- Updated `module.md` to reflect changes in userland package resolution, emphasizing the need for browser compatibility and the removal of CDN fallback.
- Enhanced clarity on local imports and the handling of type declarations for userland packages, ensuring accurate guidance for developers.
- Introduced `useMediaSelection` to streamline the management of selected image and video nodes.
- Updated `ActionBar` to utilize the new media selection logic, simplifying the determination of media types.
- Refactored `PromptInputActions` to leverage `useMediaSelection`, enhancing clarity and reducing complexity in handling selected nodes.
- Removed obsolete functions related to media type determination, improving code maintainability.
- Added new constants for voice model and aspect ratio dimensions in `config.ts`, enhancing configurability for media generation.
- Introduced `<adjustmentLayer>` element to the JSX framework, allowing for transformations on the clip below it without drawing its own content.
- Updated type definitions to include `AdjustmentLayerProps` for better type safety and documentation.
- Enhanced the reconciler to handle the new adjustment layer entity, ensuring proper integration within the document structure.
- Added comprehensive documentation for the adjustment layer, detailing its functionality and usage examples.
- Improved overall code organization and readability across affected components, setting the stage for future enhancements.
- Refactored `AppearanceSettings` to utilize new hooks from `@diffusionstudio/koota-solid`, improving state management for opacity, blend modes, visibility, and corner radii.
- Enhanced keyframe handling by integrating `syncKeyframe` and `removeKeyframeTrack` functions, ensuring smoother animations and property edits.
- Updated the `Keyframe` component to support new properties and improve interaction with the editor, enhancing user experience.
- Replaced `Keyframe` imports across various components to use the new `keyframe-bitecs` module, ensuring consistency in keyframe management.
- Documented changes in migration notes to reflect updates in appearance settings and keyframe functionality.
- Added support for asset manifests with read and write capabilities, allowing for better organization of project assets.
- Introduced new project channels for manifest reading and writing, enhancing communication between main and renderer processes.
- Improved file system interactions with new methods for listing, statting, and removing project files, streamlining asset management.
- Updated package dependencies to include `yaml` for manifest handling and linked `@diffusionstudio/assets` for asset management.
- Refactored existing code to integrate new asset handling features and improve overall project structure.
- Introduced `TextCase` type for controlling glyph casing during rendering, with options for original, upper, and lower case.
- Added `TextRange` as a sub-entity for `<text>`, allowing style overrides for specific runs of glyphs by character index.
- Updated `TextProps` to include new properties such as `letterSpacing`, `leading`, and `textCase`, enhancing text styling capabilities.
- Enhanced rendering logic to support the new `TextRange` functionality, ensuring proper application of styles and colors.
- Updated migration documentation to reflect the addition of text handling features, detailing their usage and integration within existing structures.
- Removed `PATCH_PROP_KEYS` and `PatchProps`, streamlining property management as the document structure no longer requires patching by prop name.
- Updated type definitions to introduce new internal prop groups (`IdentityProps`, `PositionProps`, `OffsetProps`, `SizeProps`, `TransformProps`, `TimingProps`, `SequenceItemProps`), enhancing clarity and organization of properties.
- Refactored animation and keyframe structures to utilize `<animation>` and `<keyframeTrack>` elements, ensuring consistent handling of animatable properties.
- Updated migration documentation to reflect the removal of obsolete structures and the introduction of new prop groups, detailing their usage in the context of animations and keyframes.
- Replaced references to `DocumentRoot` with `Stage` across the codebase, aligning with the new stage model.
- Updated entity management and hierarchy functions to reflect the transition from document-based to stage-based parenting.
- Adjusted comments and documentation to clarify the role of the stage in the entity structure.
- Enhanced queries and actions to utilize the new stage terminology, ensuring consistency throughout the runtime environment.
Eliminated the `compile-project.ts` and `open-folder.ts` files from the CLI, streamlining the codebase. Updated the README to reflect changes in CLI commands, including the removal of outdated examples. Adjusted the API to enhance clarity and maintainability by consolidating asset handling functions and removing unused types. This refactor improves the overall architecture and reduces complexity in the CLI interactions.
- Added detailed explanations for common issues related to blank or partial `<html>` content in captures, including stateful animations, scaling, and opacity handling.
- Updated example code to recommend using GSAP for timeline animations instead of anime.js, ensuring frame accuracy and proper timeline management.
- Clarified best practices for using CSS properties like `scale()` and `opacity` in JSX to prevent rendering issues.
Deleted the `09-html-scene.tsx` example file, which demonstrated an HTML scene as a mount root. Updated the README and related documentation to remove references to this example and clarified that only `<rect>` can be promoted to a scene. Adjusted descriptions in the JSX documentation to reflect this change.
Updated the `whenReady` method in the HtmlHost class to streamline the resolution of asynchronously loaded HTML resources. Replaced the previous image decoding handling with a more efficient promise management approach, ensuring that all images and fonts are ready before rendering updates. Adjusted related documentation to clarify the changes in resource readiness handling.
Implemented a new `whenReady` method in the HtmlHost class to ensure all images in its subtree are decoded before rendering updates. Updated the playback system to utilize this method for improved rendering reliability. Enhanced the WorldDocument class to manage image sources more effectively, including support for various input types and object URL management. Updated documentation to reflect changes in image handling and source resolution.
Revised the README to better describe Diffusion Studio's functionality, emphasizing the role of the `dapi` CLI and providing detailed prompt examples for video understanding, motion graphics, video editing, and clipping. Additionally, clarified the caching behavior of transcripts in the captions documentation by removing the optional seed parameter reference, ensuring accurate information for users.
Updated the audio generation functionality to include an optional `duration` parameter in the `GenerateAudioOptions` type. This change allows users to specify the duration for audio prompts, improving flexibility in audio generation. Additionally, validation was added to ensure the duration is a positive number. Updated related documentation to reflect this new option.
Updated the `sceneAudioFingerprint` and `transcribeScene` functions to accept an optional `seed` parameter, allowing for more flexible transcript caching. Adjusted related logic in the `WorldDocument` class to utilize the seed for generating unique transcription keys. Additionally, updated documentation to reflect the new `seed` prop in the captions API, clarifying its role in bypassing cached transcripts.
Updated the documentation for the `<html>` element by removing obsolete examples related to scene identity and layout practices. This change streamlines the content, focusing on the current best practices for using `<html>` in JSX, while ensuring clarity and relevance for users.
Revised multiple files to update references from `<html-paint.md>` to `<html.md>` for consistency. Added a new file for the `<html>` element, detailing its usage, properties, and best practices for incorporating real HTML into JSX layouts. This update enhances the documentation's accuracy and provides clearer guidance for users on utilizing the `<html>` element effectively.
Expanded the documentation for the `<html>` element to include best practices for minimizing the number of `<html>` hosts. Added examples illustrating the preferred approach of using a single host with internal layout versus multiple hosts for content that appears simultaneously. This update aims to enhance performance and clarity for users when structuring their JSX layouts.
Revised the descriptions of the `<group>` and `<html>` elements in the JSX documentation to improve clarity. The `<group>` element's internal node description was updated for better understanding, while the `<html>` element's usage examples were modified to reflect the correct structure when used as a scene. Additionally, clarified the constraints related to scene roots in the documentation, ensuring users have accurate information on the properties and behaviors of these elements.
Updated multiple files to transition from using `<scene>` elements to `<rect>` elements with the `scene` property, promoting rectangle geometries to mount roots. This change enhances the JSX API by clarifying the role of scenes and ensuring consistency across examples and documentation. Additionally, modified related documentation to reflect the new usage and constraints of the `scene` property.
Updated the image encoder to track entities with timeline clocks, ensuring that local time is consistently updated for both the main stage and clock entities. This change improves synchronization during playback and enhances the overall functionality of the image encoding process.
Modified the captions documentation to clarify the default styles and color slots for various presets. The changes include a simplification of the descriptions for the "classic" and "whisper" presets, enhancing user understanding of their intended use cases. This update ensures that the documentation accurately represents the current functionality of the `<captions />` component.
Updated the HtmlHost class to expose the setSize method publicly, allowing external components to adjust size directly. Introduced a new PendingHtmlHost type to manage HTML hosts awaiting size initialization. Refactored the registerHtmlHost method to include a paint parameter, improving the handling of HTML hosts during rendering. Added a flushConnectedHtmlHosts method to process pending hosts efficiently, ensuring accurate size updates when connected. Updated documentation to reflect these changes.
Refactored the downsampleAudio function to improve peak calculation efficiency and accuracy. Updated the logic to handle peak accumulation more effectively, ensuring better audio quality in downsampled outputs. Additionally, expanded the captions documentation to clarify the relationship between timing properties and transcript trimming, enhancing user understanding of captioning mechanics.
Updated the captions documentation to include new properties: `start`, `end`, `sourceIn`, and `sourceOut`. These properties allow for trimming specific sections of the transcript, enhancing the functionality and clarity of captioning in relation to media timing.
Introduced a new `<shaderPaint>` element that applies a WGSL fragment shader to the media paint directly below it in the paint stack. Implemented support for shader uniforms and updated the rendering logic to handle shader paints in the engine. Enhanced the API to include shader-related methods and types, ensuring seamless integration with existing media elements. Updated documentation and examples to demonstrate the new shader capabilities, improving user guidance and showcasing practical implementations.
Added width and height properties to various video and text elements across examples and documentation files to ensure consistent sizing. This change enhances the clarity of the examples and improves the user experience by providing explicit dimensions for media elements.
Modified the "check" script in package.json to reference the correct "examples" directory. Updated the README to replace "video editor" with "media compositor" for improved accuracy and restructured some sentences for better readability. Removed outdated documentation files related to assets, CLI, composition, distribution, and getting started, streamlining the documentation for a more focused user experience.